AI can generate the pieces.
Festival keeps the work coherent.

A system for managing long-running AI-assisted work across months of decisions, context, artifacts, reviews, and next actions.

Install FestivalSee how it works
Multi-project
campaigns at scale
Structured
phases → sequences → tasks
Any AI
Claude, Codex, OpenCode
~/my-startup
$

How it works

Two CLI tools. One install. Works with any AI agent.

01Organize

Create a campaign workspace

One command gives you a structured workspace that holds all your projects, plans, docs, and AI research in one place. Shell integration with cgo lets you navigate instantly.

~
$camp init my-startup -d "AI startup" -m "Ship fast"
✓ Campaign Initialized
Festivals: initialized
$cd my-startup
my-startup/ ├── projects/ # your code repos (git submodules) ├── festivals/ # structured plans │ ├── planning/ │ ├── active/ │ └── dungeon/completed/ ├── docs/ # your documentation ├── workflow/ # design docs, intents, reviews └── .campaign/ # workspace config
$camp project add https://github.com/you/api-service
✓ Added project: api-service
Path: projects/api-service
# instant navigation with shell integration
$cgo p api
~/my-startup/projects/api-service
$cgo f
~/my-startup/festivals
# switch between campaigns
$csw my-startup
✓ Switched to: my-startup
02Plan

Structure work into festivals

Festivals are goal-oriented plans broken into phases, sequences, and tasks. Each task is a detailed work unit an AI agent can execute autonomously, with exact requirements, file paths, and verification steps.

~/my-startup/festivals
$fest create festival --name auth-system --type standard --goal "Implement user auth"
✓ Created festival: auth-system-AS0001 (planning)
ID: AS0001
Type: standard
✓ Auto-created 2 phase(s): 001_INGEST, 002_PLAN
auth-system-AS0001/ ├── FESTIVAL_GOAL.md # what success looks like ├── FESTIVAL_RULES.md # quality contract ├── FESTIVAL_OVERVIEW.md # systems & features ├── TODO.md ├── fest.yaml ├── gates/ │ └── implementation/ # 4 quality gate templates ├── 001_INGEST/ │ └── PHASE_GOAL.md └── 002_PLAN/ └── PHASE_GOAL.md
$fest validate
✓ Structure valid. 37 markers to fill before execution.
03Execute

fest next: the agent loop

One command tells any agent exactly what to do next, with full context. The agent works, marks the task complete, commits with tracking, and gets the next task. No context window wasted on re-explanation.

~/my-startup/festivals/active/auth-system-AS0001
# the core loop: one command, full context
$fest next
━━━ Next Task ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Phase: 003_IMPLEMENT
Sequence: 01_backend_auth
Task: 01_create_user_model.md
Create PostgreSQL users table and Sequelize model with email, password_hash, created_at, updated_at.
# agent executes autonomously, then:
$fest task completed
✓ Task marked complete
$fest commit -m "implement user model"
✓ Committed [OBEY-FE-AS0001]
$fest next
→ Next task loaded. Agent continues autonomously.
04Scale

Track progress across everything

Multiple festivals running in parallel, across multiple projects, with different agents. fest status shows where everything stands. Any agent, any session, picks up exactly where you left off.

~/my-startup
$fest list
ALL FESTIVALS
─────────────────────────────────────────
Total 3
ACTIVE Festivals (2)
─────────────────────────────────────────
auth-system-AS0001 [62%]
payments-v2-PV0001 [45%]
PLANNING Festivals (1)
─────────────────────────────────────────
search-rewrite-SR0001 [0%]
# watch progress in real time
$fest show --inprogress --watch
# new agent session? picks up instantly
$fest next
→ 003_IMPLEMENT/02_frontend_login/03_form_validation.md
Full context in the task. No re-explaining needed.

Festival is for AI-assisted work that has to stay coherent for months or years

Not one prompt. Not one chat. Not one coding session. Long-running work has changing goals, decisions, artifacts, reviews, next actions, and context. AI can generate pieces of the work, but it does not preserve the structure needed to finish the whole thing. Festival keeps that structure intact.

Ambitious builds fall apart without a plan

Festival breaks complex goals into phases, sequences, and tasks. Every step is structured and scoped for AI execution.

Multi-project coordination is chaos

Campaigns give you one workspace for all your repos, docs, and plans. cgo navigates instantly. Nothing bleeds between projects.

Agents lose context between sessions

All state lives in the filesystem. fest next gives any agent the full picture, any time, no re-explaining.

Scaling past one feature at a time

Run multiple festivals in parallel across projects. Track progress, enforce quality gates, and ship at scale.

Works with any AI agent

Claude CodeCodexOpenCodeAny CLI agent

Structure the ambition. Let AI ship it.

# macOS (Homebrew)
$brew install --cask Obedience-Corp/tap/festival
# npm / pnpm / bun, any OS
$npm install -g @obedience-corp/festival
Install FestivalQuick Start Guide

Free to use. Works in 30 seconds.