Website · Live demo · Run it locally · Docs

Click around the live demo →

_{If Brigade is useful to you, a ⭐ on this repo helps other founders find it.}

AI teammates that run your whole company

Brigade gives you a team of AI teammates. They write your code, answer your customers, handle your marketing and
chase your leads, on the Claude or ChatGPT plan you already pay for. Every decision that needs you lands in one
list, on your phone.

Each teammate is the real Claude Code or Codex, signed in with your own account, with a job, its own
computer, the Apps you give it and a memory of how your team works. You talk to it in threads, the way you would
with a new hire.

Hand off the work. Keep the decisions.

Runs on

Claude Code

Codex

Your Claude or ChatGPT plan. We never bill you for AI usage.

Works in

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

_{Plus any MCP server, a custom app that sends webhooks, and an email address of its own for each teammate.}

Brigade is right for you if

• ✅ You build your product with Claude Code or Codex and run support, marketing and sales on your own
• ✅ You have several agent sessions open and lose track of which one does what
• ✅ You want agents that start on their own (a failed payment, a new issue, a customer's email) but ask before
  they send, charge or ship
• ✅ You already pay for Claude Max or ChatGPT Pro and don't want a second bill for AI usage
• ✅ You want to answer your teammates from your phone
• ✅ You want to read every line of the software that holds your passwords and your customers' email

Features

Problems Brigade solves

How it works

                 ┌───────────────────────────────────────────────────────────┐
  You, on the    │                      BRIGADE  (this repo)                 │
  web or your ──►│                                                           │
  phone          │  Dashboard ── API ── PostgreSQL                           │
                 │  threads · Needs you · lists · library · memory · vault   │
                 │  Apps · triggers · routines · usage and caps              │
                 └──────────────┬──────────────────────────────┬─────────────┘
                                │ WebSocket                    │ MCP tools
                 ┌──────────────┴───────────────┐     ┌────────┴──────────────┐
                 │  Runner, on your computer    │     │  Gmail, GitHub,       │
                 │  or a cloud computer         │     │  Stripe, Notion,      │
                 │                              │     │  Linear, PostHog…     │
                 │  Claude Code · Codex         │     │  any MCP server       │
                 │  browser · computer use      │     └───────────────────────┘
                 │  your repos and previews     │
                 └──────────────────────────────┘

• The dashboard and API hold the workspace: teammates, threads, tickets, the library, memory, the vault and
  the Apps. Every step a teammate takes is stored as an event, so a thread survives disconnects and replays.
• The runner links a computer to the workspace and runs each thread with the real Claude Code or Codex CLI,
  signed in with the member's own account. It strips API keys from its environment, so the work runs on the
  subscription, never on a server-side key.
• Apps reach teammates as tools. Writes can wait for a person's approval, and every call is logged.

The details are in docs/, and the choices made along the way in docs/decisions.md.

Free or Brigade Cloud

Brigade is open source under the MIT license. The whole product is in this repository: we don't gate features.

Cancel Cloud from Settings whenever you want: it stops at the end of the month you paid for, your workspace stays,
and your teammates keep working for free on your own computer.

Quickstart

Use it

Sign up at brigade.lol, create a teammate, and link your computer from
Computers: on a Mac, Brigade.app does it in one click; on Linux or macOS, copy the one-line install command
shown there. Or skip it with Brigade Cloud. Then write to your teammate.

Run it locally

With Node.js 24 (.nvmrc), pnpm and Docker:

git clone https://github.com/gmpetrov/brigade.git
cd brigade
pnpm install
docker compose up -d                       # PostgreSQL on localhost:5433
cp apps/api/.env.example apps/api/.env     # then set BETTER_AUTH_SECRET
pnpm --filter @brigade/api db:migrate
pnpm dev                                   # API :3001, dashboard :3000, collab :8787

Open http://localhost:3000, create an account, an organization and a workspace, then a teammate. To run its
threads, link this machine from Computers → Get a link code, in a shell where claude (or codex) is signed
in:

pnpm --filter @brigade/runner build
node apps/runner/dist/index.js link <CODE> --api http://localhost:3001
node apps/runner/dist/index.js start

No Docker? scripts/preview/setup.sh then scripts/preview/start.sh run everything on an embedded PostgreSQL, with
a sample workspace to sign in to (see AGENTS.md).

More in docs/development.md: Brigade.app and computer use on macOS, the theme, and the
runner's options.

Self-host

Brigade deploys two ways from one codebase: one server with Docker Compose (deploy/vps), or Cloudflare
Workers with Durable Objects, R2 and Hyperdrive. See docs/deployment-plan.md.

Repository layout

pnpm workspaces and Turborepo.

pnpm dev          # everything, in watch mode
pnpm build        # build all packages
pnpm typecheck    # type-check all packages
pnpm lint         # ESLint (the dashboard's rules of hooks)
pnpm format       # Prettier

Documentation

Brigade is built by Brigade

Most of the commits in this repository come from Brigade's own teammates, and a person makes the calls that
matter. Browse the merged pull requests:
the branches named brigade/… are theirs.

FAQ

Do I need to know how to code?

No. You describe a job in a message, the way you would to a new hire. For a task in a website or an app, take over
a teammate's cloud computer and show it once.

Which AI plans work?

Claude plans through Claude Code, and ChatGPT plans through Codex. Max or Pro gives the most room. Pick a model per
teammate, and stack several accounts of the same provider.

Why several teammates rather than one agent?

Each teammate holds one job, with its own Apps, memory and rules, so you see who did what and fix the one that is
off.

Where do my passwords go?

In your workspace's vault. When a teammate signs in to a website, Brigade types the login for it: the teammate
never sees the password.

Is my data used to train AI models?

Not by us. The work runs on the AI plan you bring, so your data goes only to the provider you picked, under the
terms of your plan.

Can my team see the work?

Yes. Invite them to your workspace: threads, lists and files are shared, so nothing sits in one person's chat
history.

Contributing

Issues and pull requests are welcome. Before opening one, run pnpm typecheck, pnpm lint and pnpm format:check, and the
tests of the packages you changed (pnpm --filter <package> test). Pull requests are squash-merged.

License

MIT © 2026 Georges Petrov. See LICENSE.

_{Open source under MIT. Built by a team of people and AI teammates, with a person making the calls.}