A slash command runs in the client rather than being sent to the model. Nothing you type here costs a turn or enters the context window, which is why swapping a model, compacting history, or listing your sessions is a command rather than a request.
The menu
Type /help in the terminal to print this list where you
are working. It is the same table, read out of the same place.
| Command | What it does |
|---|---|
| /scope [path] | set project directory (default: cwd) |
| /model <name> | swap to a different model |
| /moor [name] | swap the active mooring, or list the fleet |
| /unmoor <name> | cast off a berth; the record stays |
| /status | show model, scope, and cwd |
| /clear | clear history and start a new session |
| /compact | compact history now to free context |
| /crow [path|diff] | review code read-only (also /crows-nest) |
| /full [n] | reprint a recent tool call uncapped |
| /hooks [on|off n] | list outside tools, their tools and cost |
| /subagents [word] | delegations, their cost, and where children run |
| /moorings | list the fleet and what is tied up |
| /sessions | list recent stored sessions |
| /resume <id> | resume a stored session by id or prefix |
| /shortcuts | show keyboard shortcuts |
| /help | show this menu |
| /quit | exit shoal |
Press / in an empty composer to open the menu, or type a
name straight into it. Commands are grouped the way the menu groups
them, and the ones with a key binding show it.
Session
| Command | Key | What it does |
|---|---|---|
| /clear or /new | Alt + N | start a fresh session |
| /sessions | Alt + R | list sessions you can resume |
| /resume <id> | - | resume a stored session by id |
| /interrupt or /cancel, /stop | Esc | stop the running turn |
| /quit or /exit | - | shut the engine down |
Context
| Command | Key | What it does |
|---|---|---|
| /compact | Alt + K | compact history now |
| /context | Alt + X | token accounting so far |
Workflows
| Command | Key | What it does |
|---|---|---|
| /crows-nest [path|diff] or /crow | Alt + C | review code read-only and report findings |
Model
| Command | Key | What it does |
|---|---|---|
| /model <name> | - | swap the active model |
| /moor [name] | Alt + M | swap the mooring, or open the mooring form |
| /unmoor <name> | - | cast off a berth; the record stays |
| /moorings | - | list what this session can moor |
| /mode <name> | Alt + B | set the headspace Shoal works in |
Composer
| Command | Key | What it does |
|---|---|---|
| /hail | Alt + J | put the next prompt in front of the running turn |
| /queue | Alt + U | hold the next prompt until this turn finishes |
| /attach | Alt + A | attach a file to the next prompt |
| /settings | Alt + , | open settings |
Tools
| Command | Key | What it does |
|---|---|---|
| /subagents [all|on|off|auto|same|<mooring>] or /subs | Alt + Y | what has been delegated, and where children run |
| /hooks [on|off <name>] | - | outside tools bound in, and what each has cost |
Help
| Command | Key | What it does |
|---|---|---|
| /help | / | list every command |
| /shortcuts | Alt + / | keyboard shortcuts |
| /status | Alt + S | model, session, and mode |
Press / in an empty composer to open the menu, or type a
name straight into it. Commands are grouped the way the menu groups
them, and the ones with a key binding show it.
Session
| Command | Key | What it does |
|---|---|---|
| /clear or /new | Alt + N | start a fresh session |
| /sessions | Alt + R | list sessions you can resume |
| /resume <id> | - | resume a stored session by id |
| /interrupt or /cancel, /stop | Esc | stop the running turn |
| /quit or /exit | - | shut the engine down |
Context
| Command | Key | What it does |
|---|---|---|
| /compact | Alt + K | compact history now |
| /context | Alt + X | token accounting so far |
Workflows
| Command | Key | What it does |
|---|---|---|
| /crows-nest [path|diff] or /crow | Alt + C | review code read-only and report findings |
Model
| Command | Key | What it does |
|---|---|---|
| /model <name> | - | swap the active model |
| /moor [name] | Alt + M | swap the mooring, or open the mooring form |
| /unmoor <name> | - | cast off a berth; the record stays |
| /moorings | - | list what this session can moor |
| /mode <name> | Alt + B | set the headspace Shoal works in |
Composer
| Command | Key | What it does |
|---|---|---|
| /hail | Alt + J | put the next prompt in front of the running turn |
| /queue | Alt + U | hold the next prompt until this turn finishes |
| /attach | Alt + A | attach a file to the next prompt |
| /settings | Alt + , | open settings |
Tools
| Command | Key | What it does |
|---|---|---|
| /subagents [all|on|off|auto|same|<mooring>] or /subs | Alt + Y | what has been delegated, and where children run |
| /hooks [on|off <name>] | - | outside tools bound in, and what each has cost |
Help
| Command | Key | What it does |
|---|---|---|
| /help | / | list every command |
| /shortcuts | Alt + / | keyboard shortcuts |
| /status | Alt + S | model, session, and mode |
What differs between the clients
The terminal and the windowed clients do not carry the same list, and this page shows you the one belonging to whichever you picked at the top of the sidebar. The windowed clients add commands for things only a window can do, such as attaching a file or opening settings, and the terminal adds ones for things only a terminal can do, such as reprinting a capped tool result in full. The commands that matter most, swapping a model, compacting, reviewing, and resuming, are in both.
Generated by scripts/clidocs from Shoal 0.21.0: the
terminal table from the menu it prints, the windowed table from the
client both windowed surfaces host.