Skip to main content
System StatusContact Support Agility Community

Client Tools

The list of Continuum command line tools that provide shell level access to the Continuum REST API.


Continuum comes with a complete set of command line tools that provide shell level access to the Continuum REST API. These command line tools are installed on the Continuum server automatically and live the the following location:


As part of the normal install on Linux, the path above should have been added to the Continuum application user account's PATH variable in either the .profile or .bash_profile.

Test the Path

To make sure that the client tools are accessible, perform the following command...

which ctm-version

... and the full path of the file location should be returned. If not, then look at the PATH setting in the .profile or .bash_profile and fix as necessary.

Configure .ctmclient.conf

The command line tools communicate with the Continuum server via the REST API. You can either pass in the connectivity parameters using arguments to the command, or put these in a file named .ctmclient.conf in the application user's home directory. More information on using the command arguments are below, but for now setup your .ctmclient.conf file.

During the initial install this file was created for you. The file is located in the user's $HOME directory.

Since the file exists on the same server as the Continuum REST API service, it is automatically pointed at `localhost`.

Initial .ctmclient.conf file:

        "url": "http://localhost:8080",
        "token": "enter_token_here"

To get the API token, log in to Continuum. From the menu at the top right, choose `My Account`. The token is the string of numbers at the top right of the modal.

My Account

Copy this string, locate your `.ctmclient.conf` file, paste the string as the value for the token using a plain text editor and save. Run the following command:


This should respond with the version of Continuum that is installed on this server.