AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompare
Home/
Dev Tooling/
kungfu
kungfu logo

kungfu

Active·★ 4.5k·Apache-2.0·Updated 2026-10-22

Kungfu targets the cost of switching coding agents: copying context, re-explaining decisions and checking what got lost. It keeps a Work outside any agent session, recording objective, progress, evidence, next action and completion state, under a Project. Each agent run is an Attempt recorded under that Work, including failures, so a disconnect or crash does not erase what happened.

You can stay inside your current agent and ask it to run kungfu agent brief, or start one through Kungfu with kungfu run codex, claude, opencode or amp and keep its native console. Kungfu stops a second live agent from writing to a Work another one owns, and it separates finishing from approving: an agent produces a result and evidence, while independent review and Kungfu settlement decide completion. A deterministic mock agent demonstrates the recovery path without provider keys.

The project is labelled Alpha and the README says regular onboarding still needs a real agent for independent review. It stores state in a project-local .kungfu/ directory that should not be deleted or committed wholesale. Optional TUI and GUI views show Work across sessions.

© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.

Guides

This write-up is based on the project's README and public repository data. We have not hand-tested the tool.

#agent-handoff#durable-work#codex#claude-code#opencode#cli#agent-orchestration
$ Install
$ curl -fsSL https://kungfu.tech/install.sh | sh
↗ Visit site★ GitHub
01

Features

01Project, Work and Attempt model that keeps durable state outside the chat
02kungfu run codex|claude|opencode|amp starts an agent with its native console while Kungfu tracks the Work
03Recovers the same Work after disconnects and crashes, with a deterministic mock-agent demo
04Blocks a second live agent from writing to a Work it does not own
05Completion requires independent review and settlement, not the agent's own claim
02

Why choose it

+Lets you switch to a cheaper or different agent mid-task without re-explaining context.
+Failed or crashed attempts stay recorded under the same Work instead of disappearing.
+An agent cannot mark its own work complete; completion goes through independent review.
03

Trade-offs

!Alpha software: the README itself says the end-to-end path still needs a real agent for review.
!Adds its own concepts (Project, Work, Attempt, settlement) that take time to learn.
!The .kungfu/ workspace needs care with Git so local state is neither lost nor committed.
04

Maintenance check

ActiveChecked: 2026-10-23
Last commit
2026-09-09
Commits, last 90 days
100+
Releases, last 90 days
11
Latest release
v4.0.0-alpha.5 (2026-09-03)
Open issues
98
Recent issues with at least one comment
0/1
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 241, 260, 131, 95, 135, 23, 0, 0, 0, 0, 0, 0

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

05

Compatibility

Codex
kungfu run
Verified via docs
Claude Code
kungfu run
Verified via docs
OpenCode
kungfu run
Verified via docs
macOS / Linux
CLI
Verified via docs
06

Quick start

1
$ curl -fsSL https://kungfu.tech/install.sh | sh
07

Use cases

↳Switching between a premium and a cheaper coding agent on the same task
↳Keeping long-running work resumable across context loss and restarts
↳Making agent work auditable with evidence and a reviewed completion step
08

Alternatives

⚡Top VS:
VSoh-my-hermes★3.6k→VSagent-bridge★404→VSagentpack★18→

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs04Maintenance check05Compatibility06Quick start

Most discussed open issues

  • #2936 [Buildchain contract] kungfu-systems/kungfu drift on v3-alpha6 comments · 2026-08-11
  • #2844 [Buildchain contract] kungfu-systems/kungfu drift on v34 comments · 2026-08-10
  • #3546 Dev verify patrol: dev/v4/v4.0 verify is failing3 comments · 2026-08-29

Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.

VS
md2wechat-skill
★3.7k
→
oh-my-hermes logo
oh-my-hermes★ 3.6k
The packages for Hermes Agent ⚚ skills, coding harness, long-term memory, model optimized subagent & bot team workflows
VSCompare→
agent-bridge logo
agent-bridge★ 404
A local bridge for bidirectional collaboration between Claude Code and Codex. 连接 Claude Code 与 Codex 的本地实时协作桥接工具。
VSCompare→
agentpack logo
agentpack★ 18
Local task-state ledger for AI coding agents. Preserve decisions, source conclusions, evidence, and checkpoints across Codex, Claude Code, Cursor, and other MCP clients.
VSCompare→
md2wechat-skill logo
md2wechat-skill★ 3.7k
Markdown to WeChat CLI | 一键排版发布到微信公众号:支持 40+ 排版样式和专业主题 、AI 配图 、批量发布
VSCompare→
awesome-ai-plugins logo
awesome-ai-plugins★ 830
A curated list of awesome plugins for AI assistants including Claude Code, OpenAI Codex, Gemini, OpenCode and More.
VSCompare→
Graft logo
Graft★ 10.7k
Turbocharge Claude Code, Cursor, Codex, Gemini & every coding agent: faster, cheaper, with contextual understanding specific to your codebase.
VSCompare→
gograph logo
gograph★ 230
A fast, local-only CLI tool to generate repository structures and improve IDE context awareness for Go codebases.
VSCompare→
pfc-mcp logo
pfc-mcp★ 219
MCP server and bridge runtime for ITASCA PFC
VSCompare→
See all alternatives →
07
Use cases
08Alternatives
kungfu-systems /
kungfu
↗

A local work layer that keeps one task's state, evidence and next step intact as you switch between Codex, Claude, OpenCode and Amp

4.5kApache-2.0
Last commit1d ago
StatusActive
CategoryDev Tooling
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit