Add your repositories

Limn follows only the repositories you add. Each one you add is synced from GitHub to your computer, and every page in the app reads that copy. You can add any repository your GitHub CLI sign-in can read: your own, your organisation's, or a public one.

#The first time you open Limn

With no repositories yet, Limn opens Add the repos you work on. It lists the repositories you were active in recently, with their open pull requests, and ticks the top five.

1. Tick the repositories you want, and clear the ones you do not.
2. To add one that is not listed, type its name in Search repos to add… under or add any repo by name.
3. Choose Add selected. The sync starts at once and its progress shows in a panel.
4. Choose Continue in background to start work while the sync runs, or wait for Sync complete.

#Add more repositories later

1. Open the workspace picker at the top of the sidebar and choose Manage repos & workspaces. You can also find it with Search or jump (⌘K).
2. Pick the workspace the repository belongs in, on the left.
3. Type the repository's name in Add a repo to … and choose it from the results.

A new repository goes into the workspace you have selected. See Group repositories into workspaces.

#What the first sync brings in

The first sync of a repository runs in two parts, so you can start work quickly:

1. The last two weeks, first. Open pull requests and recent activity arrive in a fast first pass. Most pages are useful after this part.
2. Then up to 90 days of history. Limn fills in the older activity in the background. Reports and Chronology become more complete as it does.

After that, Limn keeps each repository up to date by itself. It checks busy repositories more often than quiet ones, and a pull request you have open in Limn is refreshed every few seconds.

What shows first on Pending

So that My turn is not empty on day one, the repositories you add on your first run show the replies, mentions and pushes of the week before you added them. A repository you add later starts from the time you add it, so its old history does not fill your My turn list.

#See the sync state

• The foot of the sidebar says when Limn last synced, for example Synced 2m ago, or Sync error. Choose it to sync every repository now.
• If GitHub's hourly limit for your account is near, Limn waits instead of failing, and says Paused — resuming ~HH:MM with the time it will carry on.
• A red dot beside a repository in the sidebar can mean its last sync failed. See Repository pages.

#Remove a repository

In Manage repos & workspaces, choose the remove button at the end of the repository's row and confirm.