Skip to content

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).

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)