# Overview

A Tessl project gives Tessl a stable place to attach eval runs and other repository-connected data, so your results stay tied to your codebase over time.

### Why projects exist

Tessl needs a project so it knows where an eval belongs. That way your results aren’t just a one-off run — they stay linked to the repository, so you can find them later, compare runs, and keep improving the same codebase.

### Common workflows

#### Create a new project

Use `tessl project create` when this repository is not linked yet and you want to create a new Tessl project.

#### Link to an existing project

Use `tessl project link` when the Tessl project already exists for that repository.

#### Repair a project link

Use `tessl project repair` when the project link is missing, broken, outdated, or linked to the wrong project.

### Current limitations

Projects currently have limited fallback when a directory is not a Git repository.

### See also

* [Manage projects from the CLI](/projects/manage-projects-from-the-cli.md)
* [Evals](/projects/evals.md)
* [Projects in the app](/projects/projects-in-the-app.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tessl.io/projects/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.