Exercism v3 launches on Sept 1st 2021. Learn more! 🚀🚀🚀

Command Line Interface


The Exercism command line interface (CLI) is a tool that can download exercises, show your progress through a track, and submit your solutions - all from within your terminal. The best way to get started with the CLI is our Interactive Walkthrough. It guides you down the right path depending on your operating system, experience with the command line, etc, and will get your CLI configured.

If you just want to download the CLI manually and work out how to use it, you can download and install it from GitHub. However, please note that we ask that you work through the Interactive Walkthrough before opening any support requests.

Upgrading from pre-v3

If you have a previous version of the CLI and want to upgrade, please read these instructions.

Basic usage

Run the help subcommand to get the full list of available commands.

exercism help


You need to tell the tool who you are. You can find your token in your settings page.

exercism configure --token=YOUR_API_TOKEN


Make sure you are on the latest version.

Verify which version you are on:

exercism version

Verify against the latest release and upgrade if your version is not the most recent.

After upgrading, double-check the version. If the version didn’t change, make sure you are running the upgraded binary.

which exercism

If you are still having trouble open an issue in exercism/cli on GitHub with the output of the troubleshoot command.

exercism troubleshoot

You can open issues on our issue tracker and the community will try to help you. Please ensure you have worked through the Interactive Walkthrough before opening any issues.

Something need changing on this page?

If you've spotted something incorrect or missing from this page, please edit this file on GitHub. That will submit a pull request to the website team, which we can then review and push live.

Thank you!

Programming person with notebook