Group repositories into workspaces

A workspace is a named group of repositories, for example one per team or one per product. Every page in Limn shows one workspace: its pull requests, its Pending board, its Feed, its Reports and its bots. Switching the workspace changes all of them together. A repository is Maintained in one workspace at most, and can be External in any number of others.

#The Default workspace

Limn starts with one workspace, Default. New repositories land there unless you add them to another workspace. You can rename Default, but you cannot delete it: when you delete another workspace, its repositories and its bot settings move back to Default.

#Switch the workspace

The workspace picker is at the top of the sidebar. It shows the name of the workspace you are in. Open it and choose another workspace. Default is listed first, then the rest by name, each with its number of repositories.

When another workspace has pull requests waiting on you, the picker shows its count, and the sidebar's Needs you section names it, so you do not miss work in a workspace you are not looking at.

#Create, rename and delete workspaces

1. Open the workspace picker and choose Manage repos & workspaces.
2. To create one, type a name in New workspace name… and choose Create.
3. To rename one, choose Rename beside its name.
4. To delete one, choose Delete workspace and confirm. Its repositories move to Default.

#Add, move and remove repositories

In the same dialog, choose a workspace on the left. The right side lists its Maintained and its External repositories, one per line, with the other workspaces each one is in beside its name.

• To add a repository from GitHub, type its name in the search box and pick it. Add as chooses Maintained or External. Nothing is listed until you type.
• To add a repository you already have, use Add one of your repos…. It keeps its other workspaces.
• To move one, choose another workspace in its workspace picker.
• To take one out of the workspace, choose Remove (×) on its line. When it is in no other workspace, Limn asks first and then removes it and its synced data. Each line shows its own progress, so you can remove several at once.

Grid, at the top of the dialog, shows every repository against every workspace. Click a cell to change it: not in the workspace, then External, then Maintained.

#External repositories

Mark a repository External when your team changes it but does not maintain it, for example a shared infrastructure repository where you update your services' configuration. In Manage repos & workspaces, change its picker from Maintained to External. The same repository can be External in several workspaces, and Maintained in one of them. Making it Maintained in a workspace turns it External where it was Maintained before.

An external repository:

• Is listed under Repositories in the sidebar, marked External, and its page opens as usual.
• Is part of Implement story and AI Fix, like any other repository in the workspace.
• Links its pull requests to your tickets on This Sprint.
• Shows on Open PRs and Pending only the pull requests that are your team's: a pull request whose title or branch has one of your tracker's project keys, or one opened by a person who maintains (has merged into) one of your Maintained repositories. Your own pull requests always count. Pull requests from other teams stay hidden.
• Is left out of Reports, the Timeline, the Feed and Bots Monitoring.
• Gets no automatic action: no auto review, auto-posting, auto fix, automatic thread resolving or Slack signal. You can still run an AI review or AI Fix on one of its pull requests yourself.

#What belongs to a workspace

These settings and figures are kept per workspace:

• The repositories, and so every list and count in the app.
• Which reviewers are bots, their category and their price. See Settings → Bots.
• Auto review, auto-posting and the other AI review switches. See Settings → AI review.
• The issue tracker, SonarCloud and Slack. See Settings → Integrations.
• Working hours, Chronology budgets and the sprint cadence. See Settings → Reports and sprint.
• The repositories muted on My turn. See Mute a repository.