Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Slash Command Index

Type / in the interactive TUI to open the command picker, or type a command name directly. Commands marked hidden are accessible by name but do not appear in /help.

For a narrative introduction, see Slash Commands and Custom Slash Commands.

Session

CommandArgsDescription
/clear—Clear the transcript and conversation history. Keeps system prompt, todos, plan-mode, and skills cache.
/init[--force]Generate a CLAUDE.draft.md from available context sources (AGENTS.md, .cursorrules, .windsurfrules, README.md, git status). Refuses to overwrite an existing CLAUDE.md without --force.
/resume[query]List persisted sessions sorted by most-recently-updated, with an optional case-insensitive substring filter.
/recap—Summarize the conversation so far without mutating history.
/export[path] [--format json]Export the session transcript to a file. Default format: Markdown. Default filename: caliban-session-<date>.md in the CWD. Pass --format json for JSON output.
/btw<question>One-shot ephemeral question to a fast model (routed as FastClassifier); result inlined to transcript without touching the main session.

Model & Auth

CommandArgsDescription
/model[id]With no args: list the active provider's known model ids and the currently-selected one. With an id: switch the active model at runtime (same-provider in v1).
/effort<level>Set reasoning effort for the next turn. Values: low, medium, high, max, auto.
/status—Show provider / auth / subscription status.
/login—Run the active provider's auth flow (full browser OAuth implementation pending the Auth spec).
/logout—Clear cached credentials for the active provider (pending the Auth spec).
/setup-token—Generate a long-lived Anthropic OAuth token for CI use (pending the Auth spec).

Permissions

CommandArgsDescription
/permissions—Open the permissions overlay. Shows current mode, bypass-latch state, and runtime rules. Tab cycles mode; d deletes the selected rule.

Observability

CommandArgsDescription
/usage—Show cumulative token and cost usage for this session, per model.
/cost—Show cumulative cost and a per-(provider, model) breakdown with cache savings.
/context—Show context window utilization and the top-N largest content blocks (by character count).
/compact—Trigger the configured compactor; reports dropped/summarized message count.
/doctor[--deep]Run startup-time health checks (settings, MCP, skills, hooks, auth). --deep adds provider auth pings.

Memory

CommandArgsDescription
/memory[list|show <slug>|edit <slug>|delete <slug>]View or edit memory tiers and auto-memory topic files. No args: show tier summary.

Configuration & Extensibility

CommandArgsDescription
/config—Open the tabbed settings editor overlay.
/hooks—List configured hooks per event type with handler counts.
/mcp—Open the MCP server status overlay.
/plugins—List installed plugins with enable/disable status.
/agents—List sub-agents. (Full fleet overlay arrives with the sub-agent isolation spec; use caliban agents list from a shell for now.)
/skills—List skills loaded from .caliban/skills/ and other configured roots.

Plan Mode

CommandArgsDescription
/plan—Toggle plan mode. When ON, mutating tools are blocked. Reflected in the active session and statusline.

Output

CommandArgsDescription
/output-style—Show the active output style and the available list. Change the style via CALIBAN_OUTPUT_STYLE or output_style in settings.

Diagnostics

CommandArgsDescription
/rewind—Open the checkpoint/rewind picker overlay (ADR 0028). Also opened by pressing Esc Esc.
/statusline—Show the active status-line command configuration (or instructions to set one).
/loop[--n=<count>] [--interval=<seconds>]Re-run the last assistant turn N times (bounded by --max-turns). Default: 3 repeats, 15-second interval.
/feedback—Submit feedback to the configured endpoint. Requires feedback_url in settings.
/heapdump—Capture a heap profile (requires caliban to be rebuilt with --features=jemalloc-prof).
/tui—Toggle fullscreen vs. default TUI mode (pending TUI ergonomics spec).

General

CommandArgsDescription
/help—List all visible registered slash commands.
/quit—Exit caliban.
/exit—Alias for /quit (hidden).

Hidden commands

/exit, /plugin (alias for /plugins), and /system (view active system prompt) are registered but do not appear in /help output.

Custom slash commands

You can add your own slash commands by placing skill files under .caliban/skills/<name>/SKILL.md. See Custom Slash Commands.