Kungfu is an agent orchestration framework that keeps work persistent and continuous across multiple AI agents and execution surfaces.
The problem Kungfu solves is the friction and context loss that occurs when work transfers between different agents. Each handoff typically requires copying context, re-explaining decisions, tracking updates, and verifying what was lost. Kungfu addresses this by maintaining a durable Work object outside any individual agent session, preserving the objective, progress, evidence, next action, and completion state. This allows developers to switch between agents—Codex, Claude, OpenCode, Amp, or custom execution surfaces—without losing continuity. The tool keeps the same work moving forward regardless of which agent takes over, enabling cost optimization by using specialized agents when it matters and cheaper alternatives when it does not.
Kungfu suits teams that orchestrate multiple AI agents and need reliable handoffs between them. It is particularly valuable for projects where work spans multiple agent sessions or where cost optimization requires switching between different models. The tool maintains work continuity, verified project understanding through declared sources and decision tracking, inspectable history of what happened and why, and completion authority through independent review. Developers should expect to keep the `.kungfu/` project-local workspace for durable work and runtime state, though most contents remain local and Kungfu does not automatically stage or commit files. The framework currently requires a real agent for independent review to complete end-to-end workflows, though the built-in Mock Agent can demonstrate work creation and recovery without external credentials.
The project is in Alpha and provides deterministic recovery scenarios to test local continuity and failure handling. Installation is available for macOS and Linux through a per-user installer that does not require sudo or shell profile modification, with Windows and higher-assurance installation options documented separately. The tool includes optional TUI and GUI views for managing projects and work across agent sessions, though these are sidecars rather than requirements for basic operation.
