codeindex

star 0

Generate and search symbol indexes to navigate codebases with low token usage

nathandcornell By nathandcornell schedule Updated 1/26/2026

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

  1. Generate the index for a project:
    ./scripts/codeindex/generate-index.sh /path/to/project
    
  2. Search symbols before reading files:
    ./scripts/codeindex/lookup.sh handleAuth /path/to/project
    
  3. Inspect a file's symbols:
    ./scripts/codeindex/file-symbols.sh src/api/auth.ts /path/to/project
    
  4. 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
Install via CLI
npx skills add https://github.com/nathandcornell/nates-codex-toolbelt --skill codeindex
Repository Details
star Stars 0
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator
nathandcornell
nathandcornell Explore all skills →