defendend/Claude-ast-index-search

解决的问题

ast-index 是一款专为大型、多语言存储库设计的结构化代码导航 CLI。它以具备 AST（抽象语法树）感知的索引取代了不精确的“grep 风格”文本搜索，让开发者与 AI 代理能通过精确的结构（如类、函数与继承关系）来浏览代码，而非仅仅依赖简单的文本比对。

运作原理

此工具会建立一个包含符号、引用、导入、模块与依赖关系的本地 SQLite 索引。它支持多种编程语言（包括 Kotlin、Java、Rust、Python、Go 与 C++）。用户可以使用 rebuild 建立索引，并透过 update 保持索引更新。

对于 AI 代理，它能提供精简且可解析的结构化代码片段，而非原始文件内容，这在大型存储库中可减少 40-50% 的 Token 使用量。它也能通过插件或技能与 Claude Code、Cursor 与 Gemini CLI 等 AI 工具整合。

适用对象

• 开发者：在大型 Monorepo 或多语言项目中工作，需要快速、精确地浏览符号与依赖关系的人员。
• AI 代理开发者：希望为其编码代理提供关于代码库高精确度、低 Token 消耗上下文的人员。

特色亮点

• AST 感知导航：直接跳转至数十种语言的定义、用法、调用者与实现。
• 代理优化：返回结构化代码片段以节省 Token，并为 LLM 提供更好的上下文。
• Git 集成洞察：包含 hotspots 指令，可根据变更频率、错误修复与作者数量对文件进行排名，以识别不稳定的代码。
• 符号图谱：建立符号对符号的依赖图谱，以分析影响范围、寻找循环依赖并确定最核心的符号。
• 高性能：在大型项目中寻找导入、依赖项与类时，速度显著优于 grep。
• Monorepo 支持：包含针对嵌套项目标记与跨根工作区的特定工作流程。