rp-cli

# 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