Commands Reference

Ripperdoc provides both CLI options for startup configuration and slash commands for managing sessions during runtime.

CLI Options

Basic Usage

ripperdoc [OPTIONS] [COMMAND]

Startup Options

Option	Description
`--version`	Show version information
`--help`	Show help message
`--cwd PATH`	Set working directory
`--yolo`	Skip all permission prompts
`--verbose`	Enable verbose output
`--model NAME`	Use a specific model profile
`-c`, `--continue`	Continue the most recent session

Prompt Options

Option	Description
`-p`, `--prompt TEXT`	Run with a direct prompt (non-interactive)
`--system-prompt TEXT`	Replace the default system prompt
`--append-system-prompt TEXT`	Append to the default system prompt

Tool Options

Option	Description
`--tools LIST`	Specify available tools (comma-separated)

Tool values:

"" - Disable all tools
"default" - Use all default tools
"Bash,Edit,Read" - Specific tool list

Display Options

Option	Description
`--show-full-thinking`	Show full reasoning content
`--hide-full-thinking`	Show truncated reasoning preview

Examples

# Start interactive session
ripperdoc

# Continue last session
ripperdoc --continue
ripperdoc -c

# Non-interactive single prompt
ripperdoc -p "Explain this codebase"

# Custom system prompt
ripperdoc --append-system-prompt "Focus on security"

# Limited tools
ripperdoc --tools "Read,Glob,Grep"

# YOLO mode (no permission prompts)
ripperdoc --yolo

Slash Commands

General Commands

/help

Show available commands and usage information.

> /help
> /help tools

/exit

Exit the current session.

> /exit

/clear

Clear the conversation history and start fresh.

> /clear

Session Commands

/status

Show current session status including message count, tokens, and duration.

> /status

/stats

Show detailed session statistics.

> /stats

/cost

Show token usage and estimated costs (includes cache read/write tokens when supported).

> /cost

/compact

Manually compact the conversation to reduce context size.

> /compact
> /compact Focus on API details

/resume

Interactively select and resume a previous session.

> /resume

/fork

Fork the current conversation into a new session, preserving the original.

> /fork

This creates a new session from the current conversation state, allowing you to explore different paths without losing the original context.

Configuration Commands

/config

View or modify configuration.

> /config
> /config set model.timeout 180

/models

Manage model profiles (interactive UI by default).

> /models
> /models tui
> /models list
> /models use fast

/themes

List and switch UI themes.

> /themes              # Show current theme and list available
> /themes light        # Switch to light theme
> /themes preview nord # Preview a theme's color palette

Available themes: dark, light, monokai, dracula, solarized_dark, nord

Tool Commands

/tools

List available tools.

> /tools

/permissions

Manage permission rules (interactive UI by default).

> /permissions
> /permissions tui
> /permissions list
> /permissions add allow Bash "npm test"
> /permissions add ask Bash "terraform *"

Extension Commands

/hooks

Manage hooks configuration.

> /hooks
> /hooks list
> /hooks reload

/skills

List available skills.

> /skills

/skill

Load a skill.

> /skill pdf
> /skill pptx

/agents

Manage agent definitions and runs (interactive UI by default).

> /agents
> /agents tui
> /agents list
> /agents runs
> /agents show <id>
> /agents cancel <id>

/tasks

Manage background shell tasks started with run_in_background.

> /tasks
> /tasks show <id>
> /tasks kill <id>

/mcp

Manage MCP server connections and view stderr logs.

> /mcp                        # Show connected servers
> /mcp logs                   # List log targets
> /mcp logs <server>          # View recent stderr logs
> /mcp logs <server> -f       # Follow log output
> /mcp logs <server> -n 100   # View last 100 lines

Task Management

/todos

View the todo list.

> /todos

/todo

Add or manage todo items.

> /todo add Implement feature X
> /todo done 1

Memory Commands

/memory

View and manage conversation memory.

> /memory

/context

View current context information.

> /context

Output Commands

/output-language

Control the language of assistant responses.

> /output-language           # Show current language setting
> /output-language zh-CN     # Set output to Chinese
> /output-language en        # Set output to English
> /output-language auto      # Follow user's language

/output-style

Select the response style for assistant messages.

> /output-style              # Interactive style selection
> /output-style list         # List available styles
> /output-style default      # Use default style

Available styles vary by configuration but typically include: default, explanatory, learning, etc.

Diagnostics

/doctor

Run diagnostics to check configuration and connectivity.

> /doctor

Custom Commands Management

/commands

Manage custom slash commands with interactive TUI.

> /commands                  # Open interactive commands UI
> /commands list             # List custom commands
> /commands add <name>       # Create a new command
> /commands edit <name>      # Edit an existing command
> /commands delete <name>    # Delete a command

Commands can be stored in:

.ripperdoc/commands/ - Project-level (shared via git)
~/.ripperdoc/commands/ - User-level (all projects)

Legacy Custom Commands

Define simple custom commands in .ripperdoc/commands.json:

{
  "commands": {
    "test": "Run npm test and report results",
    "deploy": "Deploy to staging environment",
    "review": "Review code in $1 for issues"
  }
}

Use custom commands:

> /test
> /review src/api.py

Command Shortcuts

Some commands have shortcuts:

Command	Shortcut
`/help`	`/h`
`/exit`	`/q`
`/clear`	`/c`
`/status`	`/s`

Getting Help

For help on any command:

> /help <command>

For example:

> /help permissions

Commands Reference

On this page