search
WebsitePress Kit

Installation

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

hashtag
Install

1

Download the CLI

The CLI can be installed using Curl (native), Homebrew or npm (deprecated).

curl -fsSL https://get.tessl.io | sh
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

hashtag
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

circle-info

Automatic updates are disabled in CI environments

hashtag
Manual Update

To manually update your CLI to the latest version:

tessl cli update

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

hashtag
Update to Specific Version

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

Example to update to a specific version:

Installing a specific version is not supported in brew .

hashtag
Uninstall

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

PreviousSign up for TesslNextContext Lifecycle

Last updated