For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /introduction-to-tessl/installation.md.
Docs

    Installation

    Install

    Download the CLI

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

    Native

    curl -fsSL https://get.tessl.io | sh

    Homebrew

    brew tap tesslio/tap #  Recommended as of Homebrew 6.0.0
brew trust tesslio/tap #  Recommended as of Homebrew 6.0.0
brew install tesslio/tap/tessl

    winget

    winget install tessl.tessl

    npm (deprecated)

    npm install -g @tessl/cli

    Test the CLI

    Run the following command to check that everything is working.

    tessl --help

    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.
    Info

    If your organization uses the EU region, run this command instead of tessl login above. It requires CLI 0.114.0 or later. The CLI remembers the region for later commands. See Using the EU region.

    tessl login --region eu

    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
    Info

    Automatic updates are disabled in CI environments and on winget

    Manual Update

    To manually update your CLI to the latest version:

    Native

    tessl cli update

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

    Homebrew

    tessl cli update

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

    winget

    winget upgrade tessl.tessl

    Running tessl cli update will provide a hint to use winget upgrade tessl.tessl instead

    npm (deprecated)

    npm update -g @tessl/cli

    Update to Specific Version

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

    Native

    Example to update to a specific version:

    tessl cli update --target 0.86.0

    Homebrew

    Installing a specific version is not supported in brew. To update to a specific version execute:

    tessl cli update --target 0.84.0

    winget

    Example to update to a specific version:

    winget upgrade tessl.tessl --version 0.84.0

    Running tessl cli update will provide a hint to use winget upgrade tessl.tessl instead

    npm (deprecated)

    Example to install a specific version:

    npm install -g @tessl/cli@0.84.0

    Uninstall

    Native

    rm -rf ~/.local/bin/tessl ~/.local/share/tessl

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

    Homebrew

    brew uninstall tessl
rm -rf ~/.local/bin/tessl ~/.local/share/tessl

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

    winget

    winget uninstall tessl.tessl

    npm (deprecated)

    Determine which npm Tessl package you have:

    npm ls -g | grep tessl

    To uninstall @tessl/cli

    npm uninstall -g @tessl/cli

    To uninstall tessl

    npm uninstall -g tessl

    Remove the native binaries:

    rm -rf ~/.local/bin/tessl ~/.local/share/tessl

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