optiflow-mcp

Claude Codeのプラグイン1つ、MCPサーバー1つ、リポジトリ1つ — 個別にインストールされたツールのラッパーではありません。実際に2つの上流プロジェクトの真のソースを自身のコードベースに統合しています：

1. token-optimizer-mcp の 76個の実際のsmart_*/アナリティクス/ダッシュボード監視MCPツールと、その PreToolUse/PreCompact 強制フックを、src/optimizer/ に直接移植 — npx インストールも別プロセスも不要。

2. headroom の実際のRust 圧縮コア（SmartCrusher）を native/headroom-core/ にフォークし、 機能を削減して、実際のWebAssembly（native/headroom-wasm/）にコンパイル。 これをNodeプラグインが直接読み込む — 本物のRustアルゴリズムであり、書き直しではありません。headroomのCodeCompressorとKompress MLモデルは、代わりにTypeScriptでネイティブ実装されています（src/native/）。

3. どちらの上流ツールもカバーしていなかった5つの独自モジュール：chopスタイルの Bash/CLI出力インターセプト、セッションレポートのトランスクリプト分析、 ステータスラインコンテキストメーター、/optiflow:compact-continue セッションハンドオフ チェックポイント、大規模JSON/CSV/YAMLペイロード用のTOON変換。

両方の上流プロジェクトは、出典/ライセンステキストのために vendor/ 下にgitサブモジュールとして参照されていますが、src/ や native/ 下のものは vendor/ からインポートしていません — なぜこれが元のオーケストレーションラッパーデザイン（v1）を置き換えたかについては docs/ADR/0002-real-merge-not-orchestration.md を、完全な権限マップと確定した決定事項については docs/architecture.md を参照してください。

ステータス

両方の主要なマージが完了し、配線されています：token-optimizer-mcpからの76ツール＋強制フックのマージ、およびheadroomの圧縮コア（WASM SmartCrusher + TS CodeCompressor/Kompress）は、単に分離してビルドされただけでなく、実際に出荷パイプラインから呼び出されています。npm run build、npm test、npx tsc --noEmit はすべてパスしています — モジュールごとの詳細と現在のテスト数については docs/modules.md を参照してください。ソースからビルドするには、Nodeに加えてRustツールチェーン（rustup、wasm32-unknown-unknown ターゲット、wasm-pack）が必要です。プラグインのインストールには必要ありません（コンパイル済みの .wasm はコミットされています。plugin/dist/ と同じ理由です）。

Related MCP server: claude-engineering-coach

始め方

github.com/kristijankopacevic/optiflow-mcp で公開されています。ローカルパスマーケットプレイスを介してエンドツーエンドで検証済み（そのために gh 認証は不要です）：

1. Claude Codeセッションで、このリポジトリをマーケットプレイスとして追加し、プラグインをインストールします：

   /plugin marketplace add C:\path\to\optiflow-mcp
   /plugin install optiflow@optiflow

2. 環境を確認します：

   optiflow doctor

   Node/npmのバージョン、設定の解決、gh の存在/認証を報告します。

3. ステータスラインを有効化します（オプション、選択制 — プラグインをインストールするだけでは settings.json を変更しません）：

   optiflow install --statusline

   書き込み前に ~/.claude/settings.json をバックアップし、原子的に書き込み、--force なしで既存の異なるステータスラインを上書きすることを拒否します。optiflow uninstall で元に戻します。詳細（手動での設定方法を含む）は docs/statusline-manual-setup.md を、残りのモジュールについては docs/modules.md を参照してください。

このクイックスタートを超えたアーキテクチャ、設定、モジュールごとの詳細については docs/ を参照してください。

ライセンス

optiflow-mcp独自のコードはMITライセンスです（LICENSE を参照）。このリポジトリは、MITライセンス（token-optimizer-mcp）およびApache-2.0ライセンス（headroom）の上流プロジェクトからのソースもコピーしています — THIRD_PARTY_LICENSES.md および NOTICE を参照してください。