Does ToonDex support Windows, macOS, and Linux?

Yes, ToonDex is fully cross-platform, utilizing native shell commands like /usr/bin/find on Unix-based systems and PowerShell on Windows for efficient directory scanning.

What happens if my folder structure changes?

You can run the /redex command, which uses your Git history to detect changes and only re-analyzes modified or new folders to keep the index current without a full rescan.

Can I customize which folders are ignored by the indexer?

ToonDex automatically filters common directories like node_modules, .git, and build outputs (dist, build, etc.), ensuring your semantic index remains focused on meaningful source code.

How does ToonDex improve Claude's performance?

By providing semantic summaries of folders in index.toon files, ToonDex allows Claude to navigate directly to relevant directories without scanning irrelevant files, saving tokens and improving task accuracy.

ToonDex Codebase Navigator

Name: ToonDex Codebase Navigator
Author: cpoepke

bycpoepke

0•

开发者工具

Automates the creation and maintenance of semantic folder indexes to improve AI-driven codebase navigation and context awareness.

ToonDex is an experimental semantic indexing tool designed specifically for Claude Code to solve the challenge of navigating large, complex repositories. It recursively analyzes a project's directory structure and generates index.toon files that provide high-level summaries of folder behaviors rather than simple file listings. By prioritizing core business logic and entry points, it helps AI agents understand where to look for specific functionality, significantly reducing token consumption and the time spent exploring unfamiliar architectures. The tool features built-in confidence scoring and Git-integrated change detection to ensure your codebase map remains accurate as your project evolves.

主要功能

01Recursive semantic indexing of directories with priority-based ordering.

020 GitHub stars

03Smart change detection using Git to update summaries via the /redex command.

04Integrated confidence scoring system that flags low-certainty summaries for human review.

05Session-start hooks that proactively suggest index updates when file changes are detected.

06Interactive setup with customizable traversal depth and automated folder filtering.

使用场景

01Maintaining a navigable map for legacy codebases with non-descriptive naming conventions.

02Onboarding Claude Code to massive monorepos with deeply nested package structures.

03Optimizing AI file discovery in modern frameworks like Next.js or distributed microservices.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cpoepke/toon-dex toondex

For use in Claude.ai and ChatGPT