How do I install the Rp CLI skill?

Run npx skillmds add majiayu000/rp-cli-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Rp CLI skill do?

Reference for rp-cli usage patterns. Consult before calling rp-cli via Bash. It is listed under Coding & Dev Tools on SkillMD.

Is Rp CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Rp CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Rp CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Rp CLI?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Rp CLI by majiayu000 — Agent Skill

Name: Rp CLI
Rating: 4.2 (5 reviews)
Author: majiayu000

File contents

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

rp-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)

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

Creates implementation plan. Returns chat_id for follow-up.

Chat (Continue Conversation)

rp-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

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

File Selection

rp-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

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

File Tree

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

Search

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

Code Structure

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

Read Files

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

Workspace Management

rp-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

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

Output Redirection

rp-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>

---name: rp-cli-2description: 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 ```bash rp-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) ```bash rp-cli -e 'builder "YOUR_INSTRUCTIONS" --response-type plan' ``` Creates implementation plan. Returns chat_id for follow-up. ### Chat (Continue Conversation) ```bash rp-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 ```bash rp-cli -e 'chats list --limit 10' rp-cli -e 'chats log --chat-id "CHAT_ID" --limit 10' ``` ### File Selection ```bash rp-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 ```bash rp-cli -e 'context' rp-cli -e 'context --include prompt,selection,tokens' ``` ### File Tree ```bash rp-cli -e 'tree' rp-cli -e 'tree --mode auto' rp-cli -e 'tree --folders' ``` ### Search ```bash rp-cli -e 'search "pattern"' rp-cli -e 'search "pattern" --extensions .ts' ``` ### Code Structure ```bash rp-cli -e 'structure src/auth' rp-cli -e 'map src/components' ``` ### Read Files ```bash rp-cli -e 'read path/to/file.ts' rp-cli -e 'read path/to/file.ts --start-line 45 --limit 100' ``` ### Workspace Management ```bash rp-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 ```bash rp-cli -e 'workspace MyProject && select set src/ && context' ``` ## Output Redirection ```bash rp-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>`

Frequently asked questions