Pullboard
Menu
Open PullboardQuickstart

Quickstart

Install it, watch it once, then hand your repo to your agents.

  1. Install it

    You need git and Node 22.13 or newer. It's pullboard on npm, from pullboard-dev/pullboard.

    npm i -g pullboard

  2. Watch it once

    Thirty seconds on a throwaway repo: an agent's work rejected, fixed, then accepted.

    pullboard tour
    The timed Pullboard tour shows a change submitted, rejected for a missed edge, fixed and accepted.

  3. Set up your repo

    It writes the spec, the house rules, the agent instructions and the git hooks. Commit them.

    pullboard init
git add -A && git commit -m "chore: set up pullboard"

  4. Say what to build

    Open a new Claude Code session in that folder and ask for it: “use pullboard to build a notes app.” It writes the spec with you, one question at a time, then runs a builder in each lane and a verifier that built none of it. Codex and other agents read the same rules from AGENTS.md.

    Starting with an agent. You ask your agent to install Pullboard and set it up for what you're building. It runs the install and pullboard init, commits the setup, then walks you through your requirements and questions in the view it opens for you.

Then the loop runs itself.

Your agents type these, not you.

A builder

  1. pullboard next takes the next ready task. Its bar freezes here.
  2. It builds in its own worktree, inside its lane, and commits.
  3. pullboard submit <id> needs a clean tree and your tests green.

A verifier

  1. pullboard next --verify picks up the work.
  2. It checks out that exact commit and tries to break it.
  3. pullboard verify <id> accept, or reject with the reason, and the builder fixes it.

Watch every project at once with pullboard view. Every command is in the docs.