pi-code-index
v0.3.0
Published
Fast, precise codebase exploration via universal-ctags — symbol search, outlines, exact code retrieval, global index storage, and cross-project search
Maintainers
Readme
code-index
Fast, precise codebase exploration via universal-ctags. A pure skill plugin that teaches AI coding agents to search symbols, browse outlines, and retrieve exact code ranges — instead of reading whole files. No MCP server, no runtime dependencies beyond the ctags binary.
How it works
- Index — runs
ctagsto generate a standard.ctagstags file - Search — grep the tags file by symbol name, kind, or file
- Retrieve — read only the exact lines of a symbol using line ranges from the index
- Outline — get file or project-level symbol overviews from the index
The agent decides autonomously when to index, re-index, or search — no manual commands needed.
Prerequisites
Install universal-ctags (must say "Universal Ctags" in ctags --version):
# macOS
brew install universal-ctags
# Ubuntu / Debian
apt install universal-ctagsInstallation
Claude Code
claude plugin marketplace add https://github.com/kcem/code-index.git
claude plugin install code-index@code-indexGitHub Copilot CLI
copilot plugin install kcem/code-indexpi.dev
pi install git:github.com/kcem/code-indexOr via npm: pi install npm:pi-code-index
Manual (any agent)
Copy skills/code-indexing/SKILL.md into your agent's skills directory. Works with any agent supporting the Agent Skills format.
Supported languages
All 100+ languages supported by universal-ctags — Python, TypeScript, JavaScript, Go, Rust, Java, C/C++, Ruby, PHP, and many more. No configuration needed — languages are detected automatically.
License
MIT
Support
100% free, 100% open source, 100% powered by coffee. If it saved your tokens, a coffee keeps the next plugin brewing.
