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 與代理。