Configuration files

AGENTS.md

The AGENTS.md file provides project context to LLMs during code generation. This file is similar to CLAUDE.md and other context files.

After running tessl init, it will be updated to be structured into multiple sections. Some are managed by Tessl and are marked with <!-- tessl-managed -->.

As part of interacting with your agent while getting started with Tessl, context about the project stack, testing commands and the like will be automatically added. If you are not using a coding agent, add these yourself by replacing the "New Project Bootstrapping" section in AGENTS.md.

You are also free to add further details and context about your project as you would typically. The content of AGENTS.md and its links is automatically included in LLM prompts when generating code, helping ensure consistency with your project's patterns and conventions.

Purpose

• Defines your project's ecosystem and dependencies

• Specifies coding conventions and patterns

• Sets up project file layout expectations

Linking to Additional Files

AGENTS.md supports linking to other files in your project, and these linked files are automatically loaded and included in the LLM context during code generation. This allows you to modularize your project configuration and keep related information in separate files.

By default Tessl installs some modularized context in .tessl.

Link Format

Use standard markdown link syntax to reference other files:

[link text](./relative/path/to/file.md)

Links should be relative paths from the file containing the link.

Init files

When logged out, tessl init creates the following files and directories:

|-- AGENTS.md                            # Agents directives
|-- KNOWLEDGE.md                         # Knowledge Index (keeps track of Usage specs)
|-- tessl.json                           # Usage specs packages config
|-- .tessl                               # Tessl configuration directory
|   |-- .gitignore                       
|   |   `-- usage-specs.md
|   `-- usage-specs                      # Downloaded usage specs
|       `-- tessl
|           `-- <package-name>
|               `-- <package-version>
|                   |-- docs
|                   |   |-- index.md
|                   |   `-- ....
|                   `-- specs.json

When logged in, tessl init creates the following files and directories:

|-- AGENTS.md                            # Agents directives
|-- KNOWLEDGE.md                         # Knowledge Index (keeps track of Usage specs)
|-- tessl.json                           # Usage specs packages config
|-- .tessl                               # Tessl configuration directory
|   |-- .gitignore                       
|   `-- tmp                     # session information etc
|       |-- ...
|   `-- usage-specs                      # Downloaded usage specs
|       `-- tessl
|           `-- <package-name>
|               `-- <package-version>
|                   |-- docs
|                   |   |-- index.md
|                   |   `-- ....
|                   `-- specs.json