---

name: rp-cli description: Reference for rp-cli usage patterns. Consult before calling rp-cli via Bash.

rp-cli Reference

Quick reference for rp-cli commands. rp-cli is a proxy MCP client that lets AI agents access RepoPrompt's tools through shell commands.

Prerequisites

• RepoPrompt must be running on your Mac
• MCP Server must be enabled in RepoPrompt settings
• CLI installed via Settings → MCP Server → "Install CLI to PATH"

Basic Usage

Copyrp-cli -e '<command>'                    # Execute single command
rp-cli -e '<cmd1> && <cmd2>'            # Chain commands
rp-cli -w <id> -e '<command>'           # Target specific window

Common Commands

Context Builder (Planning)

Copyrp-cli -e 'builder "YOUR_INSTRUCTIONS" --response-type plan'

Creates implementation plan. Returns chat_id for follow-up.

Chat (Continue Conversation)

Copyrp-cli -e 'chat "YOUR_MESSAGE" --mode plan'
rp-cli -e 'chat "YOUR_MESSAGE" --chat-id "CHAT_ID" --mode plan'

Modes: chat, plan, edit

Chat History

Copyrp-cli -e 'chats list --limit 10'
rp-cli -e 'chats log --chat-id "CHAT_ID" --limit 10'

File Selection

Copyrp-cli -e 'select add path/to/file.ts'
rp-cli -e 'select remove path/to/file.ts'
rp-cli -e 'select set path/to/file1.ts path/to/file2.ts'
rp-cli -e 'select clear'
rp-cli -e 'select promote path/to/codemap.ts'   # Upgrade to full file
rp-cli -e 'select demote path/to/large.ts'      # Downgrade to codemap

Workspace Context

Copyrp-cli -e 'context'
rp-cli -e 'context --include prompt,selection,tokens'

File Tree

Copyrp-cli -e 'tree'
rp-cli -e 'tree --mode auto'
rp-cli -e 'tree --folders'

Search

Copyrp-cli -e 'search "pattern"'
rp-cli -e 'search "pattern" --extensions .ts'

Code Structure

Copyrp-cli -e 'structure src/auth'
rp-cli -e 'map src/components'

Read Files

Copyrp-cli -e 'read path/to/file.ts'
rp-cli -e 'read path/to/file.ts --start-line 45 --limit 100'

Workspace Management

Copyrp-cli -e 'workspace list'
rp-cli -e 'workspace tabs'
rp-cli -e 'workspace tab "TAB_NAME"'
rp-cli -e 'workspace switch "PROJECT_NAME"'

Chaining Commands

Copyrp-cli -e 'workspace MyProject && select set src/ && context'

Output Redirection

Copyrp-cli -e 'context > /tmp/context.md'

Bash Execution Notes

• Use single quotes around the -e argument
• Escape single quotes in instructions: replace ' with '\''
• No sandbox required (communicates via local socket)

Parsing Chat Log

When fetching chats with chats log:

• role: "user" = task context (ignore)
• role: "assistant" = architectural plan (parse this)
• Always use the last assistant message

Troubleshooting

Connection failures: Ensure RepoPrompt is running and MCP Server is enabled

Command not found: Run rp-cli --version to verify installation

Operations need approval: Some operations require approval in RepoPrompt UI

More Information

• Help: rp-cli --help
• Command details: rp-cli -d <command>