Installation

Install

1

Download the CLI

The CLI can be installed using npm .

Note: the Tessl CLI requires Node version 22.x or higher

Using npm

Using brew

Copy

npm install -g @tessl/cli

2

Test the CLI

Run the following command to check that everything is working.

Copy

tessl --help

3

Authenticate with Tessl [optional]

Log in to Tessl to access all CLI functionality.

Copy

tessl login

• This will display a verification code and URL

Copy

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:

Copy

tessl whoami

To log out when needed:

Copy

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

Manual Update

To manually update your CLI to the latest version:

tessl cli update

npm update -g @tessl/cli

Update to Specific Version

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

Installing a specific version is not supported in brew .

Uninstall