---
title: Slash commands
description: Every slash command in a venom session, grouped by what it is for, with its arguments, plus the context commands in detail.
section: cli
order: 20
audience: [user, agent]
sources: [packages/harness/src/extensions/context-commands.ts, packages/harness/src/extensions/side-question.ts, packages/harness/src/extensions/branches.ts, packages/harness/src/extensions/checkpoints.ts, packages/harness/src/extensions/session-summary.ts, packages/harness/src/extensions/context-cost.ts, cli/src/live-share.ts, cli/src/rewind.ts, plugins/charts/src/extension.ts]
features: [cli.btw, cli.clear, cli.forget, cli.pin, cli.summary, cli.undo, cli.branch, cli.bookmark, cli.context, cli.pair, cli.pass, cli.comments, cli.include, cli.chart]
---

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

```text
/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 {#context}

| 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 {#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 {#branches}

| 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 {#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 {#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 {#agents}

| 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](/docs/cli/tui.md#agents-panel)). |
| `/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](/docs/cli/plan-mode.md); `/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 {#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 {#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](/docs/cli/tui.md) explains each of these.

## Cost and routing {#cost}

| 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 {#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`. |
