repoprompt
Use RepoPrompt CLI for token-efficient codebase exploration
When & Why to Use This Skill
RepoPrompt is a high-performance CLI tool designed for token-efficient codebase exploration and context building. It enables developers to navigate complex repositories, search code with precision, and extract specific code signatures or file slices, significantly reducing token consumption while providing high-quality context for LLM-driven development tasks.
Use Cases
- 1. Efficient Codebase Mapping: Generate file trees and code signatures to understand project architecture and structure without exhausting token limits with full file content.
- 2. Targeted Code Search and Debugging: Locate specific patterns or errors with configurable context lines to provide the AI with precise, relevant snippets for troubleshooting.
- 3. Optimized Context Management: Use selection tools and file slicing (reading specific line ranges) to feed only the most necessary code segments into the AI's prompt.
- 4. Automated Task Planning: Leverage the AI-powered 'context builder' to automatically identify and select relevant files for implementing new features or performing large-scale refactoring.
| name | repoprompt |
|---|---|
| description | Use RepoPrompt CLI for token-efficient codebase exploration |
| allowed-tools | [Bash, Read] |
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 filessearch --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.