Overview

Understand what Tessl projects are and why we need them.

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. The command creates the project, then records the project link in tessl.json, creating the file if it does not exist yet. tessl init sets up local agent configuration and bootstraps tessl.json if it does not exist, but it does not create or link a remote project on its own; run tessl project create or tessl project link for that.

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.