ncode CLI Using ncode
Slash commands
Type / in the composer to list every command; the list narrows as you type, and Tab or Enter takes the highlighted one. A command that needs no argument runs at once. Commands work while other runs are working.
Conversation#
| Command | What it does |
|---|---|
/new (also /clear) | start a new conversation; this one stays saved |
/resume | pick a saved conversation; each row shows its age and last prompt |
/resume <id or title> | open that conversation |
/resume-run | resume the last stopped run of this conversation |
/stop | stop everything running in this conversation |
/queue <text> | queue a message behind the running turn |
/queue | list the queued messages, numbered |
/queue drop <n> | remove queued message n |
/queue clear | remove every queued message |
/rename <title> | rename this conversation |
/fork | copy this conversation into a new one and open it |
/delete | delete this conversation and its runs (asks first; files are not touched) |
!<command> | not a slash command: run a shell command and add its output to the conversation (see Composer) |
/compact [focus] | summarise the conversation so far and continue from the summary |
/goal <text> | set the conversation goal every agent keeps in mind; alone, show it |
/search <words> | search the messages of this project's conversations; the matches are a picker, and Enter opens the conversation |
/export [file] | write this conversation as Markdown |
/cost | tokens and cost of this conversation, by model |
/attach <image-path> | stage an image file from the project for the next message |
/deep_research [id] | attach a finished deep research to the next message |
Runs and modes#
| Command | What it does |
|---|---|
/swarm <task> | start a swarm of agents on a task |
/plan [task] | turn plan mode on or off; with a task, plan it now as a read-only run |
/consensus [task] | switch to Consensus mode; with a task, judge this one turn only and leave the mode as it is |
/review | review the uncommitted changes and report problems |
/ultra | turn Ultra on or off: big tasks run as workflows here (missions are in the ncode app for now) |
/workflow <name> [key=value…] | launch a workflow |
/workflow pause|resume|stop|save <run> | control a workflow run |
/workflows | open the workflow library and runs |
/create-workflow [what it should do] | write a new workflow with the assistant |
/rewind | go back to before an earlier turn: the conversation, the files, or both (see Rewind) |
/undo | rewind the last turn: its messages and its files (asks first) |
/agents | the agent definitions a swarm can use, with their source, model and description |
See Modes and run types and Workflows.
Model and effort#
| Command | What it does |
|---|---|
/model [model] | switch this conversation's chat model; alone, a picker |
/worker_model [model] | switch the model the workers use (Worker model); alone, a picker |
/effort [level] | reasoning effort of the chat model; alone, a picker of default and the levels the model offers; /effort default gives the conversation back to the default |
/worker_effort [level] | reasoning effort of the worker model (Worker effort); alone, a picker; /worker_effort default gives it back to the default |
/profile [name] | apply a profile of the project file (its models and efforts) to this conversation; alone, list the profiles |
The worker commands were called /swarm_model and /swarm_effort before 0.2.1. The old names still work, but they are no longer listed.
Approvals#
| Command | What it does |
|---|---|
/approval [read-only|auto|full] | set the project's approval mode; alone, a picker |
/trust | trust this project: read its instructions and allow edits |
Screen and settings#
| Command | What it does |
|---|---|
/panel auto|full|compact|hidden | size of the side panel; auto shows it only when it has something to show |
/panel summaries on|off | AI status lines in the side panel |
/diff on|off | tool rows with or without their diffs and previews |
/theme [dark|light|<palette>] | switch the colour theme or palette at once |
/mouse [on|off] | wheel reports on or off (off by default: the wheel still scrolls, and the terminal selects text) |
/settings [what] (also /config, /prefs) | open Settings, at a section or setting |
/help | the commands and the keys |
/quit (also /exit) | leave; running work of this session stops |
/panel, /diff, /theme and /mouse are remembered for the next session. A slash command that is local to the terminal (/queue, /rewind, /undo, bare /effort and /worker_effort, /delete) is answered by the screen itself; in plain mode, bare /effort and /worker_effort report the level and the choices as text instead. To see which files this conversation changed, open Changes from the Ctrl+P palette (see Rewind and changes).
Choices for an argument#
After a command that takes one of a fixed set of values, type a space and the choices open under the composer, filtered by what you have typed after the command:
| Type | The list shows |
|---|---|
/panel | auto, full, compact, hidden, summaries on, summaries off |
/effort, /worker_effort | default, then the levels the model offers |
/approval | read-only, auto, full |
/theme | dark, light and every palette |
/diff, /mouse, /ultra | on, off |
/model, /worker_model | the models of your providers |
/resume | your saved conversations |
The list opens with the cursor on the value that is in force, and that row is marked with a muted ● before its description (* on an ASCII terminal), so Enter on a list you have not touched runs the current value again. Up and Down move through the list, Tab completes the highlighted choice, and Enter completes it and runs the command; when the draft already says exactly one choice, Enter just sends it. Esc closes the list and nothing else, and the list stays closed until you leave that command's argument. /effort with no space after it still opens the picker. A command that takes free text (/goal, /search, /rename and so on) has no list.
The command word in the composer is coloured too: a command ncode knows is drawn bold in the accent colour, an unknown /word is muted. Your own commands and workflows are known to the session, not to the composer, so they read as unknown there; they still run.
Your own commands#
Custom commands and saved workflows appear in the same / list. A Markdown file in the project's .swarm_code/commands/ folder becomes a command of its own; see Project instructions, memory and config. If a name is taken twice, a built-in command wins over a workflow, and a workflow over a custom command.
Note On the desktop app /resume resumes the last stopped run; in the terminal that is /resume-run, and /resume opens a conversation.