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、ファイル読み取り)を行い、トークンと時間を浪費します。tilth はコードベースの構造認識を提供し、エージェントと人間が定義を特定し、呼び出しチェーンを追跡し、冗長な読み取りなしでファイル内容を理解できるようにします。

How it works

tilth は高速テキスト検索のための ripgrep、16 言語に対応した AST 解析の tree-sitter、および高速化のためのメモリマップドファイル読み取りを組み合わせています。ファイルサイズに応じて処理を分け、小さなファイルは全文返却し、大きなファイルは内容の構造化アウトラインで置き換えます。

主な機能は次のとおりです:

  • 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 主導のコードナビゲーションと編集の精度を高めたい開発者および AI エージェント作成者向けです。

Highlights

  • Cost Reduction:ベンチマークでは Claude 3.5 Sonnet などのモデルで正解 1 件あたりのコストが最大 44% 削減されました。
  • Language Support:Rust、TypeScript、Python、Go、Java など 16 言語をサポート。
  • High Performance:Rust で構築され、ランタイム依存がなく、並列キャッシュと SIMD 前フィルタリングを活用。
  • Hash-Anchored Editing:ハッシュを使用して編集が正しい行に適用されることを保証するオプションの「Edit mode」。ファイルが変更された際のエラーを防止します。
  • Broad MCP Support:さまざまな AI IDE とエージェントへのインストールが容易です。