What's new
All notable changes to Perch are documented here. Format follows Keep a Changelog.
[Unreleased]
Section titled “[Unreleased]”[v0.6.13] - 2026-11-18
Section titled “[v0.6.13] - 2026-11-18”- Git graph file rows keep the file name when space runs out (the directory takes the hit)
- List | Tree toggle for the git graph’s files, with collapsible folders
[v0.6.12] - 2026-11-18
Section titled “[v0.6.12] - 2026-11-18”- A little tree marks sessions working in a git worktree (started there or wandered in)
- Click the tree for the git graph
[v0.6.11] - 2026-11-13
Section titled “[v0.6.11] - 2026-11-13”- Resuming a long session no longer freezes the window
- Edit cards build three times faster
- Find in a session lands on a phrase near-instantly
- Transcript search about 3x faster; refining a query is near-instant
- Stats rebuild from scratch in a third of the time
- Flight path days load faster (holding ← no longer queues a scan per press)
- Git graph refreshes only what changed, and keeps history you scrolled in
- Background polls rest while your screen is locked (they’ve earned it)
- Less memory, both at launch and after days of uptime
- Settings text fields save when you pause typing
- Hidden spinners stop spinning for nobody
[v0.6.10] - 2026-11-12
Section titled “[v0.6.10] - 2026-11-12”- Status lines with git counts refresh about 3x faster (it was mostly waiting on git; re-apply your profile)
[v0.6.9] - 2026-11-06
Section titled “[v0.6.9] - 2026-11-06”- Focusing a Windows Terminal session picks its tab, not just the window (no more tab roulette)
[v0.6.8] - 2026-11-06
Section titled “[v0.6.8] - 2026-11-06”- Analyse resource usage: record the whole machine, then scrub back through it
- CPU and RAM by session, app, and the kernel’s own share
- Findings that name the culprit and say what to change
- Blames the hooks, sub-agents and builds behind the load (politely, with numbers)
- Hooks page: every hook’s runs, by event
- Windows services named, not just “svchost” (it was Windows Update)
- Sub-agents appear the moment they spawn
[v0.6.7] - 2026-11-05
Section titled “[v0.6.7] - 2026-11-05”- Sub-agents stopped by their parent vanish at once (no 90-second wake)
[v0.6.6] - 2026-11-04
Section titled “[v0.6.6] - 2026-11-04”- Rewind a session to an earlier prompt: conversation, code, or both
- Pick the rewind point by scrolling the chat itself, or ↺ on a prompt
/rewind, or Esc Esc, as in the terminal- Fork a session into a new window, from the end or any prompt
- Rewound sessions reopen without the turns you threw away (they never happened)
- Remote Control stays on across a session restart
- Copy button no longer sits on top of one-word prompts
[v0.6.5] - 2026-11-04
Section titled “[v0.6.5] - 2026-11-04”- Something new to find in the trophy cabinet (we’ve said too much already)
[v0.6.4] - 2026-11-04
Section titled “[v0.6.4] - 2026-11-04”- Long session lists scroll instead of wandering off the bottom of the screen
- “2 above” / “1 below” cues for scrolled-away sessions that need you
- Compact rows: one line per session, from the “+ New session” row
- Work items retired (very organised, very alone);
perch workand--workgo too
[v0.6.3] - 2026-11-04
Section titled “[v0.6.3] - 2026-11-04”- Git graph lines stay close to main (they’d been social distancing)
- Remote holds the main line when you’re only behind it
- Stashes sit where they were made, not all at the top
- Resizable branch panel
- Hide all branches, or just the ones that aren’t yours
- Tidier branch list: here/worktree marks, aligned ahead/behind column
- Tags can be hidden, and grouped by name into a tree
- “Tag here…” and “Check out this commit” on commits
- Author column drops out while pictures are on
- Pull and Push spin while they work; the rest of the toolbar waits
- Confirmations open inside the graph window, not off-screen
- Ctrl/Shift+click several files to stage, discard, delete or stash them
- Stash a single file from its right-click menu
[v0.6.2] - 2026-11-03
Section titled “[v0.6.2] - 2026-11-03”- “View tree” grows up into a full git graph (it was a list; it had ambitions)
- Branches, tags and every worktree on one graph, your branch down the left
- Double-click a branch to check it out, with Undo
- Drag to merge, rebase, fast-forward, cherry-pick or make a worktree
- Pull, Push, Branch, Stash and Pop on a toolbar
- Stashes in the graph: apply, pop, drop, rename (git can’t rename them; we did it anyway)
- “Branch here…” on any commit, pill or your changes
- Right-click menus for branches, commits and files
- Ctrl+F commit search, resizable columns, exact times on hover
- Hide branches; optionally auto-hide ones that aren’t yours
- Upstream ahead/behind marks on branch pills
- Author pictures on commits (via GitHub, never Gravatar)
- Softer dark mode for the graph window
- Conflict banner with Continue, Skip and Abort
[v0.6.1] - 2026-10-29
Section titled “[v0.6.1] - 2026-10-29”- Green tick on the PR glyph once a PR is approved
- PR tooltip names who approved it (credit where it’s due)
[v0.6.0] - 2026-10-29
Section titled “[v0.6.0] - 2026-10-29”- Hook no longer runs on every tool call (your tool calls are now slightly less supervised)
- Permission-mode badge reads Claude Code’s transcript
- Finished or stopped sub-agents leave the overlay at once
- Leftover sub-agent markers swept when a session ends
PERCH_WORKretired; useperch --work <item>(we suspect nobody will notice)
[v0.5.47] - 2026-10-28
Section titled “[v0.5.47] - 2026-10-28”- Turn off Claude Code’s idle compaction from Perch’s settings
- Per-directory “Edit…” for Agent Teams and idle compaction, in search too (it was only half-honest before)
[v0.5.46] - 2026-10-28
Section titled “[v0.5.46] - 2026-10-28”- Keep sign-ins fresh (experimental): Claude Code renews tokens before they lapse
- “Renewing sign-in…” / “Sign-in renewed” over the usage bars
- “Login required” button when an account needs logging in (Perch won’t do it for you)
- Login required clears the moment you log in, however you do it
- Sign-in state for accounts that share a login shows on their shared bars
- Declared accounts appear in the usage strip promptly at launch
- PR glyph follows the worktree a session actually works in (not the one it claims)
- Pick a session’s PR worktree from its menu or the PR glyph
- Middle-click “Open in GitHub” on the dashboard opens a new window
- Session launcher keeps the picked account when the folder changes
[v0.5.45] - 2026-10-27
Section titled “[v0.5.45] - 2026-10-27”- Emoji in PR check names and titles render (no more
ðŸ”) - PR glyph works when Perch is started from a terminal
- A PR lookup that times out retries in 30s, not 5 minutes
- Failed PR lookups logged to
logs/pr.log
[v0.5.44] - 2026-10-27
Section titled “[v0.5.44] - 2026-10-27”- Account pickers list every config dir, not just distinct accounts
- Dirs sharing an account read “Account | dir” (two folders, one login, no longer one entry)
- Optional expected account per config dir
- Drifted logins flagged in Settings, the pickers and the session-row chip
- Tooltips no longer sit on right-click menus (they were eating the clicks)
[v0.5.43] - 2026-10-23
Section titled “[v0.5.43] - 2026-10-23”- Update progress bar under the overlay header (updating is no longer a secret)
- Update buttons grey out while an update runs
- Windows and sessions stay open until the download finishes
[v0.5.42] - 2026-10-22
Section titled “[v0.5.42] - 2026-10-22”- Work items (beta): group sessions into named pieces of work
- Work items window with notes, links, sessions and an activity log
- Overlay can group sessions by work item (flat until you ask)
- Drag sessions between work items
- Ended sessions stay under their item, ready to resume
PERCH_WORK=<item> claudefiles a terminal session under an itemperch --workandperch workcommands- Each item is a markdown file (edit it by hand; Perch will cope)
[v0.5.41] - 2026-10-22
Section titled “[v0.5.41] - 2026-10-22”- Mermaid flowcharts, sequence and ER diagrams draw in Markdown previews
- Fullscreen diagram viewer with zoom and drag
- Source toggle on every diagram (for when the drawing is merely approximately right)
- Other diagram types show their source with a polite apology
[v0.5.40] - 2026-10-15
Section titled “[v0.5.40] - 2026-10-15”/resume <id>jumps straight to that session; other text pre-fills the search/resumepicker shows every project’s sessions on Tab- Switch a session’s account when config dirs share
projects/(one conversation, two employers) - Footer account chip switches a running session (restarts under the new account)
[v0.5.39] - 2026-10-15
Section titled “[v0.5.39] - 2026-10-15”- Documentation site at arcticgizmo.github.io/perch
- First-run walkthrough of the Quick Start, plus a page per feature
- README leads with alerts (the thing Perch is actually for)
[v0.5.38] - 2026-10-15
Section titled “[v0.5.38] - 2026-10-15”- Mic button jumps to the meeting, not the Teams window you last touched
- Turning on remote control skips the QR code (it’s in the icon’s menu, for the rare scan)
/rcagain turns remote control off- QR code opens on the session’s monitor, not the main one
- Collapsed docked column stays collapsed when a session needs you (your windows stay put)
- Collapsed docked column shows a tile per session; click one to focus it
- Tiles flag what needs you in place, without shuffling
- Running tiles dimmed, idle ones barely there
[v0.5.37] - 2026-10-15
Section titled “[v0.5.37] - 2026-10-15”- Restart session, tucked in a ▾ beside End session
- Same conversation, fresh process (turning it off and on again, formalised)
- Restart button on the session’s sign-in expiry warning
- Sign-in warning waits until 5 minutes out, when Claude would refresh
[v0.5.36] - 2026-10-15
Section titled “[v0.5.36] - 2026-10-15”- Optional Do Not Disturb button in the overlay header (a sleeping bell)
- One click toggles Windows Do Not Disturb
- Follows Do Not Disturb set elsewhere (the bell is a light sleeper)
- Friends feed closes on Do Not Disturb on newer Windows builds (it had been listening to the wrong room)
[v0.5.35] - 2026-10-14
Section titled “[v0.5.35] - 2026-10-14”- Your default account shows the org
/statusshows (it had found a second opinion) - Sessions on your default account no longer pin its config directory
- Statusline account reads the same org as
/status
[v0.5.34] - 2026-10-14
Section titled “[v0.5.34] - 2026-10-14”- Config directories are only ever ones you added
- “Scan for directories” suggests likely ones, including claude-envs envs
- Directories found before the update stay, hooks and all
- Removing a config directory removes it (a trailing space was keeping it alive)
[v0.5.33] - 2026-10-14
Section titled “[v0.5.33] - 2026-10-14”- Perch no longer adopts a session’s config directory when it starts (it was hiding all the others)
- Re-adding a removed config directory brings it back, trailing space or not
[v0.5.32] - 2026-10-14
Section titled “[v0.5.32] - 2026-10-14”- Todo is one row: checkbox, open count, overdue count
- Clicking the Todo row opens the Todos editor
- Hover the Todo row for the next few items
- Retired the Todo chevron, “+” and per-item lines (the editor has them all)
[v0.5.31] - 2026-10-14
Section titled “[v0.5.31] - 2026-10-14”- Perch sessions can publish artifacts (via a hidden background claude)
- Claude publishes finished pieces itself in Perch sessions
- “Publish as artifact…” on .html, .md and .svg file paths
- Publishes show under their session, not as a stray daemon
- Published artifacts light up the session’s artifact glyph
- “Open in browser” on .html paths (middle-click: new window)
perch artifact publish <file>prints the link
[v0.5.30] - 2026-10-13
Section titled “[v0.5.30] - 2026-10-13”- Hypertree is one row: logo, branch, desktop
- Clicking the Hypertree row opens Hypertree’s map (the branch list has retired)
- Toast when Hypertree is too old to open its map
[v0.5.29] - 2026-10-13
Section titled “[v0.5.29] - 2026-10-13”- Selections in replies start where you click (not at the paragraph’s top)
- Dragging from a code block’s padding copies just the code, no fences
[v0.5.28] - 2026-10-13
Section titled “[v0.5.28] - 2026-10-13”- File paths in replies are clickable, backticks or not
file.cs:42and#L42references open VS Code at that line- Ctrl+click opens any file: Markdown in the viewer, the rest in VS Code
- Linked paths are underlined, with the full path on hover
- “Copy path” on the file right-click menu
- Network shares are still never touched (your password hash stays home)
[v0.5.27] - 2026-10-13
Section titled “[v0.5.27] - 2026-10-13”- Background agents’ reports, as expandable cards on their finish notice
- Long reports pin their header while you scroll
- Reports show in session history and transcript search
- A background agent’s own work no longer poses as Claude’s replies
- Finish notices stay one line (no more entire reports, centred)
- Context bar ignores a background agent’s context
- Sessions stay “running” while an agent writes up (it was thinking, not done)
[v0.5.26] - 2026-10-12
Section titled “[v0.5.26] - 2026-10-12”- Search transcripts: find what was said, in every session ever
- Open it from the tray, or “Search text” in Session history
- Results grouped by session, newest first, match lit up
- Pick a hit and the history opens right on it
- Prompts and replies by default; “Tools & thinking” digs deeper
- Ctrl+F in Session history too
- Jump-to-top/bottom buttons are proper double arrows (the old ones were squinting)
[v0.5.25] - 2026-10-12
Section titled “[v0.5.25] - 2026-10-12”- Long open cards pin their header to the top as you scroll
- Click the pinned header to fold the card back up (and land on it)
- ↑ / ↓ on the pinned header jump to the card’s start or past its end
- Cards inside an open fold pin under the fold’s header (it’s headers all the way down)
[v0.5.24] - 2026-10-12
Section titled “[v0.5.24] - 2026-10-12”- Copying a line out of a code block no longer drags the
```fences along with it - Fences, hashes, list markers and quote bars only come along once a selection leaves its block
[v0.5.23] - 2026-10-12
Section titled “[v0.5.23] - 2026-10-12”- Red chip on an account whose sign-in is about to expire
- Two days’ warning before you’ll need to
/loginagain - Perch sessions warn before their sign-in lapses (they can’t refresh it themselves)
- Usage tooltip lists both sign-in clocks
- Usage tooltip opens beside the overlay, not on top of it
- “Sign-in expiry” setting, for those who prefer surprises
[v0.5.22] - 2026-10-10
Section titled “[v0.5.22] - 2026-10-10”- Session ⋯ menu opens the project folder in Explorer (or Finder)
- …or in a terminal, for when the GUI has had its turn
[v0.5.21] - 2026-10-10
Section titled “[v0.5.21] - 2026-10-10”/clearno longer leaves the old conversation lurking beside the new one- Session account chip shows the session’s own account, asleep or awake
/usageshows the session’s account, not whichever was default
[v0.5.20] - 2026-10-09
Section titled “[v0.5.20] - 2026-10-09”/reload-skillsand/reload-pluginsin session windows/exitends the session (no “are you sure?” — you typed it)
[v0.5.19] - 2026-10-09
Section titled “[v0.5.19] - 2026-10-09”- Resumed sessions reopen under the account they ran under
- Add config directory dialog has Save and Cancel buttons (they existed all along, just never invited)
[v0.5.18] - 2026-10-09
Section titled “[v0.5.18] - 2026-10-09”- Typing
/no longer makes your draft vanish (it was shy) - Skills autocomplete mid-prompt, not just at the start
- Picking a command keeps the rest of your draft
- Pasted images leave an
[Image #N]marker, like the terminal - Deleting a marker removes its image, and vice versa
- Backspace takes a marker whole, not one bracket at a time
- Caret stays at the end of slash commands
[v0.5.17] - 2026-10-09
Section titled “[v0.5.17] - 2026-10-09”- GitHub dashboard redesigned as cards, with more room to breathe
- Hide a PR until it changes (not “Dismiss”; GitHub had dibs)
- Group PRs by repo, reason or role; sort them; hide stale ones
- Start a Claude session straight from a PR, named after it
- Pick how it’s checked out: a new or existing worktree, your checkout, or nothing at all
- New worktrees go where your other worktrees live
- No clone of the repo? Perch makes a fresh one
- Copy command: a terminal one-liner that sets everything up itself (Perch touches nothing)
- Quick prompts per PR, plus your own saved templates
{variables}in prompts are highlighted, with suggestions as you type- Long folder paths keep the folder name when trimmed
[v0.5.16] - 2026-10-08
Section titled “[v0.5.16] - 2026-10-08”- Prompts answered from your phone show as “Answered remotely” instead of waiting forever
- Session status keeps up with turns started over Remote Control (Perch was told nothing; it now asks)
- Shows “awaiting remote” when Claude waits on an answer only the phone can give
[v0.5.15] - 2026-10-08
Section titled “[v0.5.15] - 2026-10-08”- Feeds: follow Atom and RSS as story-style heads on the overlay
- A story player for new posts, with recent history to scroll back through
- Paste a site’s address and Perch finds its feed
- Optional notifications for new posts
- Images per feed, off by default (xkcd comes with them on, for obvious reasons)
- OPML import and export, for refugees from other feed readers
- Feed content is shown as plain text (no scripts, no surprises)
[v0.5.14] - 2026-10-07
Section titled “[v0.5.14] - 2026-10-07”perchin PowerShell or cmd hands the prompt back cleanly (it was there; the cursor just didn’t know)perch --helpandperch --version, which no longer open a sessionperchsays when it’s starting the tray, not only when it’s already running- CLI output survives redirects (
perch configdirs > filewas writing nothing, very confidently)
[v0.5.13] - 2026-10-07
Section titled “[v0.5.13] - 2026-10-07”- Background shells and monitors run live in the session, with output and Stop
- Running background work counted on the overlay and in the Roost (idle is not the same as finished)
- Background tasks finishing show as a quiet line, not XML wearing your name
- Finished background agents no longer look busy forever
- Proper tool cards for Monitor, TaskStop and TaskOutput
[v0.5.12] - 2026-10-07
Section titled “[v0.5.12] - 2026-10-07”- Sub-agents running long tests or builds no longer read as idle (they were busy, just quiet about it)
- “Mark as unread” and “Mark as read” on a session’s menu
[v0.5.11] - 2026-10-07
Section titled “[v0.5.11] - 2026-10-07”\then Enter adds a new line in the session composer, as in the terminal (no more half-sent prompts)
[v0.5.10] - 2026-10-07
Section titled “[v0.5.10] - 2026-10-07”- Long sessions stay responsive (it was redrawing every tool card per word)
- Long threads use a fraction of the memory
- Opened tool cards stay open through a theme change
[v0.5.9] - 2026-10-07
Section titled “[v0.5.9] - 2026-10-07”- Resume estimate knows the cache lasts an hour (it was quoting cold prices for warm sessions, roughly 30× over)
- Stats show costs for Opus 5 and Sonnet 5 (previously “—”, which was optimistic)
- Current model prices, cache reads and hour-long cache writes included
[v0.5.8] - 2026-10-07
Section titled “[v0.5.8] - 2026-10-07”- Sessions no longer stuck on “working…” after a mid-turn message (it had finished; it just wasn’t telling)
- Background tasks reporting back show “running”, then “done” (not “idle”, which was a fib)
- Activity reads “Thinking…” once a tool call returns
[v0.5.7] - 2026-10-06
Section titled “[v0.5.7] - 2026-10-06”- Perch sessions survive Perch closing (exit, update, crash, reboot alike)
- They wait on the overlay and in the Roost, marked “not running”
- Reply to one to pick it up, same model and mode
- Only “End session” removes them (nothing expires on its own)
- “End session” works on not-running sessions too
- Exit and Update ask first if a session is mid-turn
- Resume list stops quoting prices (opening a session is free now)
[v0.5.6] - 2026-10-06
Section titled “[v0.5.6] - 2026-10-06”- GitHub alerts (opt-in): one overlay line for PRs that need you
- Little symbols for reviews, comments, failing checks, conflicts, ready to merge
- Click for the list, grouped by repo, with “Open in GitHub”
- Search the list by title, repo, author or #number
- Opened PRs stop nagging (reviews you owe do not)
- Uses your existing
ghlogin; Perch never touches a token
[v0.5.5] - 2026-10-05
Section titled “[v0.5.5] - 2026-10-05”- Questions from Claude offer “Other” for typing your own answer (the options were suggestions all along)
[v0.5.4] - 2026-10-05
Section titled “[v0.5.4] - 2026-10-05”- Select across headings, paragraphs, lists, code and tables in one drag
- Works in session threads and the Markdown preview
- Copies the Markdown under the selection; plain text is a right-click away
- Selecting a whole message copies exactly what its copy button does
- Ctrl+C on a thread selection copies instead of interrupting (Claude can finish its sentence)
[v0.5.3] - 2026-10-05
Section titled “[v0.5.3] - 2026-10-05”- A Recent (clock) button: lately-ended sessions, cut-off ones first
- A dot on the clock when something was cut off and you haven’t looked
- Filter to interrupted or ended-before-shutdown (for the “close everything and go home” crowd)
- Pick one back up in Perch, resume it in a terminal, or dismiss it
- Reopened sessions show the conversation; Claude waits until you send
- Resume cost estimate is a quiet note above the composer, not a toll booth
- Perch sessions come back after an update, Exit or restart
- Exiting Perch ends its sessions properly, so SessionEnd hooks run
- Roost tabs survive a reboot
- A Recent row at the foot of the Roost rail
- Fixed Exit skipping Perch’s own tidy-up (docked edge included)
- Model pill names the version (“Opus 5.5”); effort pill just says “high”
- Model menu offers each family’s newest; hover › for older ones
- One context bar in place of the token and context pills
- Ctrl+= / Ctrl+− / Ctrl+wheel zoom the session window and Roost
- A 🔍 100% button picks a zoom level, in the session window and the Roost
- Spinning chips for background sub-agents (quiet is not the same as frozen)
- Sub-agents get their own tabs: watch any one’s log live
- Sub-agent tabs are read-only (they only take orders from the session)
- Statusline designer:
session.nametoken for your/renametitle
[v0.5.2] - 2026-10-02
Section titled “[v0.5.2] - 2026-10-02”- The Roost: every session in one window, with a rail sorted by who needs you most
- Open it from the overlay, the tray, or Alt+Shift+R
- Roost tabs, each with its own layout, plus a Focus tab for quick looks
- Paint your own tab layouts (split, remove, drag the dividers) and save the good ones
- Drag sessions between regions and tabs; hold one over a tab to open it mid-drag
- Tabs light up when something in them needs you, so you can stop checking each one like a fridge
- Sort the rail by status or A–Z
- Reply to Perch sessions straight from their pane
- Enter allows a pending permission, Esc denies it (in the pane you picked)
- Take over a terminal session in Perch from its pane
- Close panes you’re done with; reopen them from “N hidden”
- Keyboard shortcuts for tabs, regions and the next session needing you
- No toast for what the Roost is already showing you
- The taskbar flashes when a background Roost has news
- Animations respect your system’s reduce-motion setting
[v0.5.1] - 2026-10-01
Section titled “[v0.5.1] - 2026-10-01”- If you like Perch, a star on GitHub would be swell!
- A “Star Perch on GitHub” button in About and this very window (no pressure)
[v0.5.0] - 2026-09-30
Section titled “[v0.5.0] - 2026-09-30”- A broad security and privacy hardening pass, app and friends backend (details withheld, on purpose)
- Tighter redaction in exported session recordings
- Perch no longer risks clobbering your Claude config on a bad write
- Settings and saved state are written atomically (a crash can’t leave half a file)
- Overlay stays smooth with busy sessions and enormous transcripts
- Overlay repaints cost a fraction of the CPU and memory they used to
- All-time stats load in moments, not tens of seconds
- Long streamed replies no longer slow the session window to a crawl
- Closed session windows actually let go of their session
- Resumed sessions run under the account that owns their transcript
- GitHub sign-in works where Windows had quietly reserved its old ports
- Token counts go up to billions and trillions (we believe in you)
- Huge diffs open fast; files past the first few thousand lines start collapsed
- Session history follows a live transcript without re-reading it
- Image previews load in the background and skip absurdly large images
- Images over 5 MB are refused at attach time, with a note saying why
- Git tree ignores
node_moduleschurn and git’s own housekeeping - Stale sessions no longer linger when Windows reuses their process ID
- One odd entry in the daemon roster no longer empties the daemon strip
- Install and uninstall leave the
%VARIABLES%in your PATH alone
[v0.4.26] - 2026-09-24
Section titled “[v0.4.26] - 2026-09-24”- Check the arcade again (bring a friend, and something to draw with)
[v0.4.25] - 2026-09-23
Section titled “[v0.4.25] - 2026-09-23”- Explicit Save button in the status line designer, with an unsaved-changes indicator
- Saving a profile also updates any live status line already using it
- Revert a status line profile to its last saved state (in case you broke everything)
[v0.4.24] - 2026-09-23
Section titled “[v0.4.24] - 2026-09-23”- Status line bars auto-colour to your context-pressure thresholds (
ctxcolor) - Status line can flag a session on the wrong Claude account for its folder
{{else}}/{{elseif}}branches in status line templates{{#bg:…}}background regions, for warnings you can’t scroll past- New “Account-aware” built-in status line wiring all of that together
- Empty status line rows are dropped (put a character on one you actually meant)
- Perch’s status line config is read best-effort — it still works with Perch uninstalled
- Dev builds stamp a “dev” marker on their status lines (stop debugging the wrong instance)
- Fixed the designer gutter miscounting lines wrapped with a Windows soft break
[v0.4.23] - 2026-09-23
Section titled “[v0.4.23] - 2026-09-23”- Status line tokens for the signed-in account and org, read live per config directory
- The
roundfilter takes decimal places now (round:2), not just whole numbers
[v0.4.22] - 2026-09-22
Section titled “[v0.4.22] - 2026-09-22”- New status line designer — build Claude Code’s status line visually, with a live coloured preview
- Syntax highlighting, autocomplete, and a token explorer while you edit
- Start from a built-in example, or import an existing command (ccstatusline and friends)
- Rate-limit windows colour by pace, matching the usage bars
- Status lines apply as a standalone script — no Perch running at refresh, survives an uninstall
- Apply a different status line to each config directory
- Turn Perch’s hooks and Agent Teams on or off per config directory (the primary stays hooked)
- Open the designer straight from the Config directories page
- Dropped the “read-only” label on config directories (it never actually did anything)
[v0.4.21] - 2026-09-21
Section titled “[v0.4.21] - 2026-09-21”- Retuned the usage bar’s pace colours: green stays longer early on, red arrives the moment you’re over pace
[v0.4.20] - 2026-09-21
Section titled “[v0.4.20] - 2026-09-21”- Session replies render as Markdown while they stream, not only once the whole answer lands
- Streamed text is paced smoothly, so it flows in rather than arriving in bursts
[v0.4.19] - 2026-09-18
Section titled “[v0.4.19] - 2026-09-18”- Runs Claude’s “Do you trust the files in this folder?” check before starting a session (Perch’s headless launch had been quietly skipping it)
- Trust decisions are shared with Claude Code — accept once, either side honours it
- Trusting a folder trusts its subfolders; your home folder never asks
[v0.4.18] - 2026-09-18
Section titled “[v0.4.18] - 2026-09-18”- Choose which Claude account a new session runs under
- The account picker honours guardrails, offering only a folder’s allowed accounts
- A single allowed account locks the picker with a padlock (nothing left to pick)
- Session footer shows which account you’re actually on
- Composer chips wrap to a second line instead of quietly running off the edge
[v0.4.17] - 2026-09-18
Section titled “[v0.4.17] - 2026-09-18”- Delete your Social account and all your data, for good (GDPR erasure, behind a type-your-handle prompt)
- Export your Social data to a JSON file
- Social keeps only your current status now — the post history it never showed you is gone
- Added a privacy policy, a support email, and links to both from the About page
- Moved Sign out up beside Post, Friends and Change handle
[v0.4.16] - 2026-09-17
Section titled “[v0.4.16] - 2026-09-17”- Choose how long friends’ statuses stay visible (the old 12 hours was stingy; now 2 days)
[v0.4.15] - 2026-09-17
Section titled “[v0.4.15] - 2026-09-17”- Collapse any usage account to a compact chip, or expand it back
- Known idle accounts appear as chips, polled quietly in the background
- Usage bars colour by pace, not raw level — behind green, near yellow, over red
- Credits bar still colours by actual spend (dollars don’t have a pace)
- Expected-rate marker is always on — it was never worth a toggle
[v0.4.14] - 2026-09-17
Section titled “[v0.4.14] - 2026-09-17”- Account guardrails: flag sessions signed into the wrong Claude org
- Bind a directory to the accounts allowed under it (Config directories settings)
- Wrong-account rows get an aggressive pulsing-red outline (subtlety was not the goal)
[v0.4.13] - 2026-09-17
Section titled “[v0.4.13] - 2026-09-17”- Session composer shows the current git branch, beside the permission mode
- Branch pill flags how far ahead or behind its upstream you are
[v0.4.12] - 2026-09-17
Section titled “[v0.4.12] - 2026-09-17”- Fixed the “Claude is asking” card spilling its question off the page (it now wraps, politely)
- Right-click a recent session to copy its ID
[v0.4.11] - 2026-09-16
Section titled “[v0.4.11] - 2026-09-16”- Perch-controlled sessions surface their background sub-agents on the overlay (they’d been working unseen)
- Session window gained a “Running” strip of the sub-agents working right now
[v0.4.10] - 2026-09-16
Section titled “[v0.4.10] - 2026-09-16”- Session windows launched from the CLI come to the front, as intended
- Fixed the composer caret drifting from your text on long, scrolling messages
- Artifact glyph works again for newly published artifacts (claude.ai moved the URLs; we caught up)
[v0.4.9] - 2026-09-16
Section titled “[v0.4.9] - 2026-09-16”- Usage bars split per org — a set per account in use, plus the default
- Condensed the bar labels to 5h / 7d / F / $
- Dropped the currency code from the credits bar (the “$” already gives it away)
- Hovering a set shows only that org’s usage
- Config dirs sharing one account collapse to a single set
[v0.4.8] - 2026-09-16
Section titled “[v0.4.8] - 2026-09-16”- Config directories show which org each one is signed into
- Hover a session’s directory chip to see its org
[v0.4.7] - 2026-09-16
Section titled “[v0.4.7] - 2026-09-16”- Inline
codereads as coloured text, not a black highlighter block - Consecutive Read, Grep and Glob calls fold into one line (“Searched for 3 patterns, read 1 file”)
- Jump to next prompt no longer snaps back to the one you just jumped from
[v0.4.6] - 2026-09-11
Section titled “[v0.4.6] - 2026-09-11”- Perch watches every Claude Code config directory, not just ~/.claude
- Sessions and transcripts are found and attributed across all of them
- Session rows show which config directory they belong to (when you run several)
- New Config directories settings page to add, rename, or remove them
- Launcher-style per-org directories auto-discovered; declare unusual ones by hand
- “Config labels” toggle to hide the directory chips (the default directory never had one)
[v0.4.5] - 2026-09-11
Section titled “[v0.4.5] - 2026-09-11”- Session history now renders in the rich session UI — bubbles, tool cards, diffs, Markdown
- File paths in a viewed transcript are clickable (open, diff, reveal)
- Session-history search is a command palette — filter by name, path or id
- Session history shows a header for the open session, full id and all
- Session jump buttons stay put and gained start/end (they’d been playing musical chairs)
- Retired the raw-JSON history view (the readable one had made it redundant)
perchfrom Git Bash hands your prompt back (it had been quietly holding mintty hostage)
[v0.4.4] - 2026-09-10
Section titled “[v0.4.4] - 2026-09-10”- Session tool calls read like the terminal: Edit and Write show a diff, not raw JSON
- Expanding a tool card reveals formatted output, never the underlying JSON
- Read, Grep and Glob cards summarise their result at a glance (“Read 42 lines”, “12 files”)
- Full tool output is one click away — the 60-character teaser has been retired
[v0.4.3] - 2026-09-10
Section titled “[v0.4.3] - 2026-09-10”- Session context gauge no longer counts each turn’s cache re-reads as fresh context (it was, eagerly)
- Long one-line code blocks stop hiding behind their own scrollbar
- A terminal-launched session opens on the monitor the terminal is on
perchhands the terminal back its prompt instead of holding it hostage until you quit
[v0.4.2] - 2026-09-10
Section titled “[v0.4.2] - 2026-09-10”/remote-control(/rc) connects a Perch session to your phone or claude.ai, QR and all/usageopens as its own panel — usage bars with reset countdowns, not a wall of chat- Search the conversation with Ctrl+F
- Composer glyphs for pull requests, Jira tickets, notifications and remote control
- A “…” menu on the composer to switch those on when they aren’t showing
- Typing
perchin a terminal opens a session right there
[v0.4.1] - 2026-09-07
Section titled “[v0.4.1] - 2026-09-07”- Session composer draws its own attach paperclip, not the one that was basically Clippy
- Dropped the to-do checkbox from the session composer (to-dos were never project-scoped)
- The session composer’s note now belongs to its project, not the global scratch pad
[v0.4.0] - 2026-09-07
Section titled “[v0.4.0] - 2026-09-07”Experimental — a Perch-native window for running Claude Code sessions. It does a lot and is rough in places; treat it as a preview, not a promise.
- Start or resume Claude Code sessions in a Perch window (searchable projects + recents)
- Streaming replies, thinking, and tool calls, as they land
- Permission prompts as proper cards — allow, deny, or switch mode
- Plan-mode approval — review the plan, then approve or keep planning
- Answer Claude’s questions by clicking, not by guessing the syntax
- Model, effort, and permission-mode pills, switchable mid-session
- Slash-command palette — /clear, /compact, /rename, /resume, /mcp and the rest
- Mention files with @, recall past prompts with ↑, copy any message
- Attach, paste, or drag in images; images from a resumed session show inline
- A changed-files panel with git diffs, beside the conversation
- Jump to the latest reply, or back to your previous prompt
- A desktop nudge when a backgrounded session needs a decision
- Open sessions straight from a terminal:
perch --resume,perch <dir> - Perch-run sessions sit in the normal session list, marked as yours
[v0.3.75] - 2026-08-27
Section titled “[v0.3.75] - 2026-08-27”- IDE and Claude Desktop sessions show the host app’s icon as their status dot, tinted to the status colour
- The host is sniffed from the process tree (the session file wasn’t telling)
- New “IDE status icons” setting toggles it, on by default
[v0.3.74] - 2026-08-27
Section titled “[v0.3.74] - 2026-08-27”- Clicking a session now focuses terminals Windows Terminal adopted from outside itself
- Sessions with no window on screen say so, instead of quietly focusing the desktop
[v0.3.73] - 2026-08-27
Section titled “[v0.3.73] - 2026-08-27”- Check the arcade
- A settings file that won’t fully parse is salvaged value-by-value instead of reset
- Dev tooling can no longer overwrite the real settings file (it kept re-running the Quick Start; it knows what it did)
- Settings saves are atomic, and a briefly locked settings file no longer reads as a fresh install
[v0.3.72] - 2026-08-26
Section titled “[v0.3.72] - 2026-08-26”- Docked column keeps the right height when the display scale changes, including over Parsec and RDP
- Docked mode no longer borrows dense mode’s hover-to-expand (it was never invited)
[v0.3.71] - 2026-08-26
Section titled “[v0.3.71] - 2026-08-26”- A dot on the Friends header flags a status you haven’t seen yet
- Dismiss a friend’s status to hide it until they post again
- Statuses older than 12 hours drop off the roster (there is a freshness window)
- The status mood picker now uses the same emoji search and recents as reactions
- A setting value the app can’t read no longer resets all the others, or re-runs onboarding (it was a trap)
[v0.3.70] - 2026-08-26
Section titled “[v0.3.70] - 2026-08-26”- “View git history…” always sits on a repo’s right-click menu now — no toggle to hunt for
- Git tree’s diff options (split, light mode, hunk staging) live in the window’s own toolbar, not global settings
- Retired the git tree “wrap lines” setting (it always wrapped anyway)
[v0.3.69] - 2026-08-26
Section titled “[v0.3.69] - 2026-08-26”- Perch’s own emoji picker for reactions — no more detour through the Windows dialog
- Opens on your recently-used emoji (popular picks until you build a history)
- Search the whole cross-platform emoji set by name, keyword or shortcode (
fire,tada,+1) - Type or paste any emoji directly; Enter picks the top match
- Closing the first-run Quick Start now counts as done, instead of nagging every launch
[v0.3.68] - 2026-08-26
Section titled “[v0.3.68] - 2026-08-26”- Hover a status reaction to see who reacted — up to 10 handles, then a “+N more”
- “Sign in with a different account” opens a private window, so GitHub actually asks which one
- Sign-in shrugs off a brief backend clock skew instead of failing every request
- A stubborn “JWT issued at future” now shows a clear “Timestamp drift” state (it’s the server’s clock, not you)
[v0.3.67] - 2026-08-25
Section titled “[v0.3.67] - 2026-08-25”- Guided Quick Start on first launch — a tour of the overlay, then pick a starting feature set
- Basic, Intermediate, or the full kitchen sink (fine-tune any switch before committing)
- The tour shows a live overlay preview, so the dot-points aren’t just words
- Choose up front whether the overlay floats or docks to a screen edge (Windows)
- Re-run it any time from Settings → Getting started; your later tweaks survive
[v0.3.66] - 2026-08-24
Section titled “[v0.3.66] - 2026-08-24”- No more premature “done” when a background agent finishes — Perch waits for the session to actually stop
[v0.3.65] - 2026-08-24
Section titled “[v0.3.65] - 2026-08-24”- Reorder the overlay’s sections by dragging them around the Settings preview
- Reset the arrangement to default (for when the reordering got away from you)
- The live preview scrolls on its own, and admits when there’s more below
[v0.3.64] - 2026-08-24
Section titled “[v0.3.64] - 2026-08-24”- Emoji sit properly centred in mood tiles, chips, and the reaction picker
- The reaction picker no longer clips at its edges
- Floating overlay stops sliding sideways when it collapses or expands (macOS)
- Achievement cards no longer spill off the screen (macOS)
- Docked mode is hidden on macOS (the OS won’t let an app reserve a screen edge)
- The macOS installer DMG looks like an installer now — a drag-to-Applications backdrop, not a bare folder
[v0.3.63] - 2026-08-21
Section titled “[v0.3.63] - 2026-08-21”- React to a friend’s status with any emoji, not just the preset ten
- Reaction presets show as a grid now, instead of a scrolling list
- Set your status mood to any emoji you type or paste (Win + . still obliges)
[v0.3.62] - 2026-08-21
Section titled “[v0.3.62] - 2026-08-21”- Docked column re-fits its height when the resolution changes (it used to hang under the taskbar)
- A taskbar resize or move nudges it back into place too
- Detection is event-driven now, so nothing polls while the display sits still
[v0.3.61] - 2026-08-21
Section titled “[v0.3.61] - 2026-08-21”- Notes are per-project now, shared by every session in a directory
- Per-session notes are gone (no more losing a note when the session ends)
- Sticky notes open small and grow to fit as you write (corner-drag still wins)
[v0.3.60] - 2026-08-21
Section titled “[v0.3.60] - 2026-08-21”- Drag either edge to widen the floating overlay (280 px is no longer the whole world)
- The docked column resizes too, from its open inner edge
- Set the resting width in “Set initial placements…” by dragging the preview’s edge
- Live resizes are temporary; “Reset size” in the header menu restores the set width
[v0.3.59] - 2026-08-21
Section titled “[v0.3.59] - 2026-08-21”- Select text across the Markdown preview and copy it, VS Code-style (it was decorative before)
- Right-click a preview selection for “Copy as Markdown” (the underlying source)
[v0.3.58] - 2026-08-21
Section titled “[v0.3.58] - 2026-08-21”- Quiet mode: mute the fun/social/silly features for a while (right-click the header)
- The perch dozes off while it’s on (💤)
[v0.3.57] - 2026-08-20
Section titled “[v0.3.57] - 2026-08-20”- Autonomous section header restyled to match Todo and Friends (consistency, at last)
- Clicking an autonomous session no longer un-hides a stray window (it says there’s nothing to open, and means it)
[v0.3.56] - 2026-08-20
Section titled “[v0.3.56] - 2026-08-20”- Claude Desktop sessions now list with your live ones, marked with a monitor glyph (they’d been filed under autonomous bots)
- Jump-to and the session switcher now reach Claude Desktop sessions
- Focusing one raises Claude Desktop, opening it first if it’s closed to the tray
[v0.3.55] - 2026-08-20
Section titled “[v0.3.55] - 2026-08-20”- Fixed the context thermometer sizing Fable to 200k (it has a million, like Opus and Sonnet 5)
[v0.3.54] - 2026-08-20
Section titled “[v0.3.54] - 2026-08-20”- Todos: your own reminders with a title, notes, and an optional due time (off by default)
- An opt-in “Todo” overlay section, above the sessions - what’s next, and how overdue you are (off by default)
- A two-pane Todos window: triage on the left, read the notes on the right
- Desktop nudge when a todo falls due (once per item, not a nag)
- Right-click a todo to complete it; open the list from the tray or a session menu
[v0.3.53] - 2026-08-20
Section titled “[v0.3.53] - 2026-08-20”- Big reactions: a friend’s reaction to your status wobbles up the screen as a poppable bubble
- See the reactions friends leave on your own status
- Remove a friend outright, not just block them
- Change your handle without losing your friends
- Duplicate friend requests are no longer possible (existing duplicates deduped)
- Fixed Do Not Disturb reading as “on” when it wasn’t (it had been quietly eating your notifications)
[v0.3.52] - 2026-08-20
Section titled “[v0.3.52] - 2026-08-20”- New Docked mode: the overlay reserves a screen-edge column maximized windows can’t cover (your top-right corner is yours again)
- Switch floating/docked from Settings or the header right-click menu
- Collapse/expand the docked column via hotkey, the header, or the bottom toggle
- Drag the docked header to re-dock it to another edge or monitor
- Docked side is set in the initial-placement editor
[v0.3.51] - 2026-08-20
Section titled “[v0.3.51] - 2026-08-20”- Find & Replace in the Markdown editor (Ctrl+H)
- Match case, regex, and preserve-case replace — VS Code’s whole trick
- Replace All undoes in a single step (Ctrl+Z, no regrets)
[v0.3.50] - 2026-08-20
Section titled “[v0.3.50] - 2026-08-20”- Settings, History and the Markdown viewer now open on your current virtual desktop, instead of dragging you off to theirs
[v0.3.49] - 2026-08-20
Section titled “[v0.3.49] - 2026-08-20”- Markdown viewer’s file list updates live as files are added or edited
- New or edited files get a marker until you open them
- Open Markdown files reload cleanly on save — no more “Couldn’t read” mid-save flinch
[v0.3.48] - 2026-08-20
Section titled “[v0.3.48] - 2026-08-20”- The Social feed now ships wired up — the release build finally hands it its keys (it had been all dressed up with nowhere to connect)
[v0.3.47] - 2026-08-19
Section titled “[v0.3.47] - 2026-08-19”- New opt-in Social feed — a little corner for friends who run Claude Code too
- Off by default; not a single network call until you turn it on
- Sign in with GitHub, claim a handle — no password, and your email never touches Perch
- Add friends by exact handle; mutual, with no browsable directory to wander into
- A collapsible friends roster under the overlay: each friend’s mood, handle, latest status and time
- Post your own status, mood and all, from a searchable emoji picker
- React to a friend’s status with an emoji (one each; a crowd folds into a count with the tally on hover)
- A friend changing their status gives their row a quiet glow
- Optional “@x just posted” nudge, and a friends-shown count you can dial down
- Auto-collapses in Do Not Disturb (it can read the room)
- Block and report, enforced in the database rather than politely requested
[v0.3.46] - 2026-08-18
Section titled “[v0.3.46] - 2026-08-18”- Find-in-page in the Markdown viewer (Ctrl+F), the current match picked out from the rest
- Searches whichever pane you’re in — source or preview — and switches on demand
- The Markdown editor’s text cursor is visible in dark mode now (it had been hiding)
[v0.3.45] - 2026-08-18
Section titled “[v0.3.45] - 2026-08-18”- Markdown preview tucks SKILL.md-style frontmatter into a collapsed “Preamble” block (it used to spill out as garbled text)
[v0.3.44] - 2026-08-18
Section titled “[v0.3.44] - 2026-08-18”- Redesigned the Git tree around bordered cards with room to breathe
- Moved its light/dark toggle up to the header (it had been loitering in the floating bar)
- Diffs read on a lighter paper surface in dark mode too, not just light
[v0.3.43] - 2026-08-18
Section titled “[v0.3.43] - 2026-08-18”- Syntax highlighting in the Markdown source editor, not just the preview
- Redesigned the Markdown viewer around bordered cards with room to breathe
- Click a block in one pane to line the other up to the same spot
- Revert button in the Markdown editor, for when undo won’t reach the whoops
- The Markdown editor shows a text cursor now (it had been posing as a button)
- Sharper light and dark reading colours across the Markdown viewer and Git tree
[v0.3.42] - 2026-08-18
Section titled “[v0.3.42] - 2026-08-18”- Light mode: a new Daylight theme, plus light versions of every palette
- Recolour the status glyphs (running, error, the lot) in the theme designer — contrast-checked as you go
[v0.3.41] - 2026-08-18
Section titled “[v0.3.41] - 2026-08-18”- Seven new eye-friendly colour themes: Nord, Gruvbox, Solarized, One, Tokyo Night, Rosé Pine, Sepia
- Status hues stay fixed across all of them (green still means running)
[v0.3.40] - 2026-08-17
Section titled “[v0.3.40] - 2026-08-17”- Two-way cursor sync between the Markdown editor and its preview
- Click a preview block to jump the editor there, ready to edit
- A left gutter bar marks the block you’re on, in both panes
[v0.3.39] - 2026-08-17
Section titled “[v0.3.39] - 2026-08-17”- Task-list checkboxes render as rounded, ticked boxes instead of flat squares
[v0.3.38] - 2026-08-17
Section titled “[v0.3.38] - 2026-08-17”- Syntax highlighting in the Markdown preview’s code blocks, keyed off the fence language (bash, python, and a couple dozen friends)
- Comments in those blocks sit back in grey, so the eye lands on the code
[v0.3.37] - 2026-08-17
Section titled “[v0.3.37] - 2026-08-17”- Markdown viewer now leads with the files a session touched, not the whole project
- “Search all project files…” opens a VS Code-style fuzzy quick-open (by name or path)
[v0.3.36] - 2026-08-14
Section titled “[v0.3.36] - 2026-08-14”- Clicking the perch icon a few times does even more now (no, we won’t say why)
[v0.3.35] - 2026-08-14
Section titled “[v0.3.35] - 2026-08-14”- New Markdown viewer/editor, from a session’s “Markdown files…” right-click item
- Lists the .md a session produced or referenced, plus a searchable project tree (it respects .gitignore)
- Split source editor beside a live, VS Code-style rendered preview
- Save, with a heads-up if the file changed on disk while you weren’t looking
- Per-window light/dark, and a separate preview theme (paper-white by default)
- Right-click a file to copy its path or open it in VS Code
- Optional glyph marking sessions that produced a .md (off by default)
[v0.3.34] - 2026-08-14
Section titled “[v0.3.34] - 2026-08-14”- Fixed black fringing around the “Achievement Unlocked!” text (ClearType, meet transparency)
[v0.3.33] - 2026-08-14
Section titled “[v0.3.33] - 2026-08-14”- Try clicking the perch icon a few times (no, we won’t say why)
[v0.3.32] - 2026-08-14
Section titled “[v0.3.32] - 2026-08-14”- Fixed quick-link icons rendering mirror-image (they were being rotated, not un-flipped)
[v0.3.31] - 2026-08-13
Section titled “[v0.3.31] - 2026-08-13”- Fixed the monthly spend bar reading 100x too high (it was counting cents as dollars)
- Large spend and limit amounts abbreviate to 140k / 1.4M
- Currency code on the spend bar, since a “$” alone won’t tell AUD from USD
[v0.3.30] - 2026-08-13
Section titled “[v0.3.30] - 2026-08-13”- Optional “Monthly spend” bar tracking this month’s extra-usage spend against your limit
- Off by default, and only appears when your account has extra usage switched on
[v0.3.29] - 2026-08-13
Section titled “[v0.3.29] - 2026-08-13”- Fixed the floating overlay clipping its bottom rows after a drag (the drag never knew it had ended)
[v0.3.28] - 2026-08-12
Section titled “[v0.3.28] - 2026-08-12”- Added “Whoops” achievements for prompts you cancel and re-type (we all do it)
[v0.3.27] - 2026-08-12
Section titled “[v0.3.27] - 2026-08-12”- Fixed task checklists reading 0-done when they weren’t (the tool renamed its fields; we hadn’t noticed)
[v0.3.26] - 2026-08-12
Section titled “[v0.3.26] - 2026-08-12”- Fixed brand, status and Jira colours rendering black on older custom themes
- Themes only store the colours you can actually change now (the fixed ones moved out)
[v0.3.25] - 2026-08-12
Section titled “[v0.3.25] - 2026-08-12”- Jira ticket glyph on sessions whose branch carries a key like SFTY-1234, linking straight to the issue
- Derived from the branch name alone - no Jira API, no credentials, no cache
- Point it at your Jira site and optionally filter to specific project keys
- Painted in Jira’s brand blue, so it reads as a link rather than a status
[v0.3.24] - 2026-08-11
Section titled “[v0.3.24] - 2026-08-11”- Hovering the last session row no longer pokes its corners past the panel’s rounded edge
[v0.3.23] - 2026-08-09
Section titled “[v0.3.23] - 2026-08-09”- Open a session’s repo in GitKraken from its right-click menu, when GitKraken’s CLI is on PATH (it comes forward on its own, no console in tow)
[v0.3.22] - 2026-08-09
Section titled “[v0.3.22] - 2026-08-09”- PR status now follows branch switches, dropping the old branch’s PR immediately (no more clinging to it for five minutes)
[v0.3.21] - 2026-08-08
Section titled “[v0.3.21] - 2026-08-08”- New git-tree window replaces “Review changes”: a branch-scoped commit graph, its files, and the diff (from a session’s “View git history…”)
- Stage, unstage, or discard by whole file, hunk, or selected lines
- Working tree splits into “Changes” and “Staged · pending commit” — commit inline, with Stage all / Unstage all
- Floating diff bar: Unified / Split / Hunk layout (defaults to Split), Diff / Previous / Current views, and a per-window light/dark toggle
- Select diff text from anywhere — line ends, gutters, the dead space past a short line
- Session right-click menu reorganised around everyday actions; “View tree…” is now “View git history…”
- Removed the confetti finish feature (the party, briefly fun, is over)
[v0.3.20] - 2026-08-07
Section titled “[v0.3.20] - 2026-08-07”- Middle-click a link (PR, incident, artifact, status, QR) to open it in a fresh browser window
- That window lands on your current virtual desktop, instead of teleporting you to wherever the last one was
[v0.3.19] - 2026-08-07
Section titled “[v0.3.19] - 2026-08-07”- Dense-strip status changes can be a fading speech bubble instead of an expand
- The bubble drifts off the perch logo with a status dot and label
- Hover or click to dismiss it early
- Expand stays the default (your strip won’t start blowing bubbles unasked)
[v0.3.18] - 2026-08-07
Section titled “[v0.3.18] - 2026-08-07”- A bottom-parked overlay anchors by its header, so it stops leaping about as sessions come and go
[v0.3.17] - 2026-08-07
Section titled “[v0.3.17] - 2026-08-07”- Overlay drags now actually stick, so a dense-mode toggle returns it where you left it (v0.3.16 meant well)
- Screen and resolution changes hold the overlay’s distance from its nearest corner, clamped so the header stays reachable
[v0.3.16] - 2026-08-07
Section titled “[v0.3.16] - 2026-08-07”- Fixed the overlay jumping to an old spot when you toggle dense mode on a small screen (it now stays where you left it)
[v0.3.15] - 2026-08-06
Section titled “[v0.3.15] - 2026-08-06”- Alerts when a tracked PR is merged, closed, reviewed, or approved
- Review and approval alerts name who did it (credit where due)
- A full-row overlay banner for the same, for when a toast is too easy to miss
- Toast, chime, and banner are each their own toggle (all on by default)
- Every PR alert leads with “PR:”, in case the giant coloured banner was unclear
[v0.3.14] - 2026-08-06
Section titled “[v0.3.14] - 2026-08-06”- Locked-screen ntfy pushes now start with “AFK” (so you know why your phone buzzed)
[v0.3.13] - 2026-08-06
Section titled “[v0.3.13] - 2026-08-06”- Overlay keeps its distance from the screen edges when you dock, undock, or change resolution
- No longer drifts toward the middle after a large-to-small-to-large monitor swap (it liked it there)
[v0.3.12] - 2026-08-06
Section titled “[v0.3.12] - 2026-08-06”- The app holding your mic no longer doubles as “now playing” media
- Teams stops moonlighting as a music player mid-call (Zoom and Webex too)
[v0.3.11] - 2026-08-06
Section titled “[v0.3.11] - 2026-08-06”- PR checks no longer clutter the session list as child rows
- They live in the PR glyph’s dot, its hover tooltip, and its click menu (where they belonged all along)
[v0.3.10] - 2026-08-06
Section titled “[v0.3.10] - 2026-08-06”- Set where the overlay first appears by dragging a preview around
- Place the floating panel and the dense strip separately
- Measured from the nearest corner, so it survives a resolution change
- Reset to defaults per mode, when the dragging gets away from you
- Open it from the header right-click menu or the new placement setting
[v0.3.9] - 2026-08-06
Section titled “[v0.3.9] - 2026-08-06”- Edit a custom theme after saving it (creating one is no longer a one-way door)
- Theme designer’s Save/Cancel stay pinned; the preview scrolls instead of shoving them off-screen
- Text on accent-coloured buttons flips black or white, whichever you can actually read
[v0.3.8] - 2026-08-06
Section titled “[v0.3.8] - 2026-08-06”- Right-click the note button to search across all your projects
- Pin a note to any of them without starting a session first
- Ones already carrying a note float to the top, previewed
- Same spotlight chrome as the session switcher (they’re cousins now)
[v0.3.7] - 2026-08-05
Section titled “[v0.3.7] - 2026-08-05”- A status dot on the PR glyph — green, red, or blue — for its CI checks
- Hover it for each check, coloured by pass / fail / still-running
- Click it to open any check’s logs straight from the menu
- Or list the checks inline as session child rows — new “PR checks” toggle
- Glyph tooltips wait a beat longer before popping (brushing past no longer flickers)
[v0.3.6] - 2026-08-05
Section titled “[v0.3.6] - 2026-08-05”- Six colour themes on a new Appearance page — Midnight, Ember, Blush, Dim, High Contrast, and a Winamp tribute that has no business looking this good
- Switching theme recolours the whole app at once: overlay, settings, every window
- A theme designer — re-tint the chrome, pick an accent, live WCAG contrast readout with a one-click “Fix”
- Accent picker is a proper spectrum-and-hue colour map
- Colour-blind preview (protanopia / deuteranopia / tritanopia), so status colours don’t blur into one
- Save custom themes, and copy one to the clipboard as a code you can paste back to import
- Keyboard focus is finally visible on the settings toggles (Space or Enter flips them)
- The overlay’s muted text was quietly failing contrast; it isn’t anymore
[v0.3.5] - 2026-08-05
Section titled “[v0.3.5] - 2026-08-05”- New read-only Change Review, from a session’s right-click menu (on by default)
- Working-tree changes and recent commits, each with its own diff
- Unified or split diffs, with a wrap toggle and line numbers
- Ctrl+F find highlights every match, the current one loudest
- Collapsible file sections, for folding a big diff away
- Select text across lines, or whole line ranges by number, and copy
- Auto-refreshes as the working tree changes, keeping your scroll position
- Flags BOM- or line-ending-only changes with ≈ (git sees them; you can’t)
[v0.3.4] - 2026-08-05
Section titled “[v0.3.4] - 2026-08-05”- New achievement: swear in your prompts 10 times for Fowl Mouthed, 100 for Like a Sailor (it counts; it does not judge)
[v0.3.3] - 2026-08-05
Section titled “[v0.3.3] - 2026-08-05”- Dense-mode hotkey no longer collapses the preview while you’re hovering it (it would just pop back)
[v0.3.2] - 2026-08-05
Section titled “[v0.3.2] - 2026-08-05”- Flight path now tells “waiting for input” apart from “done and idle” (the old bar meant either)
- Flight path lanes show active, waiting, and idle time, plus a day total
- API errors marked on the flight path, status code and all (529, an old friend)
[v0.3.1] - 2026-08-05
Section titled “[v0.3.1] - 2026-08-05”- Dense-mode hotkey now dismisses the popped-open list preview before leaving dense (a second press still exits)
[v0.3.0] - 2026-08-04
Section titled “[v0.3.0] - 2026-08-04”- Rebuilt Settings around a searchable catalogue of every feature
- Live overlay preview docked in Settings, updating as you toggle
- Retired the old per-topic settings pages (your settings carry over)
- Dropped the Experimental section; Agent Teams joins the catalogue
- Media controller now toggles from Settings, not the overlay menu
- Project-only note glyph dimmed (an inherited note needn’t shout)
- Note glyph opens on click; the hover tooltip that fought it is gone
[v0.2.39] - 2026-08-04
Section titled “[v0.2.39] - 2026-08-04”- Achievements window opens wider — three trophies across by default
- Search box filters the wall live;
?rounds up just the mystery tiles - Trophies group by theme instead of scattering across tiers, each section keeping its own tally
[v0.2.38] - 2026-08-04
Section titled “[v0.2.38] - 2026-08-04”- Achievement cards and toasts now spell out the criteria that fired them (“1M input tokens”)
- The level number moves to a dimmer second line, no longer the whole story
[v0.2.37] - 2026-08-03
Section titled “[v0.2.37] - 2026-08-03”- GitHub pull-request glyph on session rows, coloured by state (open, draft, merged, closed)
- Click it to open the PR in a browser (title, state and number in tow)
- New “GitHub pull requests” toggle under Settings → Integrations, off by default
- Uses the
ghCLI you’re already signed into; nothing runs while it’s off - Configurable check interval (default 5 minutes); a missing PR is remembered just as long
[v0.2.36] - 2026-08-03
Section titled “[v0.2.36] - 2026-08-03”- Roughly halved memory use by switching the overlay to software rendering
- Retired the ambient screen-edge glow (an experiment nobody switched on)
[v0.2.35] - 2026-07-30
Section titled “[v0.2.35] - 2026-07-30”- New “daemon” section: Claude Code’s headless background workers, under the session rows
- Clicking one opens an options menu — there is no terminal window to focus (we checked)
- Five rows at most; “show +N more” opens the full list in its own window
- Spare workers are hidden (pre-warmed, perpetually idle, not news)
- Daemon workers stay out of the header counts and never fire notifications
- “Display daemon processes” toggle under Settings → Indicators, on by default
- Fixed the one-line installer on stock Windows PowerShell 5.1
[v0.2.34] - 2026-07-29
Section titled “[v0.2.34] - 2026-07-29”- One-line Windows install:
irm https://raw.githubusercontent.com/ArcticGizmo/perch/main/install.ps1 | iex - Releases ship
SHA256SUMS.txt; a download that doesn’t match is deleted, not run - Still no SmartScreen wall, and updates stay in-app where they belong
- Removed Scoop support (a bold same-day experiment): updating meant leaving the app
[v0.2.33] - 2026-07-29
Section titled “[v0.2.33] - 2026-07-29”scoop install perch, with no SmartScreen wall to click past- Perch knows how it was installed, and won’t update what Scoop owns
- Scoop copies still hear about new versions, command included (one click to copy)
scoop uninstall perchclears the hooks and login entry, like the real uninstaller
[v0.2.32] - 2026-07-29
Section titled “[v0.2.32] - 2026-07-29”- The mic strip is one line now: which app has your microphone, click it to go there
- Removed Teams call controls and every mute button (a bold four-hour experiment)
[v0.2.31] - 2026-07-29
Section titled “[v0.2.31] - 2026-07-29”- Auto Start Perch: never, when a session starts, or when you log in
- Starting at login is Windows’ job now, so Perch is up before the first session
- Your old auto-start setting carries over (it becomes “when a session starts”)
[v0.2.30] - 2026-07-29
Section titled “[v0.2.30] - 2026-07-29”- Limits, quick links and Hypertree stay put with no sessions running
- Only the Claude rows go missing, there being none to show
- The header chevron expands and collapses at zero sessions too
- Dense hover popup no longer clips the microphone strip
[v0.2.29] - 2026-07-28
Section titled “[v0.2.29] - 2026-07-28”- New microphone strip: which app is currently using your mic
- Names Slack, Zoom, browser tabs and OBS too, not just Teams
- Click the app’s name to jump to it, virtual desktops included
- Mute from the strip — the capture device, or Teams itself when connected
- Opt-in Teams call controls: real meeting state, and a mute Teams agrees with
- Settings checks whether Teams’ third-party API is switched on (it usually isn’t)
[v0.2.28] - 2026-07-28
Section titled “[v0.2.28] - 2026-07-28”- Clicking a session with a hidden terminal window un-hides it
- Previously the click did nothing, quietly
- A session with no window left to focus says so
- New “Terminate session…” on the row right-click menu, with a confirmation
- It re-checks the PID before killing anything (the desktop app is also claude.exe)
[v0.2.27] - 2026-07-28
Section titled “[v0.2.27] - 2026-07-28”- The panel keeps its expanded state when the last session ends
- Previously it collapsed itself and hid the chevron you’d need to undo that
[v0.2.26] - 2026-07-28
Section titled “[v0.2.26] - 2026-07-28”- Hypertree rows with more than one desktop gain a chevron on their label
- Click it to pick a desktop, rather than always taking the resume point
- The rest of the line still jumps where it always did
[v0.2.25] - 2026-07-27
Section titled “[v0.2.25] - 2026-07-27”- New red “API error” status when a session’s last request fails (e.g. 529 Overloaded)
- A failed run no longer masquerades as a cheerful “done”
- Shows the HTTP code on the row (“api 529”), with its own notification and chime toggle
- Clears itself the moment the session retries and recovers
[v0.2.24] - 2026-07-27
Section titled “[v0.2.24] - 2026-07-27”- Optional Hypertree integration: your desktop branches under the quick links, click to jump
- The branch you’re on is marked, and stays marked when you switch desktops outside Perch
- Settings grows an Integrations page (a population of one, for now)
[v0.2.23] - 2026-07-25
Section titled “[v0.2.23] - 2026-07-25”- Context pressure sizes the window from the evidence, not a table of model names
- Opus 5 on the 1M beta stops reading as 200k (it was inventing five times the pressure)
- Context tooltip names the model and where its window came from, for when it’s still wrong
[v0.2.22] - 2026-07-25
Section titled “[v0.2.22] - 2026-07-25”- Per-model weekly limits in the usage strip (Fable’s was there all along)
[v0.2.21] - 2026-07-24
Section titled “[v0.2.21] - 2026-07-24”- Renamed the macOS DMG to a stable
Perch-osx-arm64.dmg(the version was just noise). - Dropped the portable .zip builds from releases (nobody was reaching for them).
[v0.2.20] - 2026-07-23
Section titled “[v0.2.20] - 2026-07-23”- Now-playing media strip on the overlay, with previous / play-pause / next.
- Toggle it from Settings → Music or the header right-click menu (off by default).
[v0.2.19] - 2026-07-23
Section titled “[v0.2.19] - 2026-07-23”- Token achievements split into Input, Output, and Cached milestones.
- Retired the lumped “total tokens” trophy (it just measured cache reads).
[v0.2.18] - 2026-07-23
Section titled “[v0.2.18] - 2026-07-23”- The floating overlay finds its way home when you undock — no more hiding on a monitor that left.
- Expanding or collapsing re-asserts the overlay as topmost, in case a display change buried it.
[v0.2.17] - 2026-07-23
Section titled “[v0.2.17] - 2026-07-23”- Clicking the “update available” toast now starts the update, not just the button.
- Reworded the toast to admit both routes exist.
[v0.2.16] - 2026-07-23
Section titled “[v0.2.16] - 2026-07-23”- Notes are sticky notes now — draggable, resizable, and shamelessly yellow.
- They open beside the overlay, never on top of or behind it, and don’t block the rest of Perch.
- Row notes split into a project note (shared across the project) and a session note.
- A project note lights the note glyph on every session in that folder.
[v0.2.15] - 2026-07-22
Section titled “[v0.2.15] - 2026-07-22”- New global scratch pad — a note button on the quick-links row opens a multi-line pad.
- Session notes are multi-line now; the 140-character limit has been retired.
- Click a session’s note glyph to edit it (no more digging through the right-click menu).
- Session notes are an Indicators toggle now, off by default.
[v0.2.14] - 2026-07-21
Section titled “[v0.2.14] - 2026-07-21”- New Replay mode: record a Claude Code session and scrub through it in the real Perch (demos, bug repros).
- Capture recordings from Settings → Export, redacted by default (text out, shape in).
- Play back with
perch replay <file>— a transport window with play/pause, speed, and a scrub timeline. - The timeline plots prompts, tool calls, sub-agents and interrupts as hover-able markers you can jump between.
- Replays wear a light-blue “Perch - Replay” badge and leave your live sessions well alone.
[v0.2.13] - 2026-07-21
Section titled “[v0.2.13] - 2026-07-21”- Fixed the dense strip eating clicks where “Hide inactive members” had removed rows (invisible, but still grabby).
[v0.2.12] - 2026-07-21
Section titled “[v0.2.12] - 2026-07-21”- Post-update “what’s new” window — only the releases since your last version.
- Switch it off in Settings → Changelog, or dismiss it for good from the window.
[v0.2.11] - 2026-07-21
Section titled “[v0.2.11] - 2026-07-21”- Stopped the overlay hopping to the front every five seconds (it kept landing on its own tooltips).
[v0.2.10] - 2026-07-20
Section titled “[v0.2.10] - 2026-07-20”- Gold unlocks now flip a card out of the screen under a black vignette (confetti has retired).
- A batch flips in up to three cards side by side, plus a “+N more” card.
- Unlock toasts are now a separate toggle, off by default (the reveal does the celebrating).
[v0.2.9] - 2026-07-19
Section titled “[v0.2.9] - 2026-07-19”- More trophies for the cabinet: tool-grind badges (Web Crawler, Search Party, List Maker, Plan B).
- Secret achievements — mystery tiles showing only a cryptic hint until earned (that’s rather the point).
[v0.2.8] - 2026-07-19
Section titled “[v0.2.8] - 2026-07-19”- Achievement badges — trophies that level up with your lifetime stats, earned retroactively.
[v0.2.7] - 2026-07-19
Section titled “[v0.2.7] - 2026-07-19”- Reopen recently-closed sessions from the switcher — a fresh terminal running claude –resume.
- Closed sessions join the switcher list, renamed titles and all.
- Ctrl+Enter copies the resume command instead of launching a terminal.
- Choose which terminal reopening uses — Windows Terminal, PowerShell, or Command Prompt.
[v0.2.6] - 2026-07-18
Section titled “[v0.2.6] - 2026-07-18”- Pinned session notes — annotate any session from its right-click menu.
- Notes ride along in the overlay and survive restarts (the sticky that doesn’t fall off).
- New “Session notes” toggle in Indicators — a dedicated line, or a compact hover-able glyph.
[v0.2.5] - 2026-07-18
Section titled “[v0.2.5] - 2026-07-18”- Configurable keyboard shortcuts — a new Shortcuts settings page, every hotkey rebindable.
- Jump to next session (Alt+Shift+S) — cycle focus through your terminals; the overlay marks where you land.
- Session switcher (Alt+Shift+Space) — a keyboard palette to leap to any session. Perch’s own Cmd+Space.
- A finishing sub-agent no longer fires a premature “done” mid-thought.
[v0.2.4] - 2026-07-16
Section titled “[v0.2.4] - 2026-07-16”- Outage footer now reflects the worst live incident (a major outage no longer poses as “minor”).
- Outage menu opens on either mouse button.
[v0.2.3] - 2026-07-16
Section titled “[v0.2.3] - 2026-07-16”- Fixed auto-start hanging your first prompt.
[v0.2.2] - 2026-07-16
Section titled “[v0.2.2] - 2026-07-16”- Stopped duplicating our own hooks into settings.json on every launch (they were multiplying).
- Existing duplicate hook entries get swept up on the next startup.
[v0.2.1] - 2026-07-15
Section titled “[v0.2.1] - 2026-07-15”- Claude service-status footer — flags an Anthropic outage, so you know it’s not just you.
- Configurable status poll interval.
- Perch is now MIT licensed (the paperwork was overdue).
[v0.2.0] - 2026-07-08
Section titled “[v0.2.0] - 2026-07-08”- Rebuilt on Avalonia so you can use this on MacOS!
[v0.1.27] - 2026-07-04
Section titled “[v0.1.27] - 2026-07-04”- Autonomous section — background (SDK-driven) sessions collapse under one counted header, below the real ones.
- A little robot marks each background session (nobody’s at the keyboard).
[v0.1.26] - 2026-07-02
Section titled “[v0.1.26] - 2026-07-02”- Right-click the overlay header to show or hide the system metrics and usage strips.
- Right-click either strip to hide it on the spot.
- Menu glyphs now render properly (the party popper had been showing up as a tofu box).
[v0.1.25] - 2026-07-02
Section titled “[v0.1.25] - 2026-07-02”- Confetti finish — a session erupts with confetti the moment it next completes.
- Right-click a session to arm it (experimental, off by default); a party popper marks the armed row.
- Fires exactly once, then disarms itself.
- Never saved, so it can’t ambush you after a restart (you’re welcome).
[v0.1.24] - 2026-07-02
Section titled “[v0.1.24] - 2026-07-02”- Git line changes — a “+142 -37” chip beside each session’s name (green added, red deleted) for unstaged work.
- Toggle under Settings → Experimental, off by default (off means it never even thinks of running git).
[v0.1.23] - 2026-07-02
Section titled “[v0.1.23] - 2026-07-02”- Cancelling a turn (Esc / Ctrl+C) no longer fires a phantom “done” alert.
[v0.1.22] - 2026-07-02
Section titled “[v0.1.22] - 2026-07-02”- Perch reacts — the tray and overlay bird wears your sessions’ mood.
- Dozes when idle, alert while working, flags a “!” when you’re needed, and panics (sweat and all) on a stuck session.
- Toggle under Settings → Experimental (on by default).
[v0.1.21] - 2026-07-02
Section titled “[v0.1.21] - 2026-07-02”- Flight path — a daily timeline of your sessions, one lane each, coloured by what they were up to.
- Lanes mark engaged, waiting-on-you, and stuck stretches; blank means you’d wandered off.
- Step through earlier days with ‹ / › or the arrow keys.
[v0.1.20] - 2026-07-02
Section titled “[v0.1.20] - 2026-07-02”Overlay
Section titled “Overlay”- “Waiting on you” timer on blocked rows — warms yellow to red the longer you ignore it (configurable, default 10 minutes).
[v0.1.19] - 2026-07-02
Section titled “[v0.1.19] - 2026-07-02”Experimental
Section titled “Experimental”- Live token burn rate (tokens/min) beside a running session — off by default.
- It measures fresh tokens only; counting the context re-read pushed it into the millions and helped no one.
[v0.1.18] - 2026-07-02
Section titled “[v0.1.18] - 2026-07-02”Overlay
Section titled “Overlay”- The attention border is now a travelling neon glow, not a hard orange flash.
Experimental
Section titled “Experimental”- Ambient screen-edge glow — a soft pulse around your screen when a session needs you (off by default).
- The glow follows the overlay to whichever monitor you drag it onto.
[v0.1.17] - 2026-07-01
Section titled “[v0.1.17] - 2026-07-01”- Automatic update checks on startup and hourly (checks only — nothing downloads uninvited).
- An orange update badge, top-right of the panel, when a new version is waiting.
- “Check for Updates…” in the tray menu becomes “Update available” once there is one.
- An “update available” flag on About in Settings, for good measure.
- Clicking any of them installs the update; you’re notified once, not every hour.
[v0.1.16] - 2026-07-01
Section titled “[v0.1.16] - 2026-07-01”- Stopped reading an open
/workflowsmenu as “awaiting input” (it was just a menu).
[v0.1.15] - 2026-07-01
Section titled “[v0.1.15] - 2026-07-01”Monitoring
Section titled “Monitoring”- New “Monitoring” page — live CPU and RAM in the overlay (off by default; nothing is sampled until you opt in).
- Whole-machine CPU + RAM strip across the top of the panel.
- Per-session CPU/RAM mini-bars, coloured by load; hover for the exact numbers.
- Optional whole-process-tree roll-up per session — the MCP servers, shells and tools it spawns, not just the
claudeprocess. - Sub-agents fold into their session’s bar (they share one process; there’s no prising them apart).
[v0.1.14] - 2026-07-01
Section titled “[v0.1.14] - 2026-07-01”Experimental
Section titled “Experimental”- “Hide inactive members” toggle for Agent Teams — idle teammates drop off the roster (they reappear the moment they do something).
[v0.1.13] - 2026-07-01
Section titled “[v0.1.13] - 2026-07-01”Context pressure
Section titled “Context pressure”- Sonnet 5 reads as a 1M window, not 200k (it was quietly shrinking everyone’s headroom).
[v0.1.12] - 2026-07-01
Section titled “[v0.1.12] - 2026-07-01”Context pressure
Section titled “Context pressure”- New option: a green thermometer below the first threshold instead of blank. Off by default.
- Thermometer hover shows the numbers now — “34.6k/200k (17%)” — not just the percent.
[v0.1.11] - 2026-06-30
Section titled “[v0.1.11] - 2026-06-30”Notifications
Section titled “Notifications”- The “done” badge now sticks until you look at it, instead of vanishing after five minutes.
[v0.1.10] - 2026-06-30
Section titled “[v0.1.10] - 2026-06-30”Notifications
Section titled “Notifications”- No more duplicate “done” when a sub-agent finishes and the session keeps working (one was plenty).
- The completion alert now waits a beat to see whether the parent picks the work back up.
[v0.1.9] - 2026-06-30
Section titled “[v0.1.9] - 2026-06-30”Plugin
Section titled “Plugin”- Fixed the Claude Code plugin “Update” button, which had only ever produced errors (it asked for the plugin by the wrong name).
[v0.1.8] - 2026-06-29
Section titled “[v0.1.8] - 2026-06-29”Detection
Section titled “Detection”- Sub-agents and teammates retire the instant they finish, not a staleness window later.
- Driven by Claude Code’s
SubagentStop/TeammateIdlehooks; the old timer still backs it up. - A re-tasked teammate springs back to life on its own (it never really left).
[v0.1.7] - 2026-06-29
Section titled “[v0.1.7] - 2026-06-29”Settings
Section titled “Settings”- New Indicators tab corrals the overlay glyph toggles in one place.
- Toggle to show or hide artifacts on the overlay.
- Toggle for the permission-mode badge.
- New Experimental tab for early features (Agent Teams, currently lurking).
- Settings pages no longer clip their last row when scrolled.
Detection
Section titled “Detection”- Idle sessions now time out after a stretch of inactivity.
[v0.1.6] - 2026-06-29
Section titled “[v0.1.6] - 2026-06-29”Overlay
Section titled “Overlay”- Task-list progress on a running session: an n/m count that climbs as Claude works the list.
- Hover the count for the full checklist — ✓ done, ▸ doing, ○ waiting.
- The list bows out when you move on, and a fresh plan starts at 0 (no lingering “5/5”).
[v0.1.5] - 2026-06-28
Section titled “[v0.1.5] - 2026-06-28”Detection
Section titled “Detection”- Stuck-session warnings: an amber ⚠ on a session that’s spinning — tool calls failing in a row, or the same failing action on loop.
- Hover the warning for why Perch is worried.
- New Detection settings page to switch it off — or just the half that’s crying wolf.
Overlay
Section titled “Overlay”- Live activity now describes PowerShell commands, not just Bash (PowerShell was getting the silent treatment).
[v0.1.4] - 2026-06-27
Section titled “[v0.1.4] - 2026-06-27”- Perch Wrapped: turn any scope’s stats into a shareable poster (the gradient button is hard to miss).
- A data-derived persona on each poster — Night Owl, Agent Wrangler, Token Titan, and friends.
- Playful equivalences (“≈ 333 novels of text”, “≈ 48 movies of focus”) and a highlight reel.
- Copy your Wrapped to the clipboard or save it as a PNG, then go flex.
[v0.1.3] - 2026-06-27
Section titled “[v0.1.3] - 2026-06-27”Overlay
Section titled “Overlay”- Permission-mode badges dim on idle sessions (they were shouting into an empty room).
[v0.1.2] - 2026-06-27
Section titled “[v0.1.2] - 2026-06-27”Overlay
Section titled “Overlay”- Session and Weekly markers turn red when usage outpaces the clock (held back until 5% in, to spare your nerves early).
- Hover the context thermometer for a “Context at NN%” readout.
[v0.1.1] - 2026-06-27
Section titled “[v0.1.1] - 2026-06-27”History
Section titled “History”- Large transcripts (10 MB+) no longer crash the viewer; they load in the background and ask first.
- Session sizes shown in the dropdown (lag, telegraphed).
- History opens to a “pick a session” prompt, with a “(none)” option for the indecisive.
[v0.1.0] - 2026-06-27
Section titled “[v0.1.0] - 2026-06-27”The first release worth giving a round number. Everything before this was a rehearsal; the audience just happened to be claude-watching. What follows is the accumulated work of several dozen point releases, compacted into one tidy entry and stripped of the embarrassing intermediate states.
Overlay
Section titled “Overlay”- A floating desktop overlay with one square per active Claude Code session — humble, correct, and the whole reason this exists.
- Live activity indicator, elapsed time, and a status dot per session.
- Sub-agents (including background sub-agents) surface as child rows beneath their parent.
- Sessions renamed with
/renameshow that name everywhere, instead of a bare project folder. - Sessions with published web artifacts show a clickable glyph — click to open, or pick from a list when there’s more than one.
- A context-pressure gauge that warns you before your context window boils over.
- Clicking the overlay focuses the right terminal — including VS Code’s integrated terminal, and the correct window when one VS Code hosts several (previously pot luck).
- Drag to reposition, dock to either side (the right-vs-left debate remains unresolved), dense mode for minimalists, and a remote-control icon you can actually see now.
- Git worktrees are hidden from the session list. They are not sessions; they are a trap.
Notifications
Section titled “Notifications”- “Needs attention” detection that properly knows when Claude is waiting on you.
- Clicking a notification opens the relevant Claude instance.
- Notifications fire even when the machine is locked.
- Optional Windows chime when a session needs you (off by default; external alerts stay politely silent).
- Fast built-in commands like
/clear,/model, and/doctorno longer trigger a “done” alert — no work, no ping.
Remote control & external alerts
Section titled “Remote control & external alerts”- Generate a QR code to control sessions from another device.
- External push notifications via ntfy.sh, with QR-code setup and a direct link straight to the remote session.
History & stats
Section titled “History & stats”- A history viewer to browse past transcripts, with markdown rendering and clickable images.
- A session stats window: today’s sessions, active time, prompts, tool calls, token totals, an equivalent API cost (what the tokens would have cost pay-as-you-go — not a bill), an hourly heatmap, and breakdowns by project, tool, model, and git branch.
- Switch between Today, 7/30 days, and all time, with a daily activity trend, a day-streak counter, and records for the busiest day and longest single session.
- A “Today: N sessions · 3h 12m active” line in the tray menu, read straight from your transcripts — so there’s history from the moment you install it.
Quick Links
Section titled “Quick Links”- Shortcut to any app you like — much eaiser than finding the window yourself.
- Icons pulled from the apps themselves (Store apps like Slack show their real logo), with presets for GitKraken, Slack, Microsoft Teams, and Outlook (new and classic installs both).
- Live preview of the app it found as you type, and optional upside-down icons for the connoisseur of inverted iconography (off by default, mercifully).
Sessions & plugin
Section titled “Sessions & plugin”- A companion Claude Code plugin for automatic session start/stop and permission-monitor hooks (write-mode and cleanup-mode).
- Session limits to cap concurrency, configurable auto-close with a countdown so you can watch your fate approach.
- Plugin installs at user scope, so it follows you across every project.
- Install and update messages point you at
/reload-pluginsrather than a full restart.
Configuration
Section titled “Configuration”- A settings window that gathers everything in one place — reworked into something larger and more coherent, after a brief and bold three-minute experiment with in-app settings that was immediately reverted.
- Honours the
CLAUDE_CONFIG_DIRenvironment variable, matching Claude Code itself.
Plumbing
Section titled “Plumbing”- Event-driven session state — no more polling for what changed.
- Single-instance enforcement: one Perch, no negotiations.
- Owner-drawn dashboards, cached overlay rendering for snappiness, and a sweeping under-the-hood refactor you will not notice in the slightest — which is precisely the point.
