Festival
<p align="center"<a href="https://github.com/Obedience-Corp/festival"<img src="https://img.shields.io/github/stars/Obedience-Corp/festival?style=social" alt="Star Festival on GitHub"</a</p
AI can generate the pieces.<brFestival keeps the work coherent.
Hand off a goal, approve the plan, and focus on other work while your agent runs. Come back to results you can trace through the plan, decisions, checks, and commits that produced them.
Festival is an operating environment for long-running agent work. It keeps the context and progress in files and Git, so the work can continue across sessions, agents, and months or years of development.
Use it with Claude Code, Codex, Grok Build, Cursor, OpenCode, or another agent that can read files and run commands. Your agent calls fest next for its next step, does the work, and records the result.
Get started · Explore the demos · Video quick start · Website · Discord · 简体中文
Four days of agent work, alongside everything else
In the camp-hardening festival, agents worked on safeguards against data loss in the Camp CLI over four days while the operator did other work in parallel. The saved plan and progress let the next agent continue the same work after a tool change. The resulting safeguards for project removal and worktree cleanup were reviewed and merged.
Drafted by Fathom. Execution started with Grok, finished with Codex.
<p align="center" <img src="docs/images/fest-show.gif" alt="Historical progress replay of the camp-hardening festival: phases and tasks change status as the work advances." width="440" </p
This is a replay of the festival's recorded progress, not a CLI recording. Read the actual plan and work record.
Try your own handoff, or star this repository to keep it handy.
What would you hand off?
Start with a real outcome that you can review. For example:
- A feature across repositories: “Add account deletion to the API and web app. Cover it with tests and document how existing users are affected.”
- An investigation before a build: “Investigate why this service slows down under load. Save the evidence, compare the options, and bring me a recommendation before changing production.”
- A recurring review: “Review this week's dependency changes, flag compatibility risks, and prepare the updates for my approval.”
The goal, constraints, and success criteria come from you. Your agent works through the plan and returns when it reaches a review point or a decision that needs you.
Explore the use cases · See example camps and festivals