Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



57 Commits

Repository files navigation

circleci-cli Circle CI Go Report Card

Command line utility for interacting with CircleCI.

Allows you to list recent builds, projects, retry builds, and more!

Demo video

Currently in alpha stages so the interface may change. Feedback and feature requests are welcome! Install and run circleci-cli -h to see current help documentation.

The CircleCI HTTP API response schemas (which this utility uses) are not well documented so please report any issues you witness


OS X (64 bit)

curl -sL > circleci-cli
sudo mv circleci-cli /usr/local/bin/
sudo chmod +x /usr/local/bin/circleci-cli

Linux (64 bit)

curl -sL > circleci-cli
sudo mv circleci-cli /usr/local/bin/
sudo chmod +x /usr/local/bin/circleci-cli

See the releases page for additional platforms.

Set $CIRCLE_TOKEN to an API token (you can generate one under your account settings). Consider adding this to your ~/.profile or shell equivalent.

Alternatively, install the latest via: GOVENDOREXPERIMENT=1 go get (requires Go >= 1.5 to be installed).


Requires Go 1.5 and GOVENDOREXPERIMENT=1 to properly include dependencies.

Uses gvt to manipulate dependencies.

  • Building: make build
  • Testing: make test
  • Building cross compiled binaries: make dist (will install gox if needed)

Note: encoding/json is vendored from Go 1.7.1 in order to apply this change as it is very useful for people filing bugs against this project since it causes encoding/json to output information about the struct it was deserializing into when an error occurs.