Skip to content

Built-in tools ​

Mogick assembles the available toolset based on the execution mode. Plan mode supports exploration, user questions, and plan creation. Agent mode adds file changes, command execution, MCP, and change tracking. Experimental features and build options may further adjust tool availability.

ToolActionPlanAgent
file.readRead file✓✓
file.list_dirList directory✓✓
file.globMatch files by glob✓✓
file.grepSearch file contents✓✓
code.searchUse mwcs for semantic code search; depends on whether the build includes mwcs✓✓
file.tree_findLocate by file tree using mwcs; depends on whether the build includes mwcs✓✓
file.writeCreate or overwrite a file—✓
file.editEdit files precisely—✓
file.apply_patchApply multi-file patches; may partially succeed, not transactional—✓
file.deleteDelete a file—✓

File writes, edits, and deletions are subject to the active permission policy. Long tool results may be truncated in the model context, while the complete results remain in the session record.

Shell and Git ​

ToolActionPlanAgent
shell.execRun a shell command and return its output—✓
git.statusView workspace status✓✓
git.diffView differences✓✓
git.logView commit history✓✓
git.showView commit content✓✓

The built-in Git tools are read-only evidence tools. For a Git command with write effects, the agent uses shell.exec, subject to the corresponding approval.

bash
mogick run "Run go test ./... and summarize the failures"

Planning, tasks and collaboration ​

ToolActionPlanAgent
plan.readRead the current plan✓✓
plan.writeSave or incrementally update a plan✓—
todo.writeWrite task list✓✓
todo.updateUpdate task status—✓
user.questionPost a structured single-choice or multiple-choice question to the user✓✓
tool.usageQuery tool usage✓✓
agent.taskDelegate a task to a subagent; controlled by the experimental feature setting✓✓

After plan.write completes, the model ends the turn. The TUI or ACP host presents the plan for approval and handles the mode switch. Plan mode does not use plan.exit.

Skills ​

ToolActionPlanAgent
skill.findFind Skills✓✓
skill.loadLoad a Skill's instructions✓✓
skill.createCreate Skill—✓

Finding and loading Skills are read-only operations. Creating a Skill writes files and requires Agent mode.

MCP meta-tools ​

MCP meta-tools are only available in Agent mode.

ToolAction
mcp.listList servers
mcp.statusView server status
mcp.searchSearch for tools across servers
mcp.helpGet tool help
mcp.readRead server resources
mcp.wait_readyWait for the server to be ready
mcp.connectConnect to server
mcp.disconnectDisconnect the server
mcp.reconnectReconnect to the server
mcp.callInvoke the specified MCP tool

mcp.call can wrap remote tools with side effects, so it requires approval by default. If the target tool declares readOnlyHint, the permission policy may treat the call as read-only.

Change tracking and execution summaries ​

Agent mode also provides tools for the Changes panel, /review, and execution summaries:

ToolActionPlanAgent
changeset.list_groupsList Changeset groups—✓
changeset.read_group_patchsetRead the patch details of the group—✓
changeset.commit_contextGenerate commit context—✓
execution.summarySummarize execution results—✓
tracing.groupTracing group information—✓
julia.interpreterJulia code interpretation and execution; depends on the build configuration—✓

Read-only tools can run in parallel. Tools with side effects are ordered and approved according to the runtime policy. See Tool approvals and permission policies.

Images ​

image.understand and image.ocr can be available in Plan and Agent modes when the session has the required official service and scene model. They are not enabled by logging in alone for an arbitrary custom provider. See Files and images.