| name | buildkite-cli |
| description | Use the bkci CLI to query Buildkite builds, logs, artifacts, and token scope status with LLM-friendly JSON output. |
Buildkite CLI (bkci)
Use this skill when you want CI data from Buildkite through the bkci utility.
This is a good default when you need structured JSON output that is easy for agents to parse.
Install from local checkout
For now, install from a local clone and link it:
git clone https://github.com/PSPDFKit-labs/buildkite-cli <buildkite-cli-dir>
cd <buildkite-cli-dir>
pnpm install
pnpm run build
npm link
Verify:
bkci --help
After pulling updates, rebuild:
pnpm run build
Authentication
Set one of these env vars before calling bkci:
BUILDKITE_TOKEN
BUILDKITE_API_TOKEN
BK_TOKEN
If no env token is set, auth can be configured interactively:
bkci auth setup
This writes ~/.config/buildkite-cli/auth.json with strict permissions.
Agent safety rule
- Do not run
bkci auth setup automatically.
- If
bkci auth status reports missing token/auth, stop and ask the user to run auth setup manually.
- Do not pass token values in command arguments unless the user explicitly requests it.