Slash commands
Every slash command in a venom session, grouped by what it is for, with its arguments, plus the context commands in detail.
Type / in the editor to search the commands loaded in this session: venom's, pi's, your prompt templates, your skills (as /skill:<name>) and your plugins'. /commands lists the command files and /skills the skills. Most commands also work in print mode, where their output goes to stdout: venom -p /context.
/context what fills the context window
/btw what was the port? a side question that doesn't disturb the agent
/undo put the files back as they were before the last prompt
/branch 4 -w fork the session at turn 4 into a new git worktreeContext and memory
| Command | What it does |
|---|---|
/context |
Break down the context window: system prompt, tools, memory, skills, conversation, and how close the session is to compaction. |
/compact [focus] |
Compact the conversation now (pi's command; venom writes the summary). Prints how much it freed. |
/clear, /reset |
Start a fresh conversation, as /new. The permission mode, model and gear stay; the old session stays in /resume. |
/forget [n|id|all], /drop |
Hide large tool outputs from the context now. Each output is saved to a file and replaced by a stub naming it, so read and the recall tool still find it. Without an argument it lists the candidates. |
/pin <text> |
Pin a fact: every compaction summary carries it word for word. |
/pins |
List the pinned facts, numbered. |
/unpin <n|text> |
Unpin a fact by its /pins number or its text. |
/btw <question> |
Ask a side question about the session. It is answered from a copy of the agent's last request in a separate call with no tools, while the agent keeps working. The answer is shown to you only: it never enters the transcript or the model's context. Metered as a btw call in /cost. |
/memory [show|edit|forget|path] <name> |
The project's auto-memory; /memory org shows your organisation's facts, /memory propose <fact> proposes one. |
/memory-sync [base] |
Update AGENTS.md/CLAUDE.md for this branch's change. |
/summary [show] |
Write this session's summary now (goal, outcome, files touched, cost), or show the last one. |
Compaction starts automatically. Where it starts, and whether an idle session compacts in the background, is set in venom.yaml: context.autocompact (a share of the window, or off), context.quality (per-model soft and hard thresholds, for example context.quality.*.soft and context.quality.*.hard), and context.idle_compact (seconds idle before a context past the soft threshold is compacted; default 180, or off; context.idle_compact.after and context.idle_compact.headless as an object). VENOM_CONTEXT_WINDOW caps the window venom assumes. When the context passes 80% of the window the TUI says so once.
Files and checkpoints
| Command | What it does |
|---|---|
/undo |
Undo the file changes of the last prompt: the files go back to the checkpoint taken before it. |
/redo |
Re-apply what the last /undo reverted. |
/checkpoints |
List this branch's file checkpoints. |
/rewind |
Pick an earlier point of the conversation (pi's /tree); venom asks whether to restore the files to it too. |
Branches and bookmarks
| Command | What it does |
|---|---|
/bookmark [name] |
Bookmark the latest turn. /bookmark -d <name> removes one. |
/bookmarks [name|turn] |
List bookmarks, or jump to one. |
/branch [turn|bookmark] [-w [name]] |
Fork the session at a turn or bookmark into a new branch session. With -w, or when the session runs in a workspace, the branch gets its own git worktree. /fork <turn|bookmark> is the same; a bare /fork is pi's picker. |
/branches [n] |
The tree of branch sessions (/fork, /branch, /clone); /branches 2 switches to one. |
Bookmarks and branch headers are labels on the session, not messages: none of this reaches the model.
Sessions
| Command | What it does |
|---|---|
/new |
Start a new session. |
/resume |
Switch to another saved session. |
/name [name] |
Set or show the session's name. |
/session |
The session's file, id and statistics. |
/tree |
Navigate the session tree. |
/fork, /clone |
Fork from an earlier message; duplicate the session at this point. |
/import <path> |
Import and resume a JSONL session. |
/export [html|md|jsonl|otlp-json] [path] [--raw] |
Write this session's full trace, secrets scrubbed unless --raw (as venom export). |
/share |
Share this session on Venom Cloud, redacted first (as venom session share). /share live lets teammates watch it as it runs; /share live stop ends that. venom never uploads to pi's gist viewer. |
/copy [N] |
Copy the latest (or Nth-latest) answer to the clipboard, with a picker of its code blocks. |
/handoff @name [message] |
Hand the session to a teammate (Venom Cloud). |
/quit |
Quit. |
Pairing
Two people and one agent, taking turns. Needs venom cloud login; the session is shared live on Venom Cloud.
| Command | What it does |
|---|---|
/pair @alice [--first me|them] |
Start pairing with a teammate; --first says who drives first. /pair end stops, /pair status shows who drives. |
/pass [me|them] |
Pass the driver token to your partner, or take it back. Only the driver's messages reach the agent. |
/comments |
Your partner's comments waiting for you. While your partner drives, what you type goes to them as a comment. |
/include <n…|all|clear> |
Add your partner's comments to your next message. Comments reach the model only this way. |
Agents and work
| Command | What it does |
|---|---|
/agents |
The subagents the task tool can start. |
/subagents [on|off|toggle] |
Multiple subagents mode: off stops the agent from delegating. |
/agents-panel [on|off|auto|legend] |
The live agents panel (see The terminal UI). |
/ps, /top |
This session's agents: state, wait reason, turns, tools, tokens, cost; /top sorts by token rate since the last /top. |
/plan [task|accept] |
Toggle plan mode; /plan <task> starts planning, /plan accept executes the plan. |
/plan-exec |
Plan, approve, then run each step on a worker and verify it. |
/task <url|id|off> |
The pull request, issue or tracker key this session's spend counts toward. |
/workspace [list|new|switch|diff|merge|apply|pr|push|rm] |
Git worktrees (as venom workspace). |
/workflow |
List or run the project's workflow scripts (.venom/workflows). |
/template |
Start from a saved setup: prompt, gear, tools, checks. |
/review, /security-review |
A read-only review, or security review, of the working-tree diff (--staged, --base <ref>, a range). |
/ship [--no-merge] [--title t] |
Gate plan, evidence, pull request and merge queue for this branch (as venom ship). |
/board [prefix] |
The board's notes, with a team's task list summary. |
/fleet |
Your agents and your teammates' on this repository (Venom Cloud). |
/init |
Analyse the project and write AGENTS.md and starter permission rules (as venom init). |
/browser record <name> |
Record a browser task to replay later without the model (record stop, scripts, show, edit, delete). |
/chart <file> [type], /chart <spec> |
Draw a chart in the transcript from a .csv, .tsv, .json or .yaml file, or from a spec. The agent draws the same charts with its chart tool or a fenced chart block. Charts are UI only: they never enter the model's context. |
Models, modes and settings
| Command | What it does |
|---|---|
/model [provider/model] |
Pick a model. |
/thinking [level] |
Set the thinking level. |
/gear [name] |
Shift gears (/gear new, /gear save <name>, /gear edit <name>, /gear rm <name>). |
/mode [mode] |
Show or set the permission mode. |
/permissions |
The permission mode, active rules and where each came from. |
/sudo |
Toggle sudo for this session (no prompts, no sandbox). |
/offline [local|back] |
Offline mode: status, switch now, or go back. |
/config [sentence] |
The effective configuration and each value's source; a sentence ("warn me above $3 a session") drafts a change and asks before writing it. |
/guardrails |
Your organisation's guardrails. |
/mcp-connect [name…] [--force] |
Sign in to your organisation's MCP servers. |
/library |
The team library from Venom Cloud; its prompts run as /org:<name>. |
/plugins |
venom plugins: scope, state, what each adds. |
/settings, /scoped-models, /login, /logout, /reload, /hotkeys, /changelog, /trust |
pi's settings, model cycling list, provider sign-in, reload, key list, changelog and project trust. |
Display
| Command | What it does |
|---|---|
/hud [compact|full|auto|custom] |
The status bar layout. |
/meter [on|off|compact|full] |
The per-call line under each turn. |
/verbose [quiet|normal|full] |
How much of each turn the transcript shows. |
/width <columns|auto|full> |
The chat's width on wide terminals. |
/theme [name|next|auto] |
The colour theme. |
/sounds [play <name>|mute|unmute|toggle] |
Event sounds. |
/prs [left|right] |
The pull requests pane. |
/voice |
Dictate into the editor; /voice again stops. |
The terminal UI explains each of these.
Cost and routing
| Command | What it does |
|---|---|
/cost |
This session's tokens and cost. /cost today|week|month [--by gear|model|role|day|session|task] is your spend over days (as venom cost). |
/usage |
Spend and budgets for your key: this session, today, 7 days, this month. |
/explain-cost |
Why this session cost what it did. |
/routes [1h|24h|7d] [alias] |
Where the orchestrator sent your requests and why. |
Errors
| Symptom | Cause |
|---|---|
| A command's text went to the model as a prompt | The command isn't loaded in this session (a plugin is off, or the project is untrusted). /commands and /plugins show what is. |
/btw: nothing to answer from yet |
/btw needs one request to the agent first. |
/undo finds no checkpoint |
The last prompt changed no files through venom's file tools. |
/forget: the agent is still working |
Wait for the run to end (or press Esc), then /forget. |
/pair fails |
Not signed in: run venom cloud login. |