JuliusBrussee/caveman

Caveman – AI コーディングエージェントのためのトークン節約レイヤー

それは何か

• あなたと LLM を利用したコーディングアシスタント（Claude、Gemini、OpenAI など）の間に位置する CLI ベースのプロキシで、正確なコードと意味を維持しながら、回答と入力を大幅に短く書き換えます。
• これは、オン/オフを切り替えられる 6 つの独立した機能を備えた「岩」として機能します。
  1. Say less – モデルに簡潔で制御された英語スタイルで回答するように強制し（例：New object ref each render, so React re-renders. Wrap the prop in useMemo.）、出力トークンを削減します。
  2. Read less – モデルが読み取る前に、ログ、CSV、JSON、YAML、テスト出力などを圧縮し、一般的なセッションで入力トークンを約 33% 削減します。
  3. Auto – 各リクエストに対して最も安価なモデルと努力レベルを自動的に選択し、高努力の Claude Opus 実行と比較して約 54% のコストを節約します。
  4. Blocks – エージェントが繰り返し作成するスクリプトを保存するコードモードキャッシュで、再生成する代わりに再利用し、実行ごとのトークン使用量を数百から数十に削減します。
  5. Waste fixes – 過去のセッションを分析してトークン集約型パターンを特定し、修正を提案します。また、一時停止中も Anthropic プロンプトキャッシュをウォームに保ちます。
  6. Browse – ウェブページを取得し、大幅に圧縮されたバージョン（例：121 トークン vs 15k 生トークン）を返します。

なぜ重要なのか

• LLM の価格設定は通常トークン単位です。入力と出力の両方のトークンを削減すると、回答品質を損なうことなく、コーディングセッションのコストを半分以上に削減できます（このリポジトリは、Adobe Research、JetBrains、Elastic との A/B テストで、測定可能な品質低下がないことを示しています）。
• このツールはモデルに依存しません。インストールすると、Claude、Gemini、OpenAI、および 30 以上の他のエージェントを自動的にラップします。

インストール

npx @caveman-ai/cli@latest   # ワンライナー、macOS、Linux、Windows（Node 22.13+）で動作

• インストーラーはエージェントを検出し、必要なログインを尋ね、デフォルトで 6 つの岩すべてをアクティブにします。
• 後で caveman on|off <rock> で個々の岩を切り替えたり、プロキシ全体を無効にしたりできます。

コアコマンド

コマンド	目的
caveman claude	サポートされているエージェントに対して Caveman を有効にしてコーディングセッションを開始します。
caveman status	どの岩がアクティブで、どのエージェントがラップされているかを表示します。
`caveman on	off `
cavelon learn	トークン使用履歴を分析し、修正を提案します。
/caveman, /ultracave, /megacave	回答スタイルを切り替えるチャット内ショートカット（異なるトークンバジェット、多言語）。
/caveman-compress <file>	モデルが読み取る前にローカルファイル（ログ、JSON など）を圧縮します。
caveman-blocks scan	エージェントが繰り返し書き換えるスクリプトを一覧表示します。ブロックによりエージェントはそれらを再利用できます。

影響の証拠

• CSV、ログ、YAML、JSON、テスト出力の混合スイート全体で、入力トークンが 33.2% 削減。
• Auto を使用した 85 タスクのコーディングベンチマークで、コストが 54% 削減。
• Blocks を適用すると、単一のテスト実行スクリプトのトークンが 397 → 76 に。
• Adobe Research（コスト削減 1.4-2.4 倍）、JetBrains（品質低下なし）、Elastic（応答トークン 63.6% 削減）による独立した検証。

誰が使うべきか

• LLM を利用したコードアシスタントに依存し、API コストを低く抑えたい開発者。
• 内部 AI エージェントを展開するチーム（Caveman Cloud アドオンは、本番エージェント向けの可観測性、評価、自動操縦提案を提供します）。
• Node ベースの CLI に慣れており、簡潔さのために薄いプロキシがモデル出力を書き換えることを受け入れられる人。

リンク

• ドキュメントとインストールガイド：./INSTALL.md
• 完全なベンチマーク詳細：./docs/WRAP-BENCHMARK.md、./docs/AUTO-BENCHMARK.md
• クラウド製品：https://caveman.so