Custom agents
Every agent is an [agents.<name>] table. The built-in ones (claude, codex, cursor, pi, opencode, gemini) can be
changed field by field; any other name adds an agent.
[agents.claude]
command = "claude"
plan = "--permission-mode plan"
resume = "--resume {id}"
[agents.mytool]
command = "mytool --model fast"
prompt = "argument"
| Field | |
|---|---|
command |
The command line that starts the agent. |
prompt |
How the prompt reaches it: argument (appended), stdin (piped in), paste or file. |
plan |
Arguments for Plan first in Start work. |
resume |
Arguments that resume a session; {id} is the agent's session id. Without it, a resumed session starts fresh. |
[agents.<name>.profiles] |
Named command lines, name = "command". |
[agents.<name>.patterns] |
Screen patterns per state; see Reading the screen. |
default_agent under [sessions] picks the agent Start work selects first. Settings (⌘,) edits the same fields.