RepoPrompt Skill
When to Use
-
Explore codebase structure (tree, codemaps)
-
Search code with context lines
-
Get code signatures without full file content (token-efficient)
-
Read file slices (specific line ranges)
-
Build context for tasks
Token Optimization
RepoPrompt is more token-efficient than raw file reads:
-
structure → signatures only (not full content)
-
read --start-line --limit → slices instead of full files
-
search --context-lines → relevant matches with context
CLI Usage
If installed to PATH (Settings → MCP Server → Install CLI to PATH)
rp-cli -e 'command'
Or use the alias (configure in your shell)
repoprompt_cli -e 'command'
Commands Reference
File Tree
Full tree
rp-cli -e 'tree'
Folders only
rp-cli -e 'tree --mode folders'
Selected files only
rp-cli -e 'tree --mode selected'
Code Structure (Codemaps) - TOKEN EFFICIENT
Structure of specific paths
rp-cli -e 'structure src/auth/'
Structure of selected files
rp-cli -e 'structure --scope selected'
Limit results
rp-cli -e 'structure src/ --max-results 10'
Search
Basic search
rp-cli -e 'search "pattern"'
With context lines
rp-cli -e 'search "error" --context-lines 3'
Filter by extension
rp-cli -e 'search "TODO" --extensions .ts,.tsx'
Limit results
rp-cli -e 'search "function" --max-results 20'
Read Files - TOKEN EFFICIENT
Full file
rp-cli -e 'read path/to/file.ts'
Line range (slice)
rp-cli -e 'read path/to/file.ts --start-line 50 --limit 30'
Last N lines (tail)
rp-cli -e 'read path/to/file.ts --start-line -20'
Selection Management
Add files to selection
rp-cli -e 'select add src/auth/'
Set selection (replace)
rp-cli -e 'select set src/api/ src/types/'
Clear selection
rp-cli -e 'select clear'
View current selection
rp-cli -e 'select get'
Workspace Context
Get full context
rp-cli -e 'context'
Specific includes
rp-cli -e 'context --include prompt,selection,tree'
Chain Commands
Multiple operations
rp-cli -e 'select set src/auth/ && structure --scope selected && context'
Workspaces
List workspaces
rp-cli -e 'workspace list'
List tabs
rp-cli -e 'workspace tabs'
Switch workspace
rp-cli -e 'workspace switch "ProjectName"'
AI Chat (uses RepoPrompt's models)
Send to chat
rp-cli -e 'chat "How does the auth system work?"'
Plan mode
rp-cli -e 'chat "Design a new feature" --mode plan'
Context Builder (AI-powered file selection)
Auto-select relevant files for a task
rp-cli -e 'builder "implement user authentication"'
Workflow Shorthand Flags
Quick operations without -e syntax
rp-cli --workspace MyProject --select-set src/ --export-context ~/out.md rp-cli --chat "How does auth work?" rp-cli --builder "implement user authentication"
Script Files (.rp)
For repeatable workflows, save commands to a script:
daily-export.rp
workspace switch Frontend select set src/components/ context --all > ~/exports/frontend.md
Run with:
rp-cli --exec-file ~/scripts/daily-export.rp
CLI Flags
Flag Purpose
-e 'cmd'
Execute command(s)
-w <id>
Target window ID
-q
Quiet mode
-d <cmd>
Detailed help for command
--wait-for-server 5
Wait for connection (scripts)
Async Operations (tmux)
For long-running operations like builder , use the async script:
Start context builder async
uv run python -m runtime.harness scripts/repoprompt_async.py
--action start --task "understand the auth system"
With workspace switch
uv run python -m runtime.harness scripts/repoprompt_async.py
--action start --workspace "MyProject" --task "explore API patterns"
Check status
uv run python -m runtime.harness scripts/repoprompt_async.py --action status
Get result when done
uv run python -m runtime.harness scripts/repoprompt_async.py --action result
Kill if needed
uv run python -m runtime.harness scripts/repoprompt_async.py --action kill
Note
Requires RepoPrompt app running with MCP Server enabled.