Cezar - orchestrate hundreds of AI coding agents, 24/7.

Demo · Quick start · Docs · Issues

English | 简体中文 | 繁體中文

One control center for Claude Code, Codex, OpenCode and other coding agents.
Run agents locally or on a VPS, automate multi-step workflows,
and let them keep working while you're away.

▶ Watch the video: Meet cezar, your new parallel coding tool.

Features

• 💯 Free and open source.
• 🖥️ Uses your own claude, codex, opencode or pi login. No API key needed.
• ☁️ Easy to set up on a VPS, so your agents keep working when your laptop is closed.
• 📱 Fully responsive. Start and review tasks from your phone.
• 🔀 Every task gets its own git worktree, so several agents can work at the same time. Extra tasks wait in a queue.
• 🤖 Turn on Autonomous and a run never stops to ask. It just finishes.
• 📡 Watch it work live: agent text, tool calls, tokens and cost.
• 🏁 Run the same task ×2 or ×3, compare the diffs and keep the best one.
• 🧩 Skills are Markdown files and workflows are short YAML files. Mix agents per step.
• 🐙 Run the agent straight on a GitHub issue. Nothing merges on its own.
• 📂 One cockpit for all your projects.
• 📊 A workspace dashboard shows what needs you, what is running and what finished across your projects.
• 💸 Track reported cost and token usage by project in Usage & cost.
• ⏰ Schedule recurring work or launch tasks from GitHub and supported tracker events with Automations.
• 🌳 Agents can delegate independent work to child tasks, each in its own worktree, and receive their reports in the parent session.
• 🎫 Connect Jira or Linear to browse issues and launch tasks from your project tracker.
• 💾 No database. Everything is saved as plain files in .ai/cezar/.

Screenshots

Parallel tasks — Run and queue many tasks, each in its own git worktree.

Live run — Every step, tool call and token, as it happens.

Variants — Run a task ×2 or ×3 and keep the best diff.

Workflows — Drag skills and checks into a chain, saved as YAML.

GitHub — Hand an open issue to the agent in one click.

Skills + Autonomous — Pick a playbook, flip Autonomous and walk away.

Dashboard — See what needs your input or review, what is running and what finished across your workspace.

Usage & cost — Compare reported spend and token usage across projects.

Automations — Schedule maintenance and reviews, and see the week ahead alongside GitHub triggers.

On your phone — the same cockpit, from the task list to the diff.

Quick start

You need Node 20+ and at least one agent CLI you're logged into: Claude Code, Codex, OpenCode, Cursor Agent or pi. git and gh are optional.

cd your-repo
npx cezar-run

This opens the cockpit at http://localhost:4321. Type a task, pick a workflow, then hit Start. npx cezar-cli still works too — it's the same package under its older name.

npx cezar-run run "add a --json flag to the export command"   # headless, no browser
npx cezar-run init                                            # scaffold .ai/cezar/
npx cezar-run@nightly                                         # try tonight's build

Just want to look around? Run CEZ_DRY_RUN=1 npx cezar-run. It uses a built-in mock agent, so you don't need to log in.

Run it on a server

npx cezar-run server-install --platform ubuntu-vps

This sets up HTTPS, a login and a system service, so you can open the cockpit from anywhere, including your phone. There are guides for Ubuntu VPS and macOS + ngrok.

How it works

1. You describe a task. Type it, attach files, or start from a GitHub issue.
2. cezar runs a workflow (agent steps plus shell checks) in a new git worktree, using your agent CLI.
3. The cockpit streams every step live. If a check fails, the agent tries again and sees the error.
4. You check the result. Read the diff, send notes back, or open a draft PR.

A workflow is a small YAML file in .ai/cezar/workflows/:

name: fix-and-verify
steps:
  - id: implement
    prompt: "{{task}}"
    skill: project-conventions   # optional: a Markdown skill from .ai/skills
    runner: codex                # optional: which agent runs this step
  - id: verify
    command: "npm test"          # exit 0 = pass
    onFail: { retry: implement, max: 2 }

The built-in quick-task workflow runs with no setup.

Automations

Turn repeatable work into an automation: check dependencies every morning, draft release notes on Fridays, or review each new pull request. Each match or scheduled occurrence launches an ordinary cezar task with the workflow and agent you choose.

Create one in Automations, or ask the agent to set it up from a prompt. Preview event filters before enabling them. The list shows triggers, upcoming runs and recent outcomes; pause an automation whenever you need to.

Task dispatch

For independent pieces of work, an agent can dispatch child tasks — for example, changes in separate modules or a fresh review of a finished branch. Each child gets its own worktree, appears under its parent in the task list and reports back into the parent session. cezar limits a parent to four children in flight; when a parent has a budget, its children share that budget. Nothing auto-merges.

Documentation

The reference covers everything else: configuration, environment variables, agent backends, multiple projects, remote access and local development.

Contributing

• Found a bug or missing something? Open an issue.
• Want to contribute? PRs are welcome. See local development to get started:

git clone https://github.com/open-mercato/cezar.git && cd cezar
npm install
npm run dev

License

MIT © Patryk Lewczuk. Full text in LICENSE.

Jira and Linear

Connect a project issue tracker in Settings to browse issues, launch workflows and configure event automations. See setup, permissions and recovery.