Quorum
Get started
Getting started

Quick start

Install the prerequisites, boot your first organization in an empty directory, and steer it from the dashboard.

You’ll go from nothing to a running organization in about five minutes. The only prerequisite is a brain for your agents — this quick start uses the Claude Code binary, the simplest default.

1. Get a brain

An agent’s brain is a pluggable agent CLI, set per agent. The default is the Claude Code binary — the quickest way to start. Install it and log in once, or provide an API key:

# Option A — use the claude CLI's own login (run it once, interactively)
claude

# Option B — provide a key the binary can use
export ANTHROPIC_API_KEY=sk-ant-...

If the claude binary isn’t on your PATH, point Quorum at it with --claude-bin <path> or the CLAUDE_BIN environment variable.

Prefer a different brain — Codex, a local model via Ollama or LM Studio (free), Gemini, a lightweight llm text brain, or one of several other agent CLIs? Any agent can run on its own. See The brain; the rest of this quick start assumes Claude.

Agents do real work — Bash, file edits, code execution — inside each agent’s own sandbox folder. Use a model and budget you’re comfortable letting run unattended. See Cost & budget.

2. Boot an org

The directory is the org. In an empty directory:

npx @meffecta/quorum

That boots the built-in default: a solo CEO with a budget who employs the rest of the team on demand. Prefer to give it a real mission and a cap up front:

npx @meffecta/quorum --mission "Build and launch a tiny SaaS" --budget 20

A brand-new org must have a mission — from --mission, a --mission-file <file>, or a QUORUM.md’s ## Mission, in exactly one of those places (naming it twice is an error). Provide none and quorum prompts for one at the terminal; with no TTY it refuses to start rather than run idle. A fresh org that doesn’t name itself gets a random two-word name (say, “Velvet Harbor”), which you can change by editing the # heading in QUORUM.md.

Install it for keeps

npx fetches Quorum on demand — ideal for a first run. If you’ll boot orgs regularly, install it once so the quorum command is always on your PATH:

npm install -g @meffecta/quorum
quorum --mission "Build and launch a tiny SaaS" --budget 20

The rest of these docs use the bare quorum command; with a global install it just works, and it skips the per-run fetch npx does.

Requirements at a glance

  • The Claude Code CLI, or an ANTHROPIC_API_KEY.
  • An empty directory. To scaffold into a non-empty one, pass --force.

The standalone binary bundles its own runtime, so it has no other dependencies.

3. Open the dashboard

🌐  Dashboard + chat: http://localhost:3000

Open it. The dashboard is where you both watch the org and talk to it. The terminal is output-only — it prints activity and takes no commands. Use --port to run on another port (handy when running several orgs at once).

4. Steer it

Everything you do to the org, you do from the dashboard:

  • Message the whole org — a directive that’s folded into the next cycle and becomes a goal.
  • Message a single agent — pick them from the dropdown; they reply in character.
  • Answer requests — when an agent needs something it can’t do itself (an account, a credential, a decision), it raises a request with yes / no / answer… buttons. Your answer is written straight into that agent’s memory.

Read more in Dashboard & steering.

5. Start bigger (optional)

Want more than a solo CEO on day one? Write a QUORUM.md in the directory before booting — it defines the whole team in one file. The full format, with a copy-paste starting point, is in QUORUM.md.

Or have Claude draft one from a plain-words brief — one call, which you review before spending anything more:

quorum init --prompt "a newsletter studio: an editor leading a writer and a researcher"

init only scaffolds — it never starts the org, so you can edit the file first.

Scaffold without spending

quorum init prepares the org home and writes a starter QUORUM.md without spending a token. Edit it — name, mission, agents — then start:

quorum init            # writes a starter QUORUM.md and the org home
# ...edit QUORUM.md...
quorum                 # boots it; never calls the LLM to load the definition

Stopping and resuming

Ctrl-C stands the org down cleanly — it kills any in-flight agent work and closes the dashboard. Boot it again in the same directory and it resumes: the board, roster, memory, and spend are all persisted files, so a restart picks up where it left off. --mission only seeds a new org; on a restart it’s ignored (with a warning) because the org already has its goal board.