Skip to content
Docs menu

Slash commands

Every slash command in a venom session, grouped by what it is for, with its arguments, plus the context commands in detail.

View .md

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 worktree

Context 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.