Repository navigation
Notifications
Nibtree tells you when something happens: a push went through, a pull failed, a fetch found new commits, a stash was saved. Each message pops up for a moment in the bottom right corner, as a balloon. Every message is also kept in the Notifications panel, so you can read it later even if you missed it.
A push, a pull that failed with git's message, a fetch that found nothing and a pull, each with its repository.
Each balloon shows:
- An icon for the kind: a blue i for information, a green check when something is done, a yellow triangle for a warning, and a red mark for an error.
- A short title that says what happened to which branch, such as Pushed 2 commits of main to origin/main.
- The repository it came from.
- More text when there is some, such as the commits that moved or git's own error message. You can select and copy it.
- A link when there is something to do next, such as Undo.
Balloons close on their own after a few seconds. Errors stay longest, so there is time to read them. While your pointer is over a balloon it stays open, and it closes a moment after you move away. The x in its corner (it shows when you point at the balloon) closes it right away.
At most four balloons show at once. When more arrive, the oldest close early, but they are all still in the panel.
Git messages name the branch, where it went and what changed, so a list of pushes and pulls across many repositories still tells each one apart:
| Action | Title | More text |
|---|---|---|
| Push | Pushed 2 commits of main to origin/main | main: 0867b60..7eba1a2 |
| First push or Publish | Published feature to origin/feature | New branch feature, Tracks origin/feature |
| Pull | Pulled origin/main into main | The commits it brought, Fast-forward or a merge commit, the files changed |
| Fetch | Fetched origin | Each branch that moved, new branches and tags, deleted branches |
| Sync | Synced main with origin/main | Pulled 3 commits, pushed 1 commit |
| Commit | Committed on main | The new commit's id and message, the files changed |
| Update Project | Updated 3 repositories | Each repository and what its pull did |
When there was nothing to do, the message says so with a blue i, for example main is up to date with origin/main or Fetched origin: nothing new. When something fails, the title names the branch too, such as Could not push main, and the text below is git's own message.
The Notifications panel lists this session's messages, newest first. The dot marks the ones you had not seen.
Open it with the bell at the bottom of the right activity bar (the strip of icons on the right edge of the window). The bell in the status bar and View > Notifications open it too. Click the bell again to hide the panel.
The panel lists every message of this session, newest first:
- Each message shows its kind, title, repository, how long ago it came and any extra text.
- A dot marks messages that arrived since you last looked.
- A link such as Undo stays for a while after the message came. It goes away once it has been used or what it acts on has changed.
- Point at a message and click its x to clear just that one.
- The trash can at the top clears them all.
While the panel is open, messages go straight into the list and no balloons pop up, because you can already see them.
The list starts empty each time you open Nibtree. It keeps up to 200 messages.
When errors or warnings arrive that you have not seen, the bell shows how many. The count is red if one of them is an error, and amber for warnings only. Opening the panel marks everything as seen and clears the count.
Turn on Do Not Disturb with the bell button at the top of the panel, or with View > Do Not Disturb. Only errors pop up then. Everything else still goes into the panel, so nothing is lost. The bells show a crossed-out bell while it is on.
- Status Bar and Help: the other items in the status bar.
- Repository Actions: Pull, Push, Sync and Fetch, which report here.
- Developer chapter: How notifications work.