Caprock Files

Added

• GitHub in the app (F14). Settings → GitHub connects your account with your GitHub CLI login (read when needed, never stored), a pasted token (kept in the macOS login keychain, else a file only you can read) or, once a Caprock OAuth app is configured, Sign in with GitHub. It shows the account, scopes and a health line (last success, requests left, the last error word for word). ⌘O and the phone's Start work list and search your repositories to clone. A project with no remote can be put on GitHub (private by default). A worktree's Changes view opens a pull request — title and description from the commits or the agent's summary, base the default branch, draft switch, pushed first when needed — and then shows its checks, reviews and mergeability; the sidebar marks worktrees with a pull request, green, amber or red. Updates arrive live; GitHub is read at most once a minute per repository with conditional requests, and the app can notify you when CI fails or a review lands. Phones read all of it; a controller phone can open a pull request. Every GitHub error is shown with what Caprock was doing. See docs/app.md § GitHub.
• A guide to the desktop app. docs/app.md walks through the window — projects, tabs, terminal, chat, inspector, the keys — the menu bar, badge and ⌃⌥⌘C, notifications with Approve and Deny (and when Approve is offered), pairing a phone over Wi-Fi or Tailscale, and starting work from the phone. The README now leads with the app, with a screenshot made from demo data; the daemon, the dashboard and the CLI are documented as before.
• Split panes in the app. ⌘E puts a new shell beside the terminal in front, ⇧⌘E below it; ⇧Enter in the palette opens a session there. Each pane has a header with its status, the focused one a ring; ⌘[ and ⌘] move between them, the divider drags or takes the arrow keys, ⌘W closes the pane (the session keeps running). Up to four panes a tab, restored on relaunch.
• Jump to what is waiting. ⌘J opens the next session waiting on you, permission prompts first, and wraps; the palette lists them at the top.
• A sharper command palette. Results rank by where they match (start of the name, start of a word, anywhere); "New agent in <project>" for every project; text that matches nothing starts an agent on it in a new worktree named after it, with the text as its first message.
• Menu bar popover (macOS). A click on Caprock's menu bar icon opens a panel under it: what needs you (approve or deny a prompt shown in full), what is running with its cost, today's spend and the Claude and Codex plan windows with when they reset. It opens over the app you are in without switching to Caprock or raising its window. A right click keeps the menu.
• Find in the terminal. ⌘F (Ctrl+Shift+F off macOS) opens a find bar over the focused pane: matches highlighted as you type, "3 of 12", match case, regular expressions, Enter and ⇧Enter for next and previous. Esc closes it and puts you back in the terminal. Works in every pane of a split, in agent and shell tabs alike.
• Open in your editor. VS Code, Cursor, Zed or a JetBrains IDE, when installed: right-click a project or worktree in the sidebar, use the palette ("Open <project> in Zed"), or the inspector — the session's folder, or a changed file at its first changed line. Settings → Editor picks the default. Only from this computer: a paired phone can never open an editor on its screen.
• Terminal colours and fonts. Settings → Terminal: five palettes (Caprock, a light Paper, Catppuccin Mocha, Tokyo Night, Solarized Dark), JetBrains Mono or any of SF Mono, Menlo, Fira Code and other monospace faces found on the machine, size, line height and cursor shape, with a live preview. Every open terminal changes at once; kept per browser.
• Update notice in the app. With release checks on, the status strip says when a newer Caprock is out and opens to the exact command — brew update && brew upgrade --cask caprock-app for the app from Homebrew, and the daemon's own command when the formula installed it. "Not now" hides that version. Nothing installs itself.
• Review and commit without a terminal. Click a worktree's ±N in the app's sidebar (or Review and commit in the inspector, or "Review changes" in the palette) for its Changes view: staged, unstaged, new and conflicted files; each file's diff unified or side by side, with large diffs collapsed until asked and a 5,000-line diff scrolling smoothly; stage, unstage and discard files (discarding asks first), stage or unstage single hunks; a commit message box that can start from what the agent said last; Commit, Commit & Push, Push (a new branch is published and tracked; never forced), Pull (fast-forward only) and Fetch. Keys: j/k, s, u, d, v, c, r, Esc; ⌘↵ commits, ⇧⌘↵ commits and pushes. Hooks run, and a hook that refuses shows what it printed; a remote that refuses your credentials says so. On the phone, a session's Changes tab gains the same commit and push for its worktree (tap files to choose them); a view-only phone sees the counts.

Changed

• Release checks run at most every 6 hours, and a running daemon keeps checking. They used to run at startup and when switched on, throttled to a day, so a daemon left running for a week never heard of a release. Repeats are conditional (If-None-Match), so an unchanged release costs GitHub a 304 and no body. Still off until you turn it on.
• The app uses less CPU when idle, and stalls less on the first tab. With its window hidden the app checks the daemon every 5 s and the page stops polling (the live connection stays); the visible, silent window polls less and redraws its clocks only when they change. A terminal warms up once after start, and replays are written in slices. Hidden, the app now takes about 0.3% of a core (was 1%); the first tab of a launch still holds the window for up to 70–130 ms (was 70–150 ms).
• A half-open connection is caught sooner. After 20 s without a word from the daemon the page pings it and redials if no answer comes within 2 s (about 22 s, was 25 s).

Fixed

• A project's main checkout keeps its own sidebar row beside a linked worktree. With nothing running in either, the project read as one checkout named after the linked worktree's branch.
• The app's status strip rounds plan usage as Now does. It floored, so the same window read 41% there and 42% on Now.