KTCrisis/flux7-mesh

flux7-mesh は何をしますか？

AIエージェント用のガードレールサイドカープロキシ — ポリシー、承認ゲート、権限付与、トレーシング。単一のGoバイナリ、単一のYAML。

概要

flux7-mesh は、AIエージェント（Claude Code、Cursor、Codex など）の動作を監視・制御するための軽量サイドカープロキシです。

主な機能:

• ポリシー評価: エージェントのリクエストをルールに基づいて許可/拒否
• 承認ゲート: 特定の操作に人間の承認を要求
• 権限付与: エージェントが持つ権限を動的に制御
• トレーシング: すべての操作をログに記録し、後で分析可能

仕組み

1. エージェント（例: Claude Code）が HTTPS 経由で API コールを実行
2. プロキシがリクエストを傍受し、YAML 設定ファイルに定義されたポリシーと照合
3. ポリシーに基づいてリクエストを許可、拒否、または承認待ちに
4. すべての決定とリクエストの詳細をトレースとして記録

クイックスタート

前提条件

• Go 1.21 以上
• エージェント（Claude Code、Cursor など）

インストール

go install github.com/KTCrisis/flux7-mesh@latest

設定

config.yaml ファイルを作成:

server:
  port: 8443
  tls_cert: "cert.pem"
  tls_key: "key.pem"

policies:
  - name: "read-only"
    match:
      method: "GET"
    action: "allow"
  - name: "write-approval"
    match:
      method: "POST"
      path: "/api/write"
    action: "require_approval"

実行

flux7-mesh --config config.yaml

開発

git clone https://github.com/KTCrisis/flux7-mesh.git
cd flux7-mesh
make build

ライセンス

MIT