LeanCTX が制御するものとは
AI が何を見るか。
LeanCTX はAIエージェントのためのコンテキストエンジニアリングレイヤーです。すべての読み取り、コマンド、検索に対して同じループを実行する小さなRustバイナリです。これは、エージェントが何を読み、セッションをまたいで何を記憶し、何に触れるか、署名された台帳に何を保存するか証明し、そして何を見たかを再生することを決定します。読み取りは26言語で構造解析され、ノイズが除去されるため、モデルに届く情報は意図的で、圧縮され、検証可能です。一度インストールするだけで、あとはすべて自動です。
LeanCTXはどこに？ 位置する？
LeanCTXは2つのパスに存在します。読み取りパスでは、ファイル読み込み、コード検索、シェル出力がエージェントがそれを見る前に圧縮され、整形されます。ワイヤーパスでは、オプションのローカルプロキシがエージェントとモデルの間に配置され、すべての送信リクエスト（システムプロンプト、完全な履歴、ツール結果）をprompt-cache安全性を保ちながら圧縮します。一方はコンテキストに入るものをトリミングし、もう一方は支払いをするすべてのリクエストをトリミングします。モデルはトークンを大幅に削減した同じシグナルを受け取ります。
lean-ctxなしの場合： あなた → AIツール → ファイルを読み込む （全コンテンツ） → LLMがすべてを処理する lean-ctxありの場合： あなた → AIツール → lean-ctx 圧縮する → シグナルのみ → LLM: ノイズを60〜90%削減 ├─ PathJailサンドボックス + サイズ制限 ├─ AST対応の圧縮 ├─ メモリランタイム（知識と忘却） ├─ セッションキャッシュ（再読み込み ≈ 13 tok） └─ 10 ファイルタイプごとの読み取りモード
ディープダイブ： シェルパターン (95+ パターン) · 読み取りモード (10 圧縮モード) · Caching
あなた
通常通りコーディングするだけ。ワークフローは何も変える必要はありません。
AIツール
Cursor, Claude Code, Copilot, Windsurf, …
LeanCTX
MCPサーバーとシェルフックを通じて、AIツールが自動検出した内容を決定し、圧縮し、記憶します。
LLM
シグナルのみを見る。トークン数が60〜90%減り、情報は同じまま。
単一のバイナリ。 5つの機能。
すべての機能は単一のRustバイナリ内で実行されます。ここでは、リクエストがLeanCTXをどのように流れるかを示します：AIツールから認知パイプラインを経由し、モデルへ。
- 10の読み取りモード
- コンテキスト可視性
- トークンカウント
- 意図検出
- Tree-sitter AST (26言語)
- 95以上のシェルパターン
- CDC再順序付け（Rabin-Karp）
- 64 KBの予算、500 msの期限
- セッションキャッシュ (zstd、インメモリ)
- 13トークン再読み込み
- ナレッジグラフ (SQLite)
- クロスセッションメモリ
- PathJailサンドボックス
- OSレベルの分離
- シェル許可リスト (デフォルト拒否)
- 完全な監査証跡
- GitHub · GitLab · Jira · Linear
- Postgres · REST · MCP Bridge
- ハイブリッド検索 (BM25 + セマンティック)
- 設定ベースのプロバイダー (TOML)
LeanCTXが実現する5つのこと すべてのトークンに。
あなたのAIとコードの間で、単一のローカルバイナリが、すべての読み取り、コマンド、検索に対して同じ5段階のループを実行します—知覚、圧縮、記憶、ルーティング、ガバナンス。これらが連携して、以下の5つの役割を果たします：エージェントが何を読み取るかを決定し、学習したことを記憶し、触れるものを保護し、保存するものに証明を与え、見たものを再生します。
知覚する
行動する前に重要なものを見る。
tree-sitterを使用して、未知のリポジトリをマッピングし、重要なファイルとシンボルを表面化し、ファイル全体ではなく構造を読み取ります。対応言語は26種類。
ctx_overview → repo mapped in one call 圧縮する
すべてのトークンにシグナルを込める。
10種類の読み取りモード、95以上のシェル出力パターン、およびコンテンツアドレス指定キャッシュにより、読み取り量を60〜90%削減し、再読み取りを約13トークンに抑えます。ノイズがモデルに届くことはありません。
ctx_read → 4,200 → 920 tokens (78% saved) 記憶する
セッションを超えた継続性。
発見事項、決定、および触れたファイルは永続化され、新しいセッションごとに自動復元されるため、エージェントがコンテキストを再説明したり、すでに知っていることを再読み取ったりすることはありません。
ctx_session → restored · 0 re-reads ルーティングする
適切なコンテキストを適切なモデルへ。
意図を検出し、読み取りモードとトークン予算を選択し、タスクが必要なツールのみをロードすることで、各モデルが適切なコンテキストのみを受け取り、それ以上のものは受け取らないようにします。
ctx_intent → right mode + budget per task 統治する
安全で、計測され、強制される。
PathJail（シェル・アローリスト）、シークレット検出、ロールポリシー、およびトークン予算により、すべてのツール呼び出しを範囲内に保ち、分析によって正確に何が保存されたかを証明します。
ctx_verify → paths ok · secrets blocked 何が あなた（YOU） 実際にやることは？
ほとんど何も。LeanCTXは、初回セットアップ後も目立たないように機能します。これまで通りコーディングを続ければOKです。
インストール
単一のRustバイナリ。依存関係なし、クラウド不要、アカウントも不要。
curl -fsSL https://leanctx.com/install.sh | sh Setup
シェルとAIツールを自動検出します。数秒で全ての設定が完了します。
lean-ctx setup 完了。すべて自動です
通常通りコーディングするだけ。AIが圧縮されたツールを自動で使用します。
節約されたトークン数： 自動的にあなた vs. 機械
| あなたが行うこと（一度だけ） | 自動で行われること |
|---|---|
| lean-ctx setup | AIがReadの代わりにctx_readを使用 - 最大99%トークン削減（キャッシュ再読み込み） |
AIがShellの代わりにctx_shellを使用 - 60–90%トークン削減 | |
AIがGrepの代わりにctx_searchを使用 - 50–80%トークン削減 | |
| Shell hookがCLI出力を透過的に圧縮します | |
| セッションキャッシュが読み取りをまたいでファイルを記憶します（再読み込みで約13トークン） | |
| lean-ctx gain (optional) | 生涯の節約額ダッシュボードを確認する |
忘れることさえも決定である。
セッションキャッシュがいっぱいになると、LeanCTXは自動的に保持するものと破棄するものを判断します。最近性、頻度、サイズに基づいてエントリをランク付けし、これらのシグナルを単一のスコアに融合させます。チューニングは不要です。
キャッシングの仕組み触れたものは守る。
LeanCTXは、LLMプロンプトインジェクションがプロジェクト外のファイルにアクセスするのを防ぐため、深層防御セキュリティモデルを強制します：
../エスケープ、およびジャイル外の絶対パスは、resolve_pathのチョークポイントでブロックされます。lean-ctx doctorによって自動的にチェックされます。アーキテクチャを理解したいですか？
Cognitive Context Layerを探求：6段階のパイプライン、統合モード、エージェントマトリックス、Context Field Theory、そしてLeanCTXを機能させる9つのアーキテクチャの柱。
仕組みについて、回答します。
LeanCTXとは何ですか？
LeanCTX (short for Lean Context) はAIエージェントのためのオープンソースのコンテキストエンジニアリングレイヤーです。単一のローカルRustバイナリが、エージェントが何を読み、何が送信されるかを圧縮し、何を学習したかを記憶し、何に触れるかを保護し、何を保存したかを証明し、何を見たかを再生します。その結果、受信データは最大60〜90%削減されます。
圧縮はコード品質に影響しますか？
いいえ。LeanCTXはtree-sitter AST解析を使用してコード構造を理解し、LLMが必要としないものだけ（冗長な空白、定型的なインポート、装飾的なコメントなど）を削除します。平均して、AST構造の98%、識別子の97%、意味のあるコード行の96%が保持されます。これはlean-ctx benchmarkを実行することで検証できます。
LeanCTXはどうやってインストールしますか？
cargo install lean-ctx、または curl -fsSL https://leanctx.com/install.sh | sh でインストールしてください。その後、シェルフックのためにlean-ctx initを、AIツールと接続するためにlean-ctx setupを実行します。設定は不要です。
LeanCTXはどのAIツールをサポートしていますか？
LeanCTXは、Cursor、GitHub Copilot、Claude Code、Windsurf、Cline、OpenAI Codex、Gemini CLI、Antigravity、Pi、Crush、Zed、Continue、OpenCodeなど、すべての主要なAIコーディングツールと連携します。すべてのツールが、コンテキストサーバーとシェルフックの圧縮の両方から恩恵を受けます。