🗺️ repomap-plugin
Claude Code plugin for efficient codebase context loading.
What is this?
A Claude Code plugin that teaches Claude to use repomap for two-phase context gathering:
- Orientation — Get structural map first (~1-2k tokens)
- Targeted retrieval — Read only what's needed
Install
1. Install the tools
brew tap JordanCoin/tap
brew install codemap docmap repomap
2. Install the plugin
# Clone the plugin
git clone https://github.com/JordanCoin/repomap-plugin.git ~/.claude-plugins/repomap
# Run Claude Code with the plugin
claude --plugin-dir ~/.claude-plugins/repomap
Or add to your Claude Code settings for permanent use.
Usage
Command: /repomap:map
/repomap:map .
Runs repomap to get combined code + doc structure as JSON.
Skill: Context Planner
Claude automatically uses the context-planner skill when:
- Starting work on an unfamiliar codebase
- Tasks involve multiple components
- You ask Claude to "explore" or "understand" the codebase
How it works
┌─────────────────────────────────────────────────┐
│ Task: "Add auth to the API" │
└─────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────┐
│ Phase 1: repomap . (~1-2k tokens) │
│ → See all files, functions, docs │
└─────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────┐
│ Phase 2: Read src/api/auth.go, docs/AUTH.md │
│ → Only what's relevant │
└─────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────┐
│ Implement with full context, minimal tokens │
└─────────────────────────────────────────────────┘
License
MIT
JordanCoin
