toondex

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