ncode

CLI docs Slash commands

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#

CommandWhat it does
/new (also /clear)start a new conversation; this one stays saved
/resumepick a saved conversation; each row shows its age and last prompt
/resume <id or title>open that conversation
/resume-runresume the last stopped run of this conversation
/stopstop everything running in this conversation
/queue <text>queue a message behind the running turn
/queuelist the queued messages, numbered
/queue drop <n>remove queued message n
/queue clearremove every queued message
/rename <title>rename this conversation
/forkcopy this conversation into a new one and open it
/deletedelete 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
/costtokens 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#

CommandWhat 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
/reviewreview the uncommitted changes and report problems
/ultraturn 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
/workflowsopen the workflow library and runs
/create-workflow [what it should do]write a new workflow with the assistant
/rewindgo back to before an earlier turn: the conversation, the files, or both (see Rewind)
/undorewind the last turn: its messages and its files (asks first)
/agentsthe agent definitions a swarm can use, with their source, model and description

See Modes and run types and Workflows.

Model and effort#

CommandWhat 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#

CommandWhat it does
/approval [read-only|auto|full]set the project's approval mode; alone, a picker
/trusttrust this project: read its instructions and allow edits

Screen and settings#

CommandWhat it does
/panel auto|full|compact|hiddensize of the side panel; auto shows it only when it has something to show
/panel summaries on|offAI status lines in the side panel
/diff on|offtool 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
/helpthe 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:

TypeThe list shows
/panelauto, full, compact, hidden, summaries on, summaries off
/effort, /worker_effortdefault, then the levels the model offers
/approvalread-only, auto, full
/themedark, light and every palette
/diff, /mouse, /ultraon, off
/model, /worker_modelthe models of your providers
/resumeyour 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.