kungfu-systems/kungfu

Kungfu – LLMエージェント用の耐久的作業レイヤー

何であるか

• Kungfuは、任意のLLMベースのコーディングまたは推論エージェント（例：GitHub Copilot Codex、Anthropic Claude、OpenCode、Amp、または自己ホストモデル）と並行して動作するコマンドラインツール（TUI/GUIはオプション）です。Work（目的、証拠、意思決定、状態）をチャットセッション外に記録することで、同じWorkがエージェント間の引き継ぎ、クラッシュ、切断にも耐えられるようにします。

コアコンセプト

コンセプト	意味
Project	関連するWorkアイテムをグループ化するフォルダ。Kungfuはここに隠し .kungfu/ ディレクトリを作成し、状態を保存します。
Work	単一の耐久的なタスク（例：「リリースノートの準備」）。現在の真実、進捗、必要な証拠を保持します。
Attempt	エージェントによるWorkの1回の実行。失敗しても、Workを上書きせずにログに記録されます。

動作方法

1. Kungfu経由でエージェントを起動 – kungfu run codex "Prepare the release notes"。Kungfuは選択したエージェントを起動し、プロンプトを渡し、エージェントが行ったすべての操作をAttemptとして記録します。
2. エージェントの自由な切り替え – Workが .kungfu/ に保存されているため、後で kungfu run claude を実行して、文脈を再説明せずに同じタスクを継続できます。
3. 障害からの回復 – エージェントがクラッシュしたり接続が切れた場合、次のAttemptは同じWorkを引き継ぎ、以前の証拠や意思決定を保持します。
4. 独立した完了 – エージェントが結果を提案しても、KungfuはWorkを完了と見なす前に、別途レビュー／承認ステップを必要とします。これにより、エージェントが自己承認するのを防ぎます。

主な機能

• エージェント非依存：ローカルコマンドを実行できるCLI互換の任意のLLMエージェントと連携可能。
• 決定論的モックエージェント：KUNGFU_MOCK_AGENT_SCENARIO という組み込みエージェントにより、APIキー不要で継続性と障害回復のデモが可能。
• サイドカーUI：オプションのターミナルUI（kungfu）とグラフィカルUIでProjects、Work、Attemptsを視覚化可能。
• 監査可能な証拠：各Attemptはプロンプト、応答、生成されたアーティファクトを保存し、検査やコンプライアンスに対応可能。
• セーフティガード：2つのエージェントが同時に同じWorkを書き込むのを防止。
• オープンソース標準：KFDエンジニアリング標準と、検証可能なリリースパスポートを生成するBuildchainを同梱。

インストール（macOS / Linux / Windows）

# 1行インストーラー（sudo不要、シェルプロファイル変更なし）
curl -fsSL https://kungfu.tech/install.sh | sh

スクリプトが PATH 追加を出力した後、シェルに追加するか（Windowsの場合はガイドに従う）。インストーラーは最新のAlphaリリースを取得します。

クイックスタート

# 任意のプロジェクトフォルダ内で
KUNGFU_MOCK_AGENT_SCENARIO=recovery-story kungfu   # 決定論的な3ステップデモを実行
# または本物のエージェントを実行
kungfu run codex "Write the changelog for v2.3"

隠し .kungfu/ ディレクトリが作成されます。バージョン管理から除外してください。

一般的な利用例

• 長時間実行の開発タスク：安価なLLMと高性能LLMの間で切り替えが必要な場合。
• チーム環境：複数のエンジニア（またはボット）が同じAI生成作業をコンテキストを失わず共同作業する場合。
• コンプライアンス／監査：モデルが何を生成したか、なぜそうしたかを完全かつ不変のログで記録する必要がある場合。

成熟度

• プロジェクトは Alpha（v4）段階です。macOS、Linux、Windowsで動作しますが、APIやUIはまだ変更される可能性があります。READMEにはリリースがプレリリースチャネルであると警告されており、「Alphaステータス」と「既知の制限」のドキュメントへのリンクがあります。

ライセンス

• Apache-2.0（LICENSE を参照）。

さらに学ぶには

• システム概要：docs/concepts/system-overview.md
• エージェント-ワークラボチュートリアル：docs/guides/agent-work-lab.md
• 全ドキュメントマップ：docs/MAP.md
• リリースアーティファクト：https://github.com/kungfu-systems/kungfu/releases/latest

---

Kungfuは、LLM駆動エージェントの継続性レイヤーであり、AI生成作業を通常のソフトウェアアーティファクトのように扱い、クラッシュ、エージェント間の引き継ぎ、モデルの変更にも耐えられるようにします。