> For the complete documentation index, see [llms.txt](https://docs.tessl.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tessl.io/introduction-to-tessl/set-up-tessl.md). # 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 initialize a project. It takes a few minutes. ## Install the CLI Install the CLI with the method for your operating system. **macOS and Linux** ```bash curl -fsSL https://get.tessl.io | sh ``` **Windows** ```bash winget install tessl.tessl ``` On Windows, skills are linked using directory junctions, which store absolute paths. If you move or rename the project folder, run `tessl install` again to restore the links. See [Skills not found after moving the project folder on Windows](/support/troubleshooting.md#skills-not-found-after-moving-the-project-folder-on-windows). Check that it installed: ```bash 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](https://tessl.io/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](https://1171143958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXbWzspFdXV0HNujz6gJ9%2Fuploads%2Fgit-blob-82b3f5efbedfeda1b03e710de6a13e7f2a4e566d%2Fcreate-account-screen.png?alt=media) That is the same account you will use to authenticate the CLI in the next step. ## Log in If your organization uses the EU region, run `tessl login --region eu` instead. This requires CLI 0.114.0 or later. The CLI remembers the region for later commands. See [Using the EU region](/administrators/eu-region.md). For organizations in other regions, authenticate the CLI so it can reach your workspaces and the registry: ```shell-session 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](https://1171143958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXbWzspFdXV0HNujz6gJ9%2Fuploads%2Fgit-blob-937e407ab03f1f7c2a02b4bc3c5525884b07a9f6%2Fdevice-code-confirmation.png?alt=media) Confirm you are signed in: ```shell-session tessl whoami ``` When you need to sign out, run `tessl logout`. ## Initialize a project Tessl works inside a repository you already have, so there is nothing new to scaffold. From the root of that repository, run: ```bash cd your-repo tessl init ``` This sets up your coding agent to use Tessl, creating a `tessl.json` if one does not already exist. It does not create or link a remote Tessl project on its own. Before you run evals, create or link a project: `tessl project create --workspace engteam`. If you belong to more than one Organization, add `--org ` or set `TESSL_ORG`; a non-interactive shell cannot prompt you to pick one. To link to an existing project, run `tessl project link`. 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](/reference/custom-agent-setup.md) 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](/introduction-to-tessl/set-up-tessl/installation.md) 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**. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.tessl.io/introduction-to-tessl/set-up-tessl.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.