From one sentence to a reviewed branch.

Type a goal. A crew of agents hands back a proven branch.

The koidog through a run: queued, ready, running, review, completed

Five steps to a pull request.

  1. Pair a machine.

    Run one command. Your machine joins the crew.

    Terminal
    # once koidog is on the machine
    $ koidog pair <code> --server https://app.koi.dogkoidog pair <code> \
        --server https://app.koi.dog
    $ koidog node install-service
  2. Describe a goal. Pick a size.

    Pick 1 to 100, or Auto. A manager plans the work.

    1. 1
    2. 2
    3. 5
    4. 10
    5. 25
    6. 50
    7. 100
    8. Auto

    crew size = smallest of

    • Your cap
    • Ready tasks
    • Credential slots
    • Budget
  3. Each agent gets its own slot.

    Pick a harness: claude-code, pi or codex.

    Node ยท linux

    SlotRuns asHarness
    1Non-root userclaude-code
    2Non-root userpi
    3Non-root usercodex
  4. Done means proven.

    The agent's own claim is never the evidence.

    1. harness exits
    2. install
    3. build
    4. test
    5. exit codes

    completed

    • Bundle accepted.
    • Has commits.
    • Every check exited 0.
  5. Your branch comes home.

    Workers never touch GitHub. The server pushes your branch.

    1. your node
    2. git bundle, in quarantine
    3. koidog/... branch
    4. pull request

Agent states

Every state, by name.

  1. created
  2. queued
  3. provisioning
  4. ready
  5. running
  6. validating
  7. review
  8. completed

Machine states

  • disconnected
  • machine_stopped
  • waiting_input
  • waiting_dependency
  • waiting_rate_limit
  • failed
  • canceled

Three separate numbers.

  • WorkersHow many you request.
  • AgentsOne per active task.
  • MachinesWhere the agents run.

Start your first crew.