rp-explorer
Token-efficient codebase exploration using RepoPrompt CLI. Use when user says "use rp to..." or "use repoprompt to..." followed by explore, find, understand, search, or similar actions.
When & Why to Use This Skill
RP-Explorer is a high-performance Claude skill designed for token-efficient codebase exploration using the RepoPrompt CLI. It enables developers to rapidly navigate complex repositories, map architectural structures, and extract precise code context while minimizing token consumption. By utilizing advanced commands like 'builder' for AI-driven discovery and 'structure' for high-level overviews, it streamlines the process of understanding unfamiliar codebases and preparing context for development tasks.
Use Cases
- Rapid Onboarding: Use 'tree' and 'structure' commands to quickly grasp the layout and architectural patterns of a new or complex codebase.
- Efficient Context Management: Selectively export relevant code snippets and file structures to provide Claude with focused context, significantly reducing token usage compared to full-file reading.
- Deep-Dive Analysis: Trace data flows and identify dependencies across multiple files to understand how specific features, like authentication or API endpoints, are implemented.
- AI-Powered Code Search: Leverage the 'builder' command to find relevant files and logic based on natural language queries, simplifying the discovery of specific implementation patterns.
| name | rp-explorer |
|---|---|
| description | Token-efficient codebase exploration using RepoPrompt CLI. Use when user says "use rp to..." or "use repoprompt to..." followed by explore, find, understand, search, or similar actions. |
RP-Explorer
Token-efficient codebase exploration using RepoPrompt CLI.
Trigger Phrases
Activates when user combines "use rp" or "use repoprompt" with an action:
- "use rp to explore how auth works"
- "use repoprompt to find similar patterns"
- "use rp to understand the data flow"
- "use repoprompt to search for API endpoints"
CLI Reference
Read cli-reference.md for complete command documentation.
Quick Start
Step 1: Get Overview
rp-cli -e 'tree'
rp-cli -e 'structure .'
Step 2: Find Relevant Files
rp-cli -e 'search "auth" --context-lines 2'
rp-cli -e 'builder "understand authentication"'
Step 3: Deep Dive
rp-cli -e 'select set src/auth/'
rp-cli -e 'structure --scope selected'
rp-cli -e 'read src/auth/login.ts'
Step 4: Export Context
rp-cli -e 'context --all > codebase-map.md'
Token Efficiency
- Use
structureinstead of reading full files (10x fewer tokens) - Use
builderfor AI-powered file discovery - Select only relevant files before exporting context
Tab Isolation
builder creates an isolated compose tab automatically. Use -t to target it:
# Builder returns: Tab: <UUID> • <Name>
rp-cli -w W -t "<Name>" -e 'select add extra.ts && context'
# Or chain commands:
rp-cli -w W -e 'builder "find auth" && select add extra.ts && context'
Requirements
RepoPrompt v1.5.62+ with rp-cli installed.