人間のためのコマンド。
AIのための結果。
lean-ctxはセットアップ後は自動で動作します。しかし、制御が必要な時には、これらのコマンドが待っています。
基本 コマンド
lean-ctx setup 1回限りのセットアップ。シェル（zsh/bash/fish）を自動検出し、インストール済みのAIツールを検出し、MCPとシェルフックを設定。一度実行すれば、あとは気にする必要なし。
インストール後に一度実行lean-ctx init 特定のAIツール用のクイックセットアップ。--agent cursor、--agent claude、--agent codex、または--agent geminiを使用して、そのツールのMCPを直接設定します。
lean-ctx gain 節約ダッシュボードを表示。累計token節約量、圧縮率、上位コマンド、USD換算。すべてのセッションにわたって永続化。
いつでも確認可能モニタリング & インサイト
lean-ctx gain token数、圧縮率、上位コマンド、USD換算を含む累計節約ダッシュボード。
$ lean-ctx gain
◆ lean-ctx Token Savings Dashboard
────────────────────────────────
1.7M saved 76.8% rate $4.25 USD
Top Commands
curl 48x ████████████ 728K
git 34x ██████ 375K
lean-ctx gain --live 自動更新ライブダッシュボード。AIツールがリアルタイムでtokenを節約する様子を2秒ごとに更新。
$ lean-ctx gain --live
◆ lean-ctx LIVE refreshing every 2s
────────────────────────────────
1.7M saved ▁▃█▇██▁█
Session: 42 cmds | 89.2K saved | 94.1% rate
Press q to quit
lean-ctx gain --graph 日別バー、スパークライン、トレンド表示付きの30日間節約チャート。節約の推移を確認できます。
$ lean-ctx gain --graph
Token Savings (30 days)
03-20 │ ██████████████████████ 1.0M
03-21 │ ███████████████ 690K
03-22 │ ████████████████████████ 1.1M
03-23 │ █ 9.4K
03-24 │ ██████████████████████ 1.7M
lean-ctx dashboard localhost:3333のWebダッシュボード。インタラクティブなチャート、セッション履歴、リアルタイム監視をブラウザで。
$ lean-ctx dashboard
◆ lean-ctx Dashboard
→ http://localhost:3333
Interactive charts, session history, command breakdown
Press Ctrl+C to stop
lean-ctx wrapped token節約の「Spotify Wrapped」。累計統計、上位コマンド、個人の圧縮実績を含む、美しくシェア可能なレポート。
$ lean-ctx wrapped monthly
◆ Your March 2026 Wrapped
────────────────────────────────
4.9M tokens saved
3,241 commands compressed
$12.16 USD saved
Top pattern: curl (97% compression)
You're in the top 5% of lean-ctx users
診断
lean-ctx doctor 8つのインストールチェックを実行 - バイナリ、シェルフック、MCP設定、統計ファイル、cacheディレクトリ、対応シェル、AIツール検出、バージョン確認。
✓ Binary installed
✓ Shell hook active (zsh)
✓ MCP config (Cursor)
✓ Stats persistence
✓ Cache directory
✓ Data directory writable
✓ Project detection
✓ Graph index
✓ Search index
✓ Agent hooks
✓ Version up to date
All 11 checks passed
lean-ctx discover シェル履歴をスキャンして、圧縮の恩恵を受けられるがまだインターセプトされていないコマンドを検出します。
Found 12 uncompressed commands:
kubectl - 34 calls, ~89% savings possible
helm - 12 calls, ~76% savings possible
terraform - 8 calls, ~82% savings possible
Run setup to enable these
lean-ctx benchmark run tiktoken（o200k_base）を使用して、コードベースでの実際のtoken節約量を計測。推定値ではなく正確な数値。
src/auth.ts (123 lines)
full: 3,517 → 3,517 (0%)
map: 3,517 → 412 (88%)
signatures: 3,517 → 252 (93%)
entropy: 3,517 → 312 (91%)
パワーユーザー コマンド
| コマンド | 説明 |
|---|---|
lean-ctx init --agent <name> | 特定のAIツール用のクイックMCPセットアップ（cursor, claude, codex, gemini, windsurf, copilot, cline, roo, pi, qwen, trae, amazonq, jetbrains） |
lean-ctx read <file> -m <mode> | 圧縮モード（full, map, signatures, diff, aggressive, entropy）を指定してファイルを読み取り。キャッシュされた読み取りは約13トークンを返します。--freshでキャッシュをバイパス。 |
lean-ctx diff | 圧縮されたgit diff - 変更概要付きの構造化出力 |
lean-ctx grep <pattern> | token効率の高いコンパクトなコンテキスト付きパターン検索 |
lean-ctx find <pattern> | ファイル名で検索 - ファイル数付きのコンパクトな結果 |
lean-ctx ls | コンパクトなツリーマップとしてのディレクトリ一覧 |
lean-ctx -c "<cmd>" | 任意のシェルコマンド出力をlean-ctxで圧縮 |
lean-ctx config set <key> <value> | lean-ctxの設定 - チェックポイント間隔、cache TTL、CRPモード |
lean-ctx cache [stats|clear|invalidate] | CLIファイルキャッシュを管理 - 統計表示、エントリクリア、特定パスの無効化 |
lean-ctx setup | ワンコマンドセットアップ - シェルフック、エディターMCPを設定し、すべてが正常に動作することを確認 |
あなたの 節約を確認する準備はできましたか？
lean-ctxをインストールし、setupを実行して、すぐにtokenの節約を開始。gainでいつでもダッシュボードを確認できます。