🎯 Agile Studio

Run an entire Agile/Scrum software team on Claude Code — orchestrated from a web dashboard and controlled from your phone via Discord.

PM → BA → Solution Architect → Dev → QC → PO — six AI role‑agents that plan, design, build, test and sign‑off a feature. In parallel. On your own repos. With your own Claude subscription.

Note

Agile Studio is an orchestrator for the official Claude Code CLI. It is not affiliated with Anthropic. It spawns headless claude processes using your logged‑in accounts — no API keys, no token copying.

✨ Why Agile Studio?

Claude Code is amazing at one task in one terminal. Real software work is a pipeline with different hats — someone writes the PRD, someone analyses requirements, someone designs, someone codes, someone tests, someone accepts.

Agile Studio turns that pipeline into a visual, controllable machine:

🧑‍💻 6 role‑agents, one feature — each role reads the previous role's docs and produces its own, following a standard doc structure distilled from a real project.
🖥️ n8n‑style dashboard — watch every node work in real time (reading/writing files, running builds), run many features in parallel like multiple Claude Code tabs.
🔴 Live mode (just like Claude Code in VS Code) — type a follow‑up while an agent is still working and it's injected into the same conversation, full context preserved.
👥 Multi‑account with auto‑switch — add several Claude accounts, and when one hits its 5‑hour quota the run hops to another account mid‑flow and keeps going (conversation restored).
🤖 Discord bot — start features, queue instructions, pause/resume, switch accounts, schedule runs and get push notifications — all from your phone.
⏰ Scheduling — run a feature once at a time, every day, or on an interval.
💰 Cost & time tracking, ♻️ token‑saving economy mode, 💾 persistent sessions that survive restarts.

🧩 How it works

flowchart LR
    R[📋 Requirement] --> PM
    subgraph Pipeline
      PM[🎯 PM<br/>PRD + plan] --> BA[📋 BA<br/>analysis]
      BA --> DA[🏗️ Architect<br/>design]
      DA --> DEV[💻 Dev<br/>code + tests]
      DEV --> QC[🔍 QC<br/>test report]
      QC --> PO[✅ PO<br/>acceptance]
    end
    PM & BA & DA & DEV & QC & PO -.->|read/write| DOCS[(project docs)]
    SKILL[(.skill/ library<br/>learns each run)] -.-> Pipeline

Each node = one headless claude process (claude -p) running in your repo, with a role‑specific prompt injected from the shared skill library (.skill/).
Roles hand off through markdown docs on disk (PRD, analysis, architecture, feature specs, checklists, QC reports, acceptance records) — so context survives even across process/account switches.
Pick a mode (full, refine, build, devtest, harden, …) or toggle individual nodes — e.g. "just Dev + QC for this one".

📸 A look inside

Sessions — parallel runs, the 6-node pipeline, queue follow-ups & live log.	Docs — the shareable `.skill/` library + each project's generated docs.
Schedule — run a feature once, daily, or on an interval.	Requirements — capture customer asks, then one-click Analyze → feature.

🚀 Quick start

Prerequisites

Node 22+ and Yarn 4 — the repo ships Yarn in .yarn/releases, so running yarn inside the project just works (no global install; corepack enable also picks it up).
Claude Code CLI in your PATH (claude --version), logged in (claude → /login).
A Claude Pro/Max subscription (uses your normal login — no API key).

git clone https://github.com/<your-username>/agile-studio.git
cd agile-studio
yarn install

yarn dev           # backend :4311 + web :5311 (+ Discord bot if configured)
# open http://localhost:5311

yarn dev:web runs only the dashboard (no Discord bot).

First run

+ Project → pick the repo folder (native folder picker on macOS/Windows/Linux).
＋ Run feature → give it a title + description, choose a mode/nodes, hit run.
Watch the nodes light up. Click a node or open Log session to see exactly what it's doing.

🐳 Run with Docker

One container, one port. The image ships Node, the Claude Code CLI, Python + python-docx (for .docx export) and git — nothing to install on your machine but Docker.

cp .env.docker.example .env    # then set CLAUDE_DIR and REPOS_DIR to real paths
docker compose up -d --build
# open http://localhost:4311

Three things get mounted from your machine:

Mount	What it is
`CLAUDE_DIR` → `/home/node/.claude`	your Claude Code login — no token is ever baked into the image
`REPOS_DIR` → `/repos`	the folder holding the repos Studio may read and write
`studio-data` (named volume)	projects, sessions, logs — survives `down`, only `down -v` wipes it

Add projects as /repos/<repo-name> — paths inside the container are not your host paths. The native folder picker has no dialog to open inside a container, so type the path instead.

On macOS the CLI keeps credentials in the Keychain, not in ~/.claude, so the mount carries nothing: run docker compose exec studio claude and /login once. The credential lands in the named volume and stays there.

The port is published on 127.0.0.1 on purpose: Studio runs arbitrary commands on your repos with your Claude login and has no user authentication. Don't expose it to your LAN.

🤖 Discord bot (optional but delightful)

Control everything from your phone — no port‑forwarding needed (the bot dials out to Discord).

Create a bot at the Discord Developer Portal → enable Message Content Intent → invite it to your server.

Create bot.config.json in the project (git‑ignored):

