このプロジェクトについて

ctxは、コーディングエージェント向けのコンテキストエンジニアリングを目的とした、オープンでローカル、高速なCLIツールチェーンです。Claude Code、Codex、Cursor、Pi、Gemini CLIなどのツールによってマシン上に既に保存されている履歴をインデックス化し、プロバイダー固有のログを、セッション、メッセージ、ツール呼び出し、関係、リポジトリ活動の一貫したローカルレコードに変換します。エージェントは、`ctx search`でその履歴を検索し、`ctx show`で正確なイベントや完全なトランスクリプトを検査し、`ctx locate`でソースの場所を特定できます。検索はデフォルトでBM25語彙マッチングを使用し、`ctx semantic enable`を通じてオプションのローカルセマンティック検索を有効にできます。 主要な機能は`ctx blame`で、git blameのように機能しますが、コミットされたコードを生成したエージェントセッションに帰属させ、元のトランスクリプトとツール呼び出しへの引用を提供します。ファイルと行範囲、コミット、またはプルリクエストから開始でき、エージェントがコード内で見えなくなった制約、決定、失敗したアプローチ、仮定を回復するのに役立ちます。 `ctx graph`は、コードベースのマッピングと影響分析を提供します。これはGraphifyに触発された独立したRust実装で、グラフをSQLiteに保存するため、検索はデータベースを直接クエリし、更新は変更されたファイルのみに触れます。このプロジェクトは、大規模なリポジトリでGraphifyよりも大幅に高速な検索と更新パフォーマンスを報告し、既存の`.graf/index.db`データベースとの互換性を維持しています。 `ctx sift`は、コーディングエージェントに到達する前にノイズの多いツール出力を削減し、元のコマンドはそのままにして、繰り返されるパス、ログ、フォーマットに費やすトークンを減らします。通常の圧縮はローカルで実行され、オプションの元の保持により、`ctx sift recall`で完全なキャプチャ出力を回復できます。 履歴インデックス化は、エージェントプロセス内のフックやコードなしでローカルに実行されます。自動インデックス化はローカルインデックスを最新に保ち、更新は完了後にのみ表示されます。このプロジェクトには、自己管理のctxサーバーを介した履歴のバックアップや選択したセッションの共有のベータサポートも含まれており、共有はオプトインです。SDKはTypeScript、Python、Rust、Go、JVM、Swift、.NET向けに文書化されており、カスタム履歴プラグインはサポートされていないエージェント形式に適応できます。