Installation

A step-by-step guide on how to install, update or remove the Tessl CLI.

Install

1

Download the CLI

The CLI can be installed using npm .

Note: the Tessl CLI requires Node.js v22.17.0 or higher

Using npm

npm install -g @tessl/cli

Using brew

2

Test the CLI

Run the following command to check that everything is working.

tessl --help

3

Authenticate with Tessl [optional]

Log in to Tessl to access all CLI functionality.

tessl login

• This will display a verification code and URL

Please log in at the URL below (if your browser didn't open automatically):

  https://auth.tessl.io/device

Then confirm the following code:

  XYZA-BCDE

⠏ Waiting for confirmation…

• Open the URL in your browser and login to Tessl with either your GitHub or Google account.

• Once authenticated, you can enter the device code in your browser window.

You can now verify your authentication status with:

tessl whoami

To log out when needed:

tessl logout

Automatic Updates

The Tessl CLI automatically checks for updates and installs them in the background. Updates run silently without interrupting your workflow.

• Updates check every 3 hours by default

• Updates only occur when you run CLI commands; they might briefly delay command exit

• To disable automatic updates, set TESSL_AUTO_UPDATE_INTERVAL_MINUTES=0

• Update logs are saved to ~/.tessl/auto-update.log for troubleshooting

Automatic updates are disabled in CI environments

Manual Update

To manually update your CLI to the latest version:

Using Tessl CLI

tessl cli update

This command will update your CLI to the latest version for your current release channel.

Using npm

Update to Specific Version

You can find all releases in the changelog. To install/upgrade to a specific version:

Using Tessl CLI

Example to update to a specific version:

tessl cli update --target 0.50.3

Using npm

Installing a specific version is not supported in brew .

Uninstall

Npm uninstall

• To uninstall the Tessl CLI, run npm uninstall -g @tessl/cli

• To remove Tessl config files, delete the ~/.tessl directory

Brew uninstall