{
  "discordToken": "YOUR_BOT_TOKEN",
  "channelId": "NOTIFICATION_CHANNEL_ID",
  "mentionUserId": "YOUR_USER_ID_FOR_@PINGS",
  "api": "http://localhost:4311",
  "prefix": "!"
}

yarn dev (or yarn bot).

Slash commands (with autocomplete): /run · /sessions · /detail · /queue · /resume · /pause · /schedule · /accounts … Buttons & modals: tap ▶ Run feature on a project, fill in a form, and a session starts. Every notification carries ⏸ Pause / ▶ Resume / 🗑 Delete buttons. Turn on 📡 stream log to pipe a session's live activity into its own Discord thread (so sessions never mix).

See BOT.md for the full command reference.

🔥 Feature tour

Area	Highlights
Sessions	Parallel runs · live activity per node · queue follow‑ups · pause (kills the whole process tree) · resume · persistent across restarts
Live mode	`--input-format stream-json` keeps one process alive so you can inject messages mid‑run; auto‑switches account on rate‑limit and restores the conversation on the new account
Accounts	Add via in‑app OAuth login (paste the code) · enable/disable · set default (⭐) · live usage % · auto re‑login when a token expires
Requirements	Add customer requirements + file uploads, mark resolved, one‑click Analyze → auto‑draft a feature
Skill library	`.skill/.md` role playbooks that learn* after every feature — new projects inherit them
Docs	Tree view + search + editor for the skill library and each project's generated docs
Scheduling	Once / daily / interval — from the web ⏰ Schedule tab or `/schedule`
Saving	Per‑node budget cap ($), economy mode (skip nodes whose docs already exist), cost & duration tracking
Notifications	Desktop, Slack & Discord webhooks + Discord bot @pings on done/error/quota

⚙️ Configuration

What	Where
Projects, sessions, requirements, schedules, settings	`~/.agile-studio/studio.json` (auto‑created)
Extra Claude accounts	`~/.agile-studio/accounts.json` + `~/.agile-studio/accounts/<id>/` (created by the in‑app login)
Skill library	`<project>/.skill/*.md` (git‑friendly, shareable)
Discord bot	`bot.config.json` (git‑ignored)
Defaults (model, economy, budget, webhooks, switch threshold)	⚙ Settings in the UI → `studio.json`

🏗️ Architecture

web (React + Vite, :5311)  ──HTTP/WebSocket──▶  server (Express + ws, :4311)
                                                 ├─ runner.js   spawn `claude -p` / stream-json, kill process trees
                                                 ├─ accounts.js read usage %, pick/switch account, OAuth login
                                                 ├─ scaffold.js skill library + role prompts + doc workspace
                                                 └─ store.js    JSON persistence (~/.agile-studio)
Discord bot (discord.js)   ──HTTP/WS──▶  same server API

Everything is plain Node + a JSON file — no database, no cloud, runs entirely on your machine.

⚠️ Good to know

Running 6 agents (× multiple sessions) uses a lot of tokens. Auto‑switch spreads load across accounts; it doesn't create quota.
macOS stores Claude credentials in the Keychain; Linux/Windows in ~/.claude/.credentials.json. Agile Studio reads each account only from its own config dir (never borrows another account).
Agents run with --dangerously-skip-permissions so Dev/QC can actually build & test (toggle in Settings). Use on repos you trust.
The UI is currently Vietnamese; i18n PRs very welcome. 🙌

🗺️ Roadmap

Auto Git: branch + commit + PR when a feature is done
English / i18n UI
Per‑role model & permission profiles
Daily summary + cost analytics
One‑click "requirement → full pipeline"

🤝 Contributing

Issues and PRs are welcome — bug fixes, i18n, new modes, better docs. Keep changes focused and match the existing style.

License

MIT — do whatever you like, attribution appreciated. (Add a LICENSE file with the MIT text before publishing.)

Built with ❤️ on top of Claude Code. If this saved you time, a ⭐ helps others find it.

Name		Name	Last commit message	Last commit date
Latest commit History 30 Commits
.claude		.claude
.github/workflows		.github/workflows
agile-studio		agile-studio
docs		docs
.DS_Store		.DS_Store
.env.docker.example		.env.docker.example
.gitignore		.gitignore
README.md		README.md
compose.yaml		compose.yaml
yarn.lock		yarn.lock

Navigation Menu

Repository files navigation

🎯 Agile Studio

Run an entire Agile/Scrum software team on Claude Code — orchestrated from a web dashboard and controlled from your phone via Discord.

✨ Why Agile Studio?

🧩 How it works

📸 A look inside

🚀 Quick start

🐳 Run with Docker

🤖 Discord bot (optional but delightful)

🔥 Feature tour

⚙️ Configuration

🏗️ Architecture

⚠️ Good to know

🗺️ Roadmap

🤝 Contributing

License

About

Releases

Packages

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

🎯 Agile Studio

Run an entire Agile/Scrum software team on Claude Code — orchestrated from a web dashboard and controlled from your phone via Discord.

✨ Why Agile Studio?

🧩 How it works

📸 A look inside

🚀 Quick start

🐳 Run with Docker

🤖 Discord bot (optional but delightful)

🔥 Feature tour

⚙️ Configuration

🏗️ Architecture

⚠️ Good to know

🗺️ Roadmap

🤝 Contributing

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages