Commands
A line that starts with / is a command. Anything else is sent to the
assistant.
| Command | Action |
|---|---|
/help |
show the command list |
/init |
analyse the project and write CC.md |
/model [name] |
show the current model, or switch to <name> |
/clear |
reset the conversation |
/exit |
quit (alias /quit) |
Input box
The input box is visible at all times, including while the agent is working.
| Key / input | Action |
|---|---|
| ← / → | move cursor left / right |
| ↑ / ↓ | navigate input history |
| Home / End | jump to start / end of line |
| Delete | delete character at cursor |
| Backspace | delete character before cursor |
| Ctrl+C | cancel a running stream |
| Shift+Enter | insert a newline (multi-line input) |
| Enter | submit the line (queued if the agent is busy) |
| Esc | interrupt the running turn (no new message) |
/btw <text> |
interrupt the running turn; answer <text> next |
Mid-turn input. A message submitted with Enter while the agent is working is
queued and answered after the current turn finishes. Multiple messages queue in
order. A line beginning with /btw <text> interrupts immediately and is answered
next. Pressing Esc interrupts the current turn with no new message. In both
interrupt cases, any partial work and tool results already produced are kept in
the conversation history.
/init
/init asks the agent to inspect the repository — its layout, build process
and conventions — and write a CC.md file. That file is then loaded as
project context on every later run.
/model
/model with no argument prints the active model. /model <name> switches it;
the new model takes effect on the next message.
Tools
The agent uses these tools when it decides a tool call will help answer your request. Each tool is subject to the permission gate.
read
Read a file from disk and return its contents.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | yes | path to the file |
offset |
integer | no | line to start from |
limit |
integer | no | maximum lines to return |
write
Create or overwrite a file with new content.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | yes | destination path |
content |
string | yes | file content |
edit
Replace an exact substring inside a file without rewriting the whole file.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | yes | target file |
old_string |
string | yes | text to find |
new_string |
string | yes | replacement text |
glob
List files whose paths match a glob pattern.
| Parameter | Type | Required | Description |
|---|---|---|---|
pattern |
string | yes | glob pattern (e.g. **/*.prg) |
path |
string | no | directory to search (default: cwd) |
grep
Search file contents for a regular-expression pattern.
| Parameter | Type | Required | Description |
|---|---|---|---|
pattern |
string | yes | regular expression |
path |
string | no | directory or file to search |
glob |
string | no | filter files by glob pattern |
shell
Run a shell command via cmd.exe and return its combined output and exit code.
| Parameter | Type | Required | Description |
|---|---|---|---|
command |
string | yes | command to execute |
timeout |
number | no | max seconds to run (0 = no limit) |
When timeout is omitted, the shell_timeout setting — or an automatic
per-command estimate — applies (see configuration).
web_search
Search the web via the DuckDuckGo Instant Answer API and return a list of results. No API key required.
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | yes | search query |
max_results |
integer | no | maximum results to return (default 5) |
web_fetch
Fetch the raw content of a URL and return it as text.
| Parameter | Type | Required | Description |
|---|---|---|---|
url |
string | yes | URL to fetch |
github_read
Read-only queries against the GitHub API. Works without a token, but is rate-limited to 60 requests/hour unauthenticated (see configuration).
| Parameter | Type | Required | Description |
|---|---|---|---|
operation |
string | yes | one of: repo, file, list, issues, issue, prs, pr, search |
repo |
string | yes (except search) |
repository in owner/name form |
path |
string | no | file or directory path (for file and list) |
number |
integer | no | issue or PR number (for issue and pr) |
query |
string | no | search query (for search) |
github_write
GitHub mutations: create issues, add comments, open pull requests. Requires a GitHub token (see configuration).
| Parameter | Type | Required | Description |
|---|---|---|---|
operation |
string | yes | one of: create_issue, comment, create_pr |
repo |
string | yes | repository in owner/name form |
number |
integer | no | issue or PR number (for comment) |
title |
string | no | title (for create_issue and create_pr) |
body |
string | no | body text |
head |
string | no | source branch (for create_pr) |
base |
string | no | target branch (for create_pr) |
memory
Read, append to, or clear the agent's persistent per-project memory file
(memory.md in the working directory). The agent uses this to remember
decisions and context across sessions. Defaults to allow.
| Parameter | Type | Required | Description |
|---|---|---|---|
operation |
string | yes | one of: append, read, clear |
text |
string | no | text to append (required for append) |