docs

The sidebar

Four sections, organized by what things mean rather than where they come from: what you have open, the places you browse, the pull requests you're reviewing, and where you've been.

Open Files

The working set: every document you've explicitly opened — from Finder, drag & drop, ⌘O, the command line, or by keeping a file from a Location. Flat, reorderable by dragging, each row removable with the hover ✕ (or ⌫ on the selected row). Right-click the section header for Close All.

Previews

Single-click a file inside a Location and it renders immediately — and appears in Open Files as a preview: one italicized entry, always last in the section. Click another file and the preview entry is replaced, so browsing a big tree never piles up rows. It's the same idea as VS Code's preview tabs or Xcode's temporary editor, wearing the same italics.

A preview becomes a normal, pinned entry when you show it any commitment beyond reading:

• Double-click the file in the tree, or the italic entry itself
• Start editing — entering Edit Mode or saving a block edit pins it
• Keep Open in the right-click menu

Reading interactions — blame, line history, inspecting an image or diagram — deliberately never promote a preview. If you'd rather every click open files fully, flip Clicking files in Locations in Settings.

Remote repos preview the same way, in the same place. Browsing a GitHub repo's tree, or following links inside a remote document, puts the same single italic entry in Open Files — with a book icon and an owner/repo @ ref second line, since the file isn't on your Mac. There is only ever one preview per window, local or remote: previewing anything replaces whatever you were previewing before. Keeping a remote doc (double-click or Keep Open) is what files it with its repo — it moves to the repo's pinned list under Locations. ⌘K opens pin directly, since pasting a URL is explicit intent.

Any Open Files row that lives inside an open Location gets Reveal in Location in its right-click menu — the jump back from "what I'm reading" to "where it lives."

Locations

Browsable roots, wherever they live. Two kinds share the section, distinguished by icon:

A local folder that's a git checkout grows a branch chip (branch glyph + name); if its remote is on GitHub, a small closed-book mark appears too — hover it to see which repo. Clicking the branch chip opens the branches-and-worktrees menu:

• Worktrees — every worktree of the repo, with a checkmark on the one this row is; choose another to open it as its own Location. Worktrees are never checked out or switched from PullMark — it opens the folder that's already there.
• View Branch from GitHub — read another branch's files remotely, without touching your checkout. A branch that already has a local worktree jumps to the worktree instead — local beats remote.
• Open on GitHub — the repo (at this branch) in your browser.

On a remote (book-icon) repo, the same chip lists branches: Switch To re-pins the session to another branch, and holding ⌥ offers Open Branch Separately for side-by-side reading. Browse Repo Files… loads the repo's whole Markdown tree. The repo's kept docs sit above the tree, so they never drown under a big repo; a kept doc that's visible in the tree is simply represented there. (A doc you're merely previewing shows in Open Files, not here.)

A folder whose path stops resolving (an unmounted volume, a deleted worktree) dims with a question-mark badge instead of vanishing — it revives by itself when the path returns.

Pull Requests

Each opened PR is a group: the overview row (status icon + changed Markdown count), then its changed Markdown files — a comment bubble with a count marks files with unresolved review threads. Below your opened PRs, Review Requests collects PRs waiting on your review, with an unread count that stays visible even collapsed (hideable in Settings, and filterable to Markdown-touching PRs only).

Status icons on PR rows:

Per-file markers inside a PR: + circle (green) for added, − circle (red) for removed, → circle for renamed, pencil circle for modified.

Recents

Recently opened files, folders, and pull requests that aren't already visible above. PR entries carry their live status icon; a recent whose file has gone missing dims (clock badge) instead of disappearing and revives when the path returns — built for branch switches and unmounted volumes. Right-click the header to Clear Recents.

Removing things

Hover any top-level row for the ✕ — it removes the row from the sidebar, never anything from disk or GitHub. ⌫ on a selected row does the same. Files inside a Location's tree have no ✕: they're contents of a place, not sidebar items.

Icon glossary

The branch glyph appears only on actual git refs (chips, never as a folder icon) — a folder is a folder, a repo is a book, a branch is a branch.