Skip to main content
← back to extensions

Buildq

@reset/buildqv2026.10.21.1· MIT· 1d agoBEHAVIORSACCEPTED WARNINGS
01README

Drive a buildq coordinator through its HTTP API, in Buildkite's shape: list and read builds, read a job's log tail, artifacts and annotations, the queue and the agents, and rebuild, cancel and unblock builds, each written as a resource a workflow can assert on.

02Behaviors1
@reset/buildqv2026.10.21.1buildq.ts
fn builds(branch?: string)
List the repository's builds, newest first, filtered by
ArgumentTypeDescription
branch?stringOnly builds of this branch.
fn build()
Read one build by number. Writes build-<number> and
fn log()
Read a job's log and keep its last KiB as a file.
fn artifacts()
List what a build's jobs kept. Writes artifacts-<number>.
fn annotations()
List the notes a build's jobs left, errors first.
fn queue()
Read the jobs agents hold and the jobs waiting, across
fn agents()
Read every agent the coordinator knows, with its state
fn org-builds()
List an organization's newest builds across its
fn rebuild()
Rebuild a build: a new build with the next number. Needs
fn cancel()
Cancel a build. A build that has already ended is left
fn unblock(job: string)
Answer a build's block with a value per field. Needs the
ArgumentTypeDescription
jobstringThe block's job id, such as 13.2.

Resources

builds(infinite)— Builds of the repository, newest first, with the filters
build(infinite)— One build with its jobs and their phases, written by
summary(infinite)— A build reduced to what a workflow asserts on: state,
artifacts(infinite)— What a build's jobs left in out/artifacts/, with URLs
annotations(infinite)— The notes a build's jobs left, errors first
logtail(30d)— How much of a job's log the log file beside it keeps,
queue(7d)— Jobs agents hold and jobs waiting, with why each waits
agents(7d)— Every agent the coordinator knows, with its tags, state
orgbuilds(infinite)— An organization's newest builds across its pipelines

Files

log(text/plain)— The last KiB of a job's log, cut to whole lines
03Stats
A
100 / 100
Downloads
1
Archive size
26.0 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned
Repository
https://github.com/reset/swamp-extensions

05Platforms
06Labels
#buildq#ci#buildkite#continuous-integration