Skip to main content
Guides

Tools

Qoder CN provides built-in tools across five categories: search, file editing, command execution, problem retrieval, and memory management. In Agent mode, Qoder CN autonomously selects and invokes these tools. MCP server integration lets you extend capabilities with additional tools. This article introduces the tool capabilities provided by Qoder CN CLI, including search and exploration, reading project context, editing files, running commands, managing context, dispatch and automation, MCP tools, and how tool usage is controlled.
Qoder CN CLI works with the local workspace and external information sources through tools. Tools can search and read project content, modify files, run commands, fetch web content, maintain context, and connect to external services via MCP.
Tools can be used in interactive TUI sessions and in non-interactive Print mode. The actual set of available tools depends on the current session, enabled features, MCP configuration, and permission settings. In the TUI, use /tools to see the tools available in the current session.

Search and Exploration

Qoder CN CLI uses search and exploration tools to first understand the current task before deciding what to do next.
ScopeDescription
FilesFind files in the current workspace.
CodeSearch code, text, and configuration files.
DirectoriesBrowse the project structure and locate relevant paths.
WebSearch the web when the task requires current information or public materials.
Web contentFetch the content of a specified web page.

Reading Project Context

Qoder CN CLI can read files and other project assets to gather context for the current request.
CapabilityDescription
View filesRead source code, documentation, configuration, and other text assets.
Read large filesWhen a file is too large, read only the relevant portions.
Read document assetsRead document formats such as PDF when supported.

Editing Files

When a task requires changes, Qoder CN CLI can create or modify files in the workspace.
CapabilityDescription
Modify filesMake targeted modifications to existing files.
Create filesAdd files such as source code, tests, documentation, or configuration.
Edit NotebooksModify Notebook content in Notebook-supported scenarios.
File edits go through the permission system. Depending on the permission mode and rules, Qoder CN CLI may apply changes directly, request confirmation, or block the operation.

Running Commands

When a task requires local execution, Qoder CN CLI can run shell commands.
CapabilityDescription
Run commandsRun builds, tests, packaging, Git checks, project troubleshooting, or custom shell commands.
Run long-running tasksTrack time-consuming commands, such as test suites or development scripts.
Shell commands are generally riskier than read-only operations. We recommend using permission rules to allow routine commands and setting ask or deny for sensitive commands.

Managing Context

Some tools help Qoder CN CLI maintain the state of the current task and session.
CapabilityDescription
Track tasksMaintain a lightweight plan or task list during work.
Clarify questionsAsk the user when a decision or key information is missing.
Manage memorySave long-term information when the memory capability is available.
Use SkillsLoad domain-specific instructions or workflows once configured.
Plan workEnter or exit Plan mode when a task requires analysis before execution.
Memory and Skills provide context to the model, but they are not security boundaries. When you need to enforce policy, use permission rules and Hooks.

Dispatch and Automation

When the relevant capabilities are enabled in the current environment, Qoder CN CLI can use dispatch and automation capabilities.
CapabilityDescription
SubagentsDispatch specific work to specialized Agents.
WorkflowsRun configured, repeatable workflows.
GoalsTrack and pursue longer-running goals.
WorktreesWork in a separate Git worktree when parallel sessions are needed.
Scheduled tasksCreate or manage scheduled tasks when the scheduling capability is enabled.
What is actually available depends on the product configuration, feature flags, and the current session.

MCP Tools

Qoder CN CLI can connect to Model Context Protocol (MCP) services to use external tools and data sources. Once MCP services are configured, their tools appear in the same /tools view and go through the same permission system. MCP tools are well suited for connecting to issue systems, code hosting platforms, databases, browser automation, internal platforms, or enterprise-custom services. For MCP configuration, see MCP services.

Controlling Tool Usage

Whether a tool is visible and whether a tool is allowed to run are two separate things.
ControlDescription
--toolsRestrict the tools visible in the current session.
--allowed-toolsPre-allow specified tools or tool patterns.
--disallowed-toolsBlock specified tools or tool patterns.
permissions.allow / permissions.ask / permissions.denyPersistent permission rules written in the settings file.
tools.excludeRemove tools from discovery results at startup.
Examples:
# Read-only exploration
qoderclicn --tools Read Grep Glob --allowed-tools 'Read,Grep,Glob'

# Allow common status-check commands
qoderclicn --allowed-tools 'Read,Grep,Bash(git status)'

# Disallow file edits in a non-interactive review
qoderclicn -p "review this repository" --disallowed-tools 'Write,Edit'
For permission modes, rule syntax, and evaluation order, see Permissions. For using Hooks to intercept tool calls, see Hooks.