Omniscio

Branch header

The optional git branch badge in a session header: showing the current branch next to the session name, the worktree icon and tooltip, the global and per-project toggles that hide it, and how the branch value is watched and refreshed.

On this page

What it is

When a session's working directory is a git repository, Omniscio can show the current git branch name in the session header (off by default — enable it in Settings → Appearance) — small grey text next to the session name, with a branch icon (GitBranch) or a folder-plus-branch icon (FolderGit2) if the session is running on a per-session git worktree (see start-a-new-session.md Isolate option). Hovering shows a tooltip like "Current git branch: feat/add-auth" or "Current git branch: feat/add-auth (worktree)".

Where to find it

How to use it

  1. To hide the branch for ONE project. Right-click the project in the Projects sidebar and pick Hide branch in header (or open the project's edit dialog via the three-dot menu → Edit project and flip Hide git branch in header). The toggle takes effect immediately on every session in that project. The same menu entry now reads Show branch in header so you can flip it back.
  2. To show the branch app-wide. It's off by default — open Settings (gear icon) → Appearance, scroll to Show current git branch in header, and turn it on. Per-project toggles still apply on top — turning the global toggle off hides everywhere; turning it on falls back to the per-project setting.
  3. To force-refresh the branch. The header polls automatically; if it ever looks stale, switching to another session and back re-runs the watch.
  4. What it shows for worktree sessions. When you launched the session with Isolate turned on, the icon switches from a plain branch glyph to a folder-plus-branch glyph and the tooltip appends "(worktree)" — a visual reminder that this session is operating on a git worktree copy of the project, not the main checkout.
  5. Why no branch shows up. The folder isn't a git repo (no .git/), it's a virtual project, the per-project hide toggle is on, the global toggle is off, or the watch hasn't reported a result yet. There's no error UI for "git not installed" — the header just stays empty.

How it behaves

  • Open on the code host. A small arrow next to the branch name opens that branch's page on GitHub, or on GitLab, Bitbucket, Azure DevOps or Forgejo when the code hosts Lab switch is on. It opens only the branch the header shows, and only in the desktop app.

It updates live — if the agent runs git checkout or you switch branches in another terminal, the header reflects the change within a couple of seconds.

Switching branch from the header

Click the branch name to open Switch branch: a searchable list of the folder's local branches (current first; a branch open in another worktree is shown but cannot be picked) and a row to create a new branch from the current commit. It works only for a session working directly in its project folder — a worktree session's branch belongs to that session and is not switched here — and never on the app's own repository checkout. The switch is refused while any agent or project script is working in that folder; while it runs, messages to agents in that folder wait. With uncommitted changes you are asked first and told how many files come along; if git says a change would be overwritten nothing happens. The app never forces, resets or stashes. Every agent in the folder gets a one-line note on its next turn. A ▶ Project scripts button sits beside the branch when the project has a scripts file — see project-scripts.md.

The branch indicator is hidden in three cases:

  1. The session's project has Hide git branch in header turned on (per-project toggle).
  2. The global Show current git branch in header setting under Settings → Appearance is off (defaults to off — the badge is opt-in).
  3. The project's folder is a virtual project (Settings, Inbox, Recipes, etc. — those have no git working directory).

The branch text only appears on desktop layouts (md: breakpoint and up); mobile session headers omit it to save horizontal space.

Last verified 2026-09-28