CLI for interacting with CircleCI's API
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
vendor
.gitignore
CHANGELOG.md
LICENSE
Makefile
README.md
demo.gif
main.go

README.md

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

Installing

OS X (64 bit)

curl -sL https://github.com/jszwedko/circleci-cli/releases/download/0.1.0/darwin_amd64 > circleci-cli
sudo mv circleci-cli /usr/local/bin/
sudo chmod +x /usr/local/bin/circleci-cli

Linux (64 bit)

curl -sL https://github.com/jszwedko/circleci-cli/releases/download/0.1.0/linux_amd64 > 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 github.com/jszwedko/circleci-cli (requires Go >= 1.5 to be installed).

Developing

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.