docs

The sidebar

Sections organized by what things mean rather than where they come from: what you have open, the places you keep, the places you browse, the pull requests and issues that involve you, 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."

Pinned

The folders and files you keep coming back to, above Locations the way Finder keeps Favorites above everything else. Right-click a folder or file in any tree and choose Pin…: a folder becomes its own root with its own tree, a file becomes a bookmark row that previews on click, and the new entry lands at the bottom of the section already in rename. A Location root gets Pin (it moves here) and a pinned root gets Unpin (it moves to the bottom of Locations, keeping its name).

Renaming works the Finder way: choose Rename… or press Return on the selected row, type, and Return, clicking anywhere else, or moving on commits; Escape cancels; an emptied field goes back to the real name. A renamed entry shows its true path in small text beneath the name, and so does any pair of roots that share a name, so two folders called docs never look alike. Pinned entries are a preference, not part of the session: they come back at every launch whatever Reopen previous session says.

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 come the pull requests that involve you, in buckets: Review Requests, Created, Assigned, and Participating (you commented, reviewed, or were mentioned). Empty buckets stay hidden, drafts say · draft, and a row spells out why it's there (· assigned, · mentioned) when the bucket alone doesn't. Every bucket loads the 30 most recently updated and ends in Show more…. Unread counts stay visible on collapsed headers; the whole thing is optional in Settings, and filterable to Markdown-touching PRs.

Follow a repository to see everything open in it, newest first: Follow Repository… in the section header offers the repositories you already have open, or takes owner/repo typed in. A followed repository is its own group with its own unread rule — right-click it for Everything, Only Mine, or None, and for Unfollow. Any single PR or issue row can override that rule from its own right-click menu.

Prefer one list? Group GitHub work by Involvement merges this section and Issues into one GitHub section, buckets mixing both kinds with a glyph per row.

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.

Issues

The same idea for issues — Created, Assigned, Participating, and the followed repositories' issues — because the doc you're asked to review is often an issue, not a pull request. Click one and it opens as a document: the rendered body, its labels, the comment timeline with reactions, and a composer at the end. Comment, react, and edit or delete your own comments without leaving the app. An open issue sits at the top of the section as a single row, goes into Recents and ⌘K Open Quickly, and comes back with the session.

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.