> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# Initialize a repository

Using _Setup_ on the Repositories view in [Tessl Registry](https://tessl.io/registry) creates a `tessl.json` file and adds any plugins Tessl has for the dependencies your repository uses. It also creates a `.mcp.json` file so people working in the repository can use Tessl as an MCP server for their coding agent.

## Setup Tessl

- Select your workspace from the workspace switcher in the sidebar, below the organization dropdown.\
  ![](</gitbook-assets/image (115).png>)
- Click on Repositories from the menu.\
  ![](</gitbook-assets/image (113).png>)
- Select _Setup Tessl_.

  <figure><img src="/gitbook-assets/image (13) (1).png" alt=""><figcaption></figcaption></figure>
- Select the agents you wish to use and click _Setup_.

  <div align="left"><figure><img src="/gitbook-assets/image (15) (1).png" alt="" width="375"><figcaption></figcaption></figure></div>
- Once clicked, a pull request will be created and a popup will be displayed to bring you to the pull request.

  <div align="left"><figure><img src="/gitbook-assets/image (10) (1).png" alt="" width="357"><figcaption></figcaption></figure></div>

### The Pull request created

Pull requests may contain updates to `tessl.json` and `.mcp.json` based on your selections and the dependencies the repository contains.

- You or your pipeline automation would merge the request(s).\
  ![](</gitbook-assets/image (16) (1).png>)

## Troubleshooting

If you do not see your repositories listed, see [Connect Tessl to GitHub](/guides/distribute/rollout-to-your-repositories/connect-tessl-to-github.md) or [Connect Tessl to GitLab](/guides/distribute/rollout-to-your-repositories/connect-tessl-to-gitlab.md).

- It's possible you are only allowing specific repositories, in which case you may need to select the additional repositories you wish to display in the GitHub settings or provide a group token with access in GitLab.