flow-next-rp-explorer

gmickel's avatarfrom gmickel

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.

⭐32stars🔀3forks📁View on GitHub🕐Updated Jan 9, 2026⬇️2downloads

When & Why to Use This Skill

RP-Explorer is a token-efficient codebase exploration skill powered by the RepoPrompt CLI. It enables developers to navigate, search, and understand complex repositories within Claude by utilizing structural analysis and intelligent file selection, significantly reducing token consumption while providing deep architectural insights.

Use Cases

  • Rapid Codebase Onboarding: Quickly map out project structures and module relationships using the 'tree' and 'structure' commands to understand a new repository's layout.
  • Token-Optimized Context Building: Select only the most relevant files and export precise context for AI tasks, preventing context window overflow and reducing costs.
  • Feature Impact Analysis: Use the 'builder' and 'search' functions to identify all files, API endpoints, and data flows affected by a proposed code change.
  • Architectural Deep Dives: Trace complex data flows and find similar code patterns across large-scale projects without needing to read every source file in full.
nameflow-next-rp-explorer
descriptionToken-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 structure instead of reading full files (10x fewer tokens)
  • Use builder for 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.