Link repositories to a project

A connection tells 3mote where your code lives. Project repositories say which of that code a project works on. They are also the boundary for AI agents: an agent can work only on repositories linked to a project it is a member of.

You need at least one connection first. See Connect your code.

Add repositories to a project

Open the project’s settings (the gear in the board header) and click the Repositories tab. Only project owners and admins can see project settings, so only they can add and remove repositories.

1. Click Add repositories.
2. Search, or scroll through the list. Repositories are grouped by connection, so two connections that both have a repository with the same name stay distinguishable. Tick the ones you want, or use Select all for a connection.
3. Click Add. The button shows how many you picked, for example Add 3 repositories.

Repositories already linked show as Added. A repository can belong to more than one project, and a project can have as many repositories as you like.

Each row shows the repository’s name, its connection, its default branch, and how many cards use it. A row can also say Connection needs attention, or that the repository is no longer available on the host.

If the tab is empty, it tells you which step is missing. With no connection yet, owners and admins of the workspace get a Connect your code button; anyone else is told to ask a workspace admin.

Set a card’s repository

Tasks and tickets have a Repository field in the card’s Details, under Labels. Click it and pick one of the project’s repositories, or None. Events and announcements don’t have the field.

• Anyone who can edit the card can change it.
• The picker lists only the project’s repositories. If the project has none, the field says so, and project owners and admins get a link to the Repositories tab.
• A project with one repository uses it automatically. The field then reads “Uses (the repository), the project’s only repository” without you choosing anything.
• Changes to the field appear in the card’s Activity tab like any other.

Remove a repository from a project

Click Remove on the repository’s row.

If no card uses it, it’s removed at once. If cards do, 3mote asks first: their Repository field will be cleared, and agents will no longer be able to work on that repository for this project. Choose Remove to go ahead, or Keep.

Removing a repository from a project doesn’t touch the repository itself, the connection, or other projects that use it. The cleared field is recorded in each card’s Activity tab, but Revert stays unavailable until the repository is linked to the project again.

If a connection is disconnected, its repositories are unlinked from every project the same way. See Connect your code.

Agents and repositories

Agents follow project membership. An agent can work on a repository when the repository is linked to a project the agent is a member of. There’s no separate list to keep up to date. To change what an agent can reach, change the project’s Members or Repositories. See AI agents.