24 Slash Commands

Type / in the TUI to trigger the command palette, or type a command directly like /model claude-sonnet-4-6.

/status

Display current session status — version, active model, provider, approval mode, CWD, token counts, tool limits, and pricing.

Usage
/status

Passing no arguments shows all current values. The output is also shown live in the status line at the bottom of the TUI.

/help

List all 24 slash commands with their usage syntax and descriptions.

Usage
/help

/model

Switch the active AI model. Supports aliases for quick switching, custom pricing, and context window adjustment.

Usage
/model claude-sonnet-4-6
alias Short names: opus, sonnet, haiku, gpt4o, gpt4turbo, o1, o3-mini
pricing Set custom per-million pricing: /model pricing 0.5;2.0 (in;out)
windows Set max context window in tokens: /model windows 1000000

Default model is claude-sonnet-4-6. Changing the model also resets token counters and context window.

/provider

Switch the AI provider. Each provider uses its own API key and base URL from settings.

Usage
/provider <anthropic|openai|google|local|ollama|openrouter>
anthropic Uses ANTHROPIC_API_KEY (+ optional ANTHROPIC_URL for custom endpoints)
openai Uses OPENAI_API_KEY (+ optional OPENAI_URL)
google Uses GOOGLE_API_KEY (+ optional GOOGLE_URL)
local Uses MODEL_URL + MODEL_API_KEY for any OpenAI-compatible local server
ollama Uses MODEL_URL + MODEL_API_KEY (Ollama's OpenAI-compatible API)
openrouter Uses OPENROUTER_API_KEY + OPENROUTER_URL — routes through Anthropic's API adapter

/mode

Set the approval mode — controls which tool calls require user confirmation and which run automatically.

Usage
/mode <plan|edit|auto|yolo>
plan Read-only tools free. Writes only allowed under plans/ directory. All other mutations denied.
edit Edit and Write auto-approved. Shell commands and network calls ask for approval.
auto Non-destructive edits auto-proceed. Each tool call is first checked by the LLM for safety. Network calls ask.
yolo No approvals at all. Everything runs automatically. Use with caution.

/theme

Change the TUI color theme. Changes persist across restarts.

Usage
/theme <name>
themes tokyo-night (default), nord, dracula, solarized, gruvbox, black, white, grey

/effort

Set the extended thinking token budget. Controls how many tokens the model can use for internal reasoning before answering.

Usage
/effort <low|medium|high|max|auto>
low 2,000 reasoning tokens
medium 6,000 reasoning tokens
high 16,000 reasoning tokens
max 32,000 reasoning tokens
auto Let the model decide dynamically (default)

Extended thinking only works with providers that support it (Anthropic, some OpenRouter models). Higher budgets use more context window and cost more.

/tools

View or set the maximum number of tool calls the model can make in a single turn.

Usage
/tools [tools_per_call [websearch_per_call]]
no args Show current limits (default: 10 tools, 5 web searches per turn)
/tools 15 Set tools per call to 15 (web search limit unchanged)
/tools 15 8 Set both limits at once

/websearch

Set the limit for combined WebSearch + WebFetch calls per turn. Uses Brave Search API.

Usage
/websearch <count>
no args Show current limit (default: 5)
/websearch 3 Set to 3 web searches per turn

/context

View context window usage, list conversation messages, or compact (summarize) the conversation to free up space.

Usage
/context [messages|compact [detailed|brief]]
no args Show context window visual bar with token count and percentage
/context messages Print the full conversation history with role labels (truncated at 8000 chars)
/context compact Summarize the conversation to free context (default: detailed summary)
/context compact brief Create a shorter, higher-level summary

/stats

Switch to the Stats tab to view daily usage, session count, streaks, and token cost trends.

Usage
/stats

This command switches the TUI to the Stats tab. The tab also shows cost estimates in USD based on current model pricing.

/memory

Manage the agent's persistent memory files stored in ~/.curie-agent/memory/.

Usage
/memory [status|add <text>]
/memory status Show file sizes for all memory files (SOUL.md, USER.md, AGENTS.md, MEMORY.md, etc.)
/memory add Capture a memory entry. The agent will organize it into the appropriate memory files on the next turn.

/debug

Toggle debug logging. Shows verbose output including raw API payloads and internal events.

Usage
/debug [on|off]

Toggling with no argument flips the current state. Debug logs go to stdout and are useful for troubleshooting provider connectivity issues.

/statusline

Toggle the status line at the bottom of the TUI (above the input field).

Usage
/statusline [on|off]

The status line shows model, effort level, approval mode, input/output tokens, and estimated cost. Default is visible.

/mcp

Manage MCP (Model Context Protocol) servers. Connect external tool servers and their tools become available to the agent.

Usage
/mcp <list|add|remove|reload>
/mcp list Show all configured MCP servers with connection status (● connected, ○ disconnected, [not loaded])
/mcp add /mcp add <id> <stdio|sse|streamable-http> [--env key=value] [command] [args...]
/mcp remove /mcp remove <id>
/mcp reload Disconnect and reconnect all MCP servers

Transport types

stdio — local process (e.g. /mcp add filesystem stdio npx -y @modelcontextprotocol/server-filesystem /workspace)

sse — Server-Sent Events over HTTP (e.g. /mcp add my-api sse https://api.example.com/mcp)

streamable-http — Streamable HTTP transport

MCP servers configured in MCP_SERVERS in settings.json. Connection persists across restarts.

/channels

Manage Telegram channel integration. Configure bot token, allowed users, and active channels.

Usage
/channels <list|switch|set-bot-token|set-user-id|set-chat-id|disconnect>
list Show current Telegram config (bot token mask, user ID, chat ID)
set-bot-token /channels set-bot-token <123456:ABC-DEF...>
set-user-id /channels set-user-id <123456789> — who is allowed to use the bot
set-chat-id /channels set-chat-id <-1001234567890> — which chat to respond in
switch /channels switch main|telegram:12345 — switch the active conversation channel
disconnect Stop Telegram polling

Groups are supported with TELEGRAM_ALLOW_GROUPS in settings. Each Telegram chat gets its own conversation with inline approval buttons.

/remind

Create a reminder using natural language time parsing. The agent will send you a message when the time arrives.

Usage
/remind <message at time>
relative /remind "in 30 minutes call mom"
absolute /remind "tomorrow at 7am make breakfast"
day of week /remind "next monday at 9am standup notes"

Requires the agent to be running at the scheduled time. Reminders are stored in the cron manager and show up in /cron list.

/cron

Manage scheduled reminders — list active tasks, cancel specific ones, or clear completed reminders.

Usage
/cron <list|delete|clear>
list Show all pending, fired, or cancelled reminders with status icons and scheduled times
delete /cron delete <id> — cancel a specific reminder by ID
clear Remove all fired/completed reminders from the list

/heartbeat

Manage the autonomous heartbeat cycle — scheduled runs where the agent operates in yolo mode, reading memory files, executing tasks from HEARTBEAT.md, and reporting back.

Usage
/heartbeat <status|enable|disable|times|daily|weekly|monthly|now>
status Show heartbeat status, active schedule, and all schedule configs
enable / disable Turn the heartbeat cycle on or off
times /heartbeat times 8:10,10:10,14:20 — specific times during the day (comma-separated H:MM)
daily /heartbeat daily 6:00 — run every day at a specific time
weekly /heartbeat weekly monday@6:00 — run every week on a specific day
monthly /heartbeat monthly 1@6:00 — run on day 1 of each month
now Run the heartbeat immediately

The heartbeat reads MEMORY.md, USER.md, AGENTS.md, TODO.md and the active schedule section from HEARTBEAT.md, then executes tasks autonomously.

/agent

Launch an external AI agent subprocess (Claude CLI). The agent runs in parallel while you continue working in the main session.

Usage
/agent [--mode plan|edit|auto|yolo] [--effort low|medium|high|max|auto] <prompt>
--mode Set approval mode for the spawned agent (plan, edit, auto, or yolo)
--effort Set reasoning effort for the spawned agent
prompt The task to delegate to the agent

Example

/agent --mode auto --effort medium refactor auth module

Output streams to the Agents tab in the TUI. Multiple agents can run concurrently.

/init

Run the interactive setup wizard — step-by-step configuration of provider, API key, model, and identity files.

Usage
/init
wizard steps 1) Choose provider (Anthropic, OpenAI, local, OpenRouter, Ollama) → 2) Enter API key → 3) Select model → 4) Set identity (SOUL.md, USER.md, AGENTS.md, MEMORY.md, TOOLS.md)

If SOUL.md and settings.json already exist, the wizard assumes initialization is complete. Can also pass an API key directly: /init <sk-...>.

/snapshots

List recent git-stash snapshots for recovery. Snapshots are created automatically before each turn in yolo mode.

Usage
/snapshots

Returns a numbered list of snapshots with SHA, timestamp, and message. Use with /revert to restore a previous state. Silently disabled outside a git repository.

/revert

Revert the working directory to a git snapshot. Restores files to their state before a specific turn.

Usage
/revert [index]
index Snapshot index (0 = most recent, default: 0)

Works only with snapshots created by /snapshots. Restoring creates a new git commit that reverts files to the snapshot state.

/exit

Exit curie-agent and close the current session. The session is saved and can be resumed later with curie-agent resume or curie-agent continue.

Usage
/exit

Session data is preserved in ~/.curie-agent/sessions/<id>/ for later inspection or resumption.