bk - The Buildkite CLI

A command line interface for Buildkite.

Full documentation is available at buildkite.com/docs/platform/cli.

Quick Start

Install

brew tap buildkite/buildkite && brew install buildkite/buildkite/bk

Or download a binary from the releases page.

Authenticate

bk auth login

Feedback

We'd love to hear any feedback and questions you might have. Please file an issue on GitHub and let us know!

Development

This repository uses mise to pin Go and the main local development tools.

git clone git@github.com:buildkite/cli.git
cd cli/
mise install
mise run build
mise run install
mise run install:global
mise run hooks
mise run format
mise run lint
mise run test
mise run generate
go run main.go --help

• mise run build builds bk into dist/bk, stamped with git describe
• mise run install installs bk into $(go env GOBIN) or $(go env GOPATH)/bin
• mise run install:global installs bk into ~/bin/bk

mise.toml pins Go 1.26.1 to match the current release build image. The module itself remains compatible with Go 1.25.0 as declared in go.mod.