ToonDex
"Oh, I see you've discovered my meticulously organized archive."
ToonDex creates semantic folder indexes for LLM codebase navigation. It generates an index.toon file with concise summaries of each folder, ordered by importance.
Installation
Claude Code Plugin
# Add the marketplace
/plugin marketplace add cpoepke/Toon-Dex
# Install ToonDex
/plugin install toondex@Toon-Dex
Manual Installation
# Clone and run init script
git clone https://github.com/cpoepke/Toon-Dex.git
./Toon-Dex/.claude/skills/toondex/scripts/init.sh /path/to/your/project
Usage
Create Index
/toondex
Creates an index.toon file with semantic folder summaries:
# my-project
src/app,Next.js App Router. Page routes layouts and API handlers.
src/components,UI component library. Shadcn-based atomic design.
src/lib,Core utilities. API client with retry logic and shared hooks.
Update Index
/redex
Detects changes since last index and updates only modified folders.
Automatic Detection
ToonDex includes a session hook that automatically detects when your index is outdated and proposes updates.
Format
# {project-name}
{path},{summary}
{path},{summary}
- Order = Priority: First entry is most important
- Summaries describe behavior: "Handles auth" not "Contains auth.ts"
- State via git: No separate state file needed
See docs/INDEX_SPEC.md for the full specification.
Features
- Semantic summaries: Describes what code does, not what files exist
- Priority ordering: Most important folders first
- Confidence scoring: Reviews low-confidence summaries with user
- Incremental updates: Only re-analyzes changed folders
- Auto-detection: Session hook proposes updates when needed
- Cross-platform: Bash and PowerShell scripts
Catchphrases
- On success: "Best. Index. Ever."
- On messy code: "Worst. Folder structure. Ever."
- On startup: "Oh, I see you've discovered my meticulously organized archive."
License
MIT - See LICENSE