name: codeindex description: Generate and search symbol indexes to navigate codebases with low token usage
Code Index Skill
Use CTags to generate a searchable symbol index for quick navigation.
When to use
- Exploring an unfamiliar codebase
- Locating definitions without opening full files
- Mapping file structure before deep reads
Scripts
Scripts live in scripts/codeindex/:
generate-index.sh [project-root]lookup.sh <symbol-pattern> [project-root]file-symbols.sh <file-path> [project-root]
Workflow
- Generate the index for a project:
./scripts/codeindex/generate-index.sh /path/to/project - Search symbols before reading files:
./scripts/codeindex/lookup.sh handleAuth /path/to/project - Inspect a file's symbols:
./scripts/codeindex/file-symbols.sh src/api/auth.ts /path/to/project - Regenerate after edits to keep the index fresh.
Index location
Indexes are written to .codex/codeindex/ inside the target project:
.codex/codeindex/tags.codex/codeindex/files.txt