Set up Tessl

Takeaway: By the end of this page you will have a Tessl account, the CLI installed and authenticated, and Tessl initialized in a project. That is everything you need before running your first workflow.

Tessl helps you manage the skills and context your coding agents rely on. You work with it through the tessl command line tool, so setup comes down to three things: install the CLI, create an account, and create a project. It takes a few minutes.

Install the CLI

Install the CLI with the method for your operating system.

macOS and Linux

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

Windows

winget install tessl.tessl

Check that it installed:

tessl --help

If you see the list of commands, you are good to go.

Create your account

An account gives you private workspaces, the ability to publish skills, and access to Tessl's MCP tools. You can create one in the browser, or let the CLI prompt you on first login.

1. Go to the Tessl Registry.
2. Click Log in, then Create account.
3. Create your account with Google or GitHub.

Create account screen with Continue with Google and GitHub

That is the same account you will use to authenticate the CLI in the next step.

Log in

Authenticate the CLI so it can reach your workspaces and the registry:

tessl login

The CLI shows a verification code and a URL. Open the URL, sign in, and confirm the code. If you skipped account creation above, this is where you will be prompted to create one.

Device-code confirmation screen

Confirm you are signed in:

tessl whoami

When you need to sign out, run tessl logout.

Create a project

Tessl works inside a repository you already have, so there is nothing new to scaffold. From the root of that repository, run:

cd your-repo
tessl project create

This links the repository to a new Tessl project and sets up your coding agent to use Tessl, creating a tessl.json if one does not already exist. Tessl asks you to pick a workspace for the project, or to create one on the spot. New to projects and workspaces? See Core concepts.

Setting up your agent means configuring the MCP connection so it can talk to Tessl. This is automatic for Claude Code, Cursor, Gemini, Codex, Copilot CLI, and Copilot in VS Code; see Custom agent setup for anything it does not detect.

Keep the CLI updated

The CLI updates itself in the background, so most of the time you do not need to think about it. Updates run only when you invoke a command, and they never block your work. If you want to update on demand, pin a version, or remove the CLI entirely, the Installation reference covers every option.

Next

You have an account, an authenticated CLI, and an initialized project. Next, put it to work: scan your real skills, find one that needs improvement, and publish a better version in Improve your first skill.