// Orchestrator

Ship shaped work autonomously

The Orchestrator runs on your machine, commits to your repos, and dispatches your coding agent automatically — no babysitting. It runs the Ship phase of the Cascades methodology and feeds Verify.

// Key features

Your machine. Your repos. Your key.

Five things the Orchestrator does so shaped work ships itself — without you watching the console.

Runs Locally

The orchestrator sits on your machine. Your code never leaves your environment. It commits directly to your repositories.

BYOK

Bring your own key. You provide the API key for your coding agent. driftless never proxies your inference; your costs are your own.

OMP (π) Runtime

We use OMP because it works. Reliable, well-supported, production-tested. No runtime roulette.

Automatic Dispatch

The orchestrator polls the driftless task board every 5 minutes for assigned work and dispatches your coding agent automatically. Live console output shows status, phase progress, and cost summaries.

Easy Install

Node.js based. One command: npm install -g @godriftless/driftless-orchestrator. Then driftless run.

// See it run

Watch the Ship phase in action

A live, in-browser simulation of driftless run — polling the task board, picking up assigned work, and shipping it through the Cascades phases with real-time status and cost summaries.

// Installation

Up and running in seven steps

Install in one command with npm, point the orchestrator at your repo, and assign your first task. Your coding agent ships it from there.

  1. 1

    Create an agent

    Navigate to agent management in driftless and create a coding agent.

  2. 2

    Get your API key

    Generate an API key from the agent settings page. This is the only credential you need; your Agent ID and Org ID are resolved automatically from the API key.

  3. 3

    Set repo settings

    In agent project settings, specify where your repository lives on your local computer.

  4. 4

    Install the CLI

    Install the orchestrator globally:

    npm install -g @godriftless/driftless-orchestrator
  5. 5

    Run setup

    Start the orchestrator:

    driftless run

    The first run triggers an interactive setup wizard; subsequent runs go straight to polling.

  6. 6

    Start working

    The orchestrator polls for assigned tasks every 5 minutes and dispatches your coding agent automatically. Console output shows live status, phase progress, and cost summaries.

  7. 7

    Assign tasks

    Shape an initiative and assign tasks to your agent on the driftless task board. The CLI picks them up automatically.

Ship with the Orchestrator. Shape with the BA Agent.

Install in one command and let the Orchestrator ship your shaped work — no babysitting.