jahala/tilth

Smart(er) code reading for humans and AI agents. Reduces cost per correct answer by ~40% on average. Install: cargo install tilth -or- npx tilth

What it solves

AI 代理经常在大型代码库中苦苦挣扎，需要多次调用工具（如 glob、grep、读取文件）才能找到单个函数，浪费 token 和时间。tilth 提供代码库的结构感知，使代理和人类能够定位定义、追踪调用链、理解文件内容，而无需冗余读取。

How it works

tilth 结合 ripgrep 的快速文本搜索、tree-sitter 对 16 种语言的 AST 解析，以及内存映射文件读取以提升速度。它根据文件大小处理文件：小文件完整返回，大文件则用其内容的结构化大纲替代。

关键能力包括：

  • Structural Search：查找符号的定义位置，而不仅仅是文本出现的位置。
  • Call Chain Tracing：使用 tree-sitter 查询自动解析被调用者和调用者。
  • Dependency Analysis：识别文件导入了什么以及哪些文件依赖它。
  • Structural Diff：提供函数级别的变更检测，而非基于行的 diff。
  • MCP Integration：作为 Model Context Protocol (MCP) 服务器，直接集成 Claude Code、Cursor、Windsurf 等 AI 代理。

Who it’s for

开发者和 AI 代理创建者，想要降低 token 成本并提升 AI 驱动的代码导航和编辑的准确性。

Highlights

  • Cost Reduction：基准显示对 Claude 3.5 Sonnet 等模型，每个正确答案的成本可降低至 44%。
  • Language Support：支持 16 种语言，包括 Rust、TypeScript、Python、Go 和 Java。
  • High Performance：使用 Rust 编写，无运行时依赖，利用并发缓存和 SIMD 预过滤。
  • Hash-Anchored Editing：可选的“Edit mode”使用哈希确保编辑应用到正确的行，防止文件变更时出错。
  • Broad MCP Support：可轻松安装于各种 AI IDE 和代理。