Usage on Gokin

Tools

Mon, 01 Jan 0001 00:00:00 +0000

Gokin includes 54 tools organized into 10 tool sets with 3 safety levels.

Safety Levels#

Level	Behavior	Examples
Safe	Auto-approved	read, glob, grep, git_status
Caution	Ask once, then auto-approve	write, edit, git_add
Dangerous	Ask every time	bash, delete, git_commit, ssh

File Operations (9)#

Tool	Level	Description
read	Safe	Read file with line numbers. Supports offset/limit for large files
write	Caution	Create/overwrite files
edit	Caution	Replace lines in files. Supports regex and multi-edit
delete	Dangerous	Delete files/directories. Irreversible
copy	Caution	Copy files/directories
move	Caution	Move/rename files
mkdir	Caution	Create directories (parents=true for recursive)
list_dir	Safe	Directory contents with sizes and types
tree	Safe	ASCII tree of directory structure (default depth: 3)

Search (2)#

Tool	Level	Description
glob	Safe	Find files by pattern (`*/.go`). Sorted by modification date
grep	Safe	Search by content (regex, context, case sensitivity)

Execution (4)#

Tool	Level	Description
bash	Dangerous	Execute shell commands. Timeout: 30s
task	Safe	Launch sub-agents (explore, bash, general, plan, guide)
task_output	Safe	Get background task results
task_stop	Safe	Stop background tasks by ID

Git (8)#

Tool	Level	Description
git_status	Safe	Working tree status (staged, unstaged, untracked)
git_diff	Safe	Diff between revisions/working tree
git_log	Safe	Commit history (default: 10)
git_blame	Safe	Line-by-line authorship
git_add	Caution	Stage files
git_branch	Caution	Branch management: list, create, delete, switch, merge
git_pr	Caution	Create/manage GitHub PRs via gh CLI
git_commit	Dangerous	Create commit

Planning (6)#

Tool	Level	Description
enter_plan_mode	Safe	Enter planning mode
update_plan_progress	Safe	Update step status
get_plan_status	Safe	Current plan status
exit_plan_mode	Safe	Exit planning (approve=true to execute)
undo_plan	Safe	Undo last step
redo_plan	Safe	Redo undone step

Code Analysis (5)#

Tool	Level	Description
refactor	Caution	Refactoring: rename, extract, inline. Scope: file/package/project
run_tests	Caution	Run tests (Go/Python/Node/Rust). Coverage
batch	Dangerous	Bulk edits: atomic bulk operations. Supports dry_run
check_impact	Safe	Blast radius — all dependencies and impact of a symbol change
verify_code	Safe	Auto-check: detect project type and run checks

Web (2)#

Tool	Level	Description
web_fetch	Caution	Fetch URL, convert HTML → Markdown
web_search	Safe	Web search, ranked results

Agents & Coordination (4)#

Tool	Level	Description
ask_agent	Safe	Query another agent type
coordinate	Safe	Coordinate multiple agents on a task
shared_memory	Safe	Inter-agent shared memory (read/write/delete/list)
update_scratchpad	Safe	Agent scratchpad (append/overwrite)

Memory (4)#

Tool	Level	Description
memory	Safe	Persistent memory: add, get, search, list, remove
memorize	Safe	Typed storage: fact, preference, convention, pattern
pin_context	Safe	Pin text to system prompt for the session
history_search	Safe	Search session history (regex)

Semantic (2)#

Tool	Level	Description
semantic_search	Safe	Semantic similarity search (embeddings)
code_graph	Safe	Dependency analysis, references, callers/callees

System & Utilities (7)#

Tool	Level	Description
diff	Safe	Difference between two texts/files (unified diff)
env	Safe	Environment info: working dir, OS, env vars
todo	Safe	Session task management: add, remove, complete, list
tools_list	Safe	List all available tools
request_tool	Safe	Request a tool not in the current set
ssh	Dangerous	Execute command on a remote server
kill_shell	Dangerous	Stop a background task

User Interface (1)#

Tool	Level	Description
ask_user	Safe	Ask user a question, wait for response

Tool Sets#

Gokin dynamically selects a tool set based on model, provider, and agent type.

Commands

Mon, 01 Jan 0001 00:00:00 +0000

Slash Commands#

All commands start with /. Typing / in the input field shows autocomplete.

Getting Started (2)#

Command	Description
`/help [command]`	Help for a command or general help
`/quickstart`	Quick start with examples

Sessions (8)#

Command	Description
`/model [name]`	Switch model (flash, pro, sonnet, opus, haiku)
`/clear`	Clear conversation history
`/compact`	Force context compaction
`/save [name]`	Save current session
`/resume <id> [--force]`	Restore a saved session
`/sessions [--all]`	List saved sessions
`/stats`	Session statistics (tokens, cost, context)
`/instructions [--source]`	Show loaded project instructions

Auth & Settings (9)#

Command	Description
`/login [provider] [key]`	Set provider API key
`/logout [provider\|all]`	Remove API key(s)
`/oauth-login`	Login to Gemini via Google account (OAuth)
`/oauth-logout`	Remove OAuth credentials
`/provider [name]`	Switch AI provider
`/status`	Current configuration status
`/doctor`	Environment and configuration diagnostics
`/config`	Show current settings
`/update [install\|backups\|rollback]`	Check and install updates

Git (3)#

Command	Description
`/init`	Initialize GOKIN.md for the project
`/commit [-m message]`	Create a git commit
`/pr [--title title] [--draft] [--base branch]`	Create a pull request

Planning & Observability (10)#

Command	Description
`/plan`	Toggle planning mode
`/resume-plan [list\|<plan_id>]`	Resume a paused plan
`/tree-stats`	Tree planner statistics
`/health`	Runtime health and provider reliability
`/policy`	Policy engine and circuit breaker state
`/ledger`	Current plan run ledger
`/journal`	Recent execution journal events
`/recovery`	Latest recovery snapshot
`/observability`	Combined observability dashboard
`/memory-governance`	Memory and session governance state

Tools & Utilities (16)#

Command	Description
`/browse [path]`	Interactive file browser
`/open <file>`	Open file in editor
`/copy [--last\|--all\|--ascii] [text]`	Copy to clipboard
`/paste`	Get text from clipboard
`/ql <file>`	Quick Look (macOS only)
`/clear-todos`	Clear all todo tasks
`/permissions [on\|off]`	Enable/disable permission prompts
`/sandbox [on\|off]`	Enable/disable bash sandbox
`/theme [name]`	Switch UI theme
`/semantic-stats`	Semantic index statistics
`/semantic-reindex`	Rebuild semantic index
`/register-agent-type <name> "<desc>"`	Register a custom agent type
`/list-agent-types`	List all agent types
`/unregister-agent-type <name>`	Remove a custom agent type

Options for /register-agent-type:

Planning

Mon, 01 Jan 0001 00:00:00 +0000

Gokin includes a full-featured planning system for complex multi-step tasks with support for parallel steps, conditions, dependencies, and adaptive replanning.

Plan Lifecycle#

Draft → AwaitingApproval → Approved → Executing → Completed
 ↘ Cancelled ↙ ↓
 Failed

Executing ⟷ Paused (pause / resume)
Failed → Approved (after replan)

State	Description
Draft	Initial state, steps being designed
AwaitingApproval	Ready for user review
Approved	User accepted, execution not started
Executing	Steps are running
Paused	Temporarily stopped, can be resumed
Completed	All steps finished successfully
Failed	A step encountered a fatal error
Cancelled	User cancelled

Step Statuses#

Status	Icon	Description
Pending	○	Awaiting execution
InProgress	◐	Running
Completed	●	Finished successfully
Failed	✗	Execution error
Skipped	⊘	Condition not met or dependency failed
Paused	⏸	Temporarily stopped

Step Structure#

Step {
 ID int // 1-indexed
 Title string // What to do
 Description string // Detailed description
 Status Status // Current state

 // Execution control
 Parallel bool // Can run in parallel
 DependsOn []int // Step IDs to wait for
 MaxRetries int // Retry attempts (0 = no retries)
 Timeout time.Duration // Step timeout
 Condition string // "step_N_failed" or "step_N_succeeded"

 // Results
 Output string
 Error string
 TokensUsed int
 StartTime time.Time
 EndTime time.Time
}

Parallel Steps#

Steps with Parallel: true run concurrently via sync.WaitGroup: