Skip to Content
ReferenceCommands

Commands

Commands in proto fall into three categories based on their prefix.

Slash commands (/)

Session management

CommandDescription
/initAnalyse current directory and create initial context file
/summaryGenerate project summary from conversation history
/compressReplace chat history with summary to save tokens
/resumeResume a previous conversation session
/restoreRestore files to state before tool execution
/exportExport session to file (html, md, json, jsonl)
/recapPrint a “where we left off” card summarizing recent chat
/rewind or /undoOpen rewind dialog to jump back to a previous turn
/rename or /tagRename the current conversation (auto-generates if empty)
/deleteDelete a previous session

Interface

CommandDescription
/clearClear terminal screen (Ctrl+L)
/contextShow context window usage breakdown
/themeChange visual theme
/vimToggle Vim editing mode
/directoryManage multi-directory workspace
/editorSelect preferred editor
/voiceToggle push-to-talk voice input on or off (persisted to settings)
/voice statusShow voice input status: enabled state, STT endpoint, audio backend
/bg listList long-running background shell tasks
/btwAsk a quick side question without affecting the main conversation
/ide status / enable / disableManage IDE companion integration
/docsOpen full proto documentation in your browser
/doctorRun installation and environment diagnostics
/terminal-setupConfigure terminal keybindings for multiline input
/trustManage folder trust settings

Language

CommandDescription
/languageShow current language settings
/language ui [lang]Set UI language (e.g. zh-CN, en-US, de-DE)
/language output <lang>Set LLM output language (e.g. Chinese, English)

Tools & models

CommandDescription
/mcpOpen MCP management dialog (list servers, tools, prompts)
/toolsList available tools
/skills [name]List or invoke skills
/approval-mode <mode>Change approval mode (plan, default, auto-edit, yolo)
/modelSwitch model
/model --fast <model>Set fast model for background tasks
/model info / listShow current model info or list available providers
/extensions manage / install / exploreExplore and manage extensions
/memory show / add / list / forget / refreshManage memory (see also: /memory proposals)
/memory proposals / accept / rejectReview and act on pending memory proposals
/agents createGuided sub-agent creation wizard
/agents manageView, edit, delete sub-agents
/teamManage agent teams
/lsp statusShow LSP server status
/loop [interval] <prompt>Schedule a recurring prompt (e.g. /loop 5m check deploy)
/loop list / clearList or cancel active loops
/goal <condition>Set a completion condition; keep working until it holds
/goal clear / stop / offCancel active goal
/setup-githubSet up GitHub Actions integration

Information & settings

CommandDescription
/help or /?Display help
/about or /statusDisplay version information
/statsShow session statistics (tokens, costs, cached tokens)
/notes / notes --viewView or refresh session notes (.proto/session-notes.md)
/insight status / enable / disableShow or toggle programming insights generation
/settingsOpen settings editor
/setupReminder to run proto setup (wizard requires a fresh terminal)
/authChange authentication method
/permissionsManage folder trust
/bug <description>Submit a bug report
/copyCopy last output to clipboard
/quit or /exitExit proto

Auth CLI subcommands (terminal, outside session)

CommandDescription
proto authInteractive auth setup
proto auth statusShow current auth status

Setup CLI subcommand (terminal, outside session)

CommandDescription
proto setupInteractive wizard — configure a model provider, API key, default model

See Guides → Run the Setup Wizard for a full walkthrough.

@ commands — inject files

FormDescription
@<file>Inject content of a file into the conversation
@<directory>Recursively read all text files in a directory

Escape spaces in paths with backslash: @My\ Documents/file.txt.

! commands — shell execution

FormDescription
!<command>Execute in a subshell
! (standalone)Toggle shell mode — all input goes directly to the shell

Shell commands set PROTO_CODE=1 in the environment.

Custom commands

Save frequently-used prompts as slash commands.

  • Global commands: ~/.proto/commands/<name>.md
  • Project commands: .proto/commands/<name>.md

Project commands take priority over global when names conflict.

Subdirectories create namespaced commands: .proto/commands/git/commit.md/git:commit.

File format

--- description: Optional description shown in /help --- Your prompt content here. Use {{args}} for parameter injection.

Special syntax

SyntaxEffect
{{args}}Inject user-provided arguments
@{file path}Inject file content
!{shell command}Execute and inject output (requires confirmation)
Last updated on