vincentkoc/tokenjuice

🧃 Token weight loss. Lean output compaction for terminal-heavy agent workflows. Works as a native CLI tool or as an extension to popular coding and agent frameworks.

何を解決するか

Tokenjuiceは、AIエージェントワークフローにおける「テキストの壁」問題を軽減します。エージェントがターミナルコマンド(例:git statusdocker build)を実行すると、その出力はしばしばノイズが多く、非常に長くなり、コンテキストウィンドウのトークンを無駄に消費し、LLMを混乱させる可能性があります。Tokenjuiceは、コマンドの実際の振る舞いを変更せずに、この出力をより小さく意味のあるペイロードに圧縮します。

動作方法

これは決定論的な出力圧縮ツールとして機能します。コマンド実行後の出力を観察し、ルール駆動型のリダクション処理を適用してペイロードを縮小します。これらのルールは、確率的なLLMによる要約に頼るのではなく、確認可能なJSON形式で保存されています。ユーザーは明示的に --raw--full フラグを指定するか、オプトイン型のアーティファクトストレージを通じて、元の完全な出力を取得できます。

対象ユーザー

Claude Code、Cursor、Aider、OpenHandsなどのターミナル中心のAIエージェントやハーネスを構築または使用している開発者で、コマンドトランザクションのクリーニングによりトークン使用量を最適化し、エージェントの信頼性を向上させたい方。

特徴

  • 決定論的圧縮: LLMの「雰囲気」に頼らず、ルールベースのリダクションにより一貫した出力を保証。
  • 広範な統合対応: 多数のAIコーディングエージェントやIDEに対して、ワンコマンドインストールを提供。
  • コンテキスト効率性: トランザクションの無駄を最小限に抑え、無駄な再実行の必要を減らす。
  • 隠密な動作: シェル体験を標準のままに保ちつつ、ホスト統合用の軽量ラッパーを提供。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト