This project is the seed for CircleCI's new command-line application.
Documentation | Code of Conduct | Contribution Guidelines | Hacking
If you're installing the new circleci CLI for the first time, run the following command:
bash -c "$(curl -fSl https://raw.githubusercontent.com/CircleCI-Public/circleci-cli/master/install.sh)"
By default, the circleci app will be installed to the /usr/local/bin directory. If you do not have write permissions to /usr/local/bin, you may need to run the above command with sudo. Alternatively, you can install to an alternate location by defining the DESTDIR environment variable when invoking bash:
DESTDIR=/opt/bin bash -c "$(curl -fSl https://raw.githubusercontent.com/CircleCI-Public/circleci-cli/master/install.sh)"
brew install circleci
sudo snap install circleci
If you installed the old CLI before, and you're on version less than 0.1.6, you need to run the following commands:
circleci update
circleci switch
This command may prompt you for sudo if your user doesn't have write permissions to the install directory, /usr/local/bin.
The CLI comes with a built in version managment system. You can check if there any updates pending and update if so using the following commands:
circleci update check
circleci update install
You may first need to generate a CircleCI API Token from the Personal API Token tab.
$ circleci setup
If you are using this tool on circleci.com. accept the provided default CircleCI Host.
Server users will have to change the default value to your custom address (i.e. circleci.my-org.com).
Note: Server does not yet support config processing and orbs, you will only be able to use circleci local execute (previously circleci build) for now.
To ensure that the tool is installed, you can use it to validate a build config file.
$ circleci config validate
Config file at .circleci/config.yml is valid
The CLI may also be used without installation by using Docker.
docker run --rm -v $(pwd):/data circleci/circleci-cli:alpine config validate /data/.circleci/config.yml --token $TOKEN
Development instructions for the CircleCI CLI can be found in HACKING.md.
Please see the documentation or circleci help for more.