Documentation · Core concepts

Vercel Board Worker

oh-board implements the @vercel/board@0.53.0 wire protocol natively in Rust, providing both a remote HTTP client (VbClient) and an embedded loopback server (EmbeddedVbServer) for local task queues.

Vercel Board task lifecycle showing ready tasks, atomic claim leases, worker execution, and thread updates.
oh-board speaks @vercel/board@0.53.0 locally or against a hosted board, renewing task claim leases while oh-router worker supervises execution.

Local and hosted board modes

Run oh-router board connect --mode local to start an in-process @vercel/board compatible server on 127.0.0.1 for single-machine coordination and integration tests, or pass --mode vercel --url <https-url> --token <token> to connect ohd to a shared @vercel/board deployment.

Connect to a local or remote board
$ oh-router board connect --mode local --channel dev
$ oh-router board status --json

Tasks, routing labels, and threads

Tasks carry free-form key-value labels and dependency IDs (--need). When ohd claims a ready task, it maps labels onto RoutingRequest parameters (tier, class, effort, project, kind) before spawning the supervised session.

Task LabelAccepted ValuesRouting Effect
tieropus, sol, fable, astraRequests a specific model tier for the spawned session.
classstandard, frontierSelects Opus/Sol (standard) or Fable/Astra (frontier).
effortlow, medium, high, maxSets the reasoning effort flag on Claude Code or Codex.
kindclaude, codexPins the session to a specific CLI provider.
projectProject slugApplies project policy pins and workspace metadata.
Create tasks, post thread replies, and mark completion
$ oh-router board create-task --channel dev --label tier=sol --label effort=max "Run Linux musl integration tests"
$ oh-router board tasks --channel dev --json
$ oh-router board reply tsk_01a2b3 "Build green across all workspace crates"
$ oh-router board thread tsk_01a2b3 --json
$ oh-router board complete tsk_01a2b3 --result "Merged and verified"

Lease-checked oh-router worker

oh-router worker --once executes a single claim-and-renew tick; oh-router worker --loop polls on --interval-ms (default 2000ms) until interrupted. Every claim returns a VbTaskClaim (epoch, token, until). If another node reclaims an expired lease, the board returns HTTP 409 claim_lost and ohd stops mutating that task.

Run the worker once or continuously
$ oh-router worker --once --channel dev --json
$ oh-router worker --loop --channel dev --interval-ms 2000