Skip to content

What's new

All notable changes to Perch are documented here. Format follows Keep a Changelog.



  • 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

  • A little tree marks sessions working in a git worktree (started there or wandered in)
  • Click the tree for the git graph

  • 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

  • Status lines with git counts refresh about 3x faster (it was mostly waiting on git; re-apply your profile)

  • Focusing a Windows Terminal session picks its tab, not just the window (no more tab roulette)

  • 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

  • Sub-agents stopped by their parent vanish at once (no 90-second wake)

  • 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

  • Something new to find in the trophy cabinet (we’ve said too much already)

  • 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 work and --work go too

  • 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

  • “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

  • Green tick on the PR glyph once a PR is approved
  • PR tooltip names who approved it (credit where it’s due)

  • 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_WORK retired; use perch --work <item> (we suspect nobody will notice)

  • 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)

  • 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

  • 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

  • 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)

  • 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

  • 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> claude files a terminal session under an item
  • perch --work and perch work commands
  • Each item is a markdown file (edit it by hand; Perch will cope)

  • 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

  • /resume <id> jumps straight to that session; other text pre-fills the search
  • /resume picker 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)

  • 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)

  • 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)
  • /rc again 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

  • 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

  • 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)

  • Your default account shows the org /status shows (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

  • 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)

  • 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

  • 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)

  • 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

  • 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

  • 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

  • File paths in replies are clickable, backticks or not
  • file.cs:42 and #L42 references 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)

  • 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)

  • 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)

  • 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)

  • 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

  • Red chip on an account whose sign-in is about to expire
  • Two days’ warning before you’ll need to /login again
  • 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

  • Session ⋯ menu opens the project folder in Explorer (or Finder)
  • …or in a terminal, for when the GUI has had its turn

  • /clear no longer leaves the old conversation lurking beside the new one
  • Session account chip shows the session’s own account, asleep or awake
  • /usage shows the session’s account, not whichever was default

  • /reload-skills and /reload-plugins in session windows
  • /exit ends the session (no “are you sure?” — you typed it)

  • 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)

  • 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

  • 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

  • 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

  • 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)

  • perch in PowerShell or cmd hands the prompt back cleanly (it was there; the cursor just didn’t know)
  • perch --help and perch --version, which no longer open a session
  • perch says when it’s starting the tray, not only when it’s already running
  • CLI output survives redirects (perch configdirs > file was writing nothing, very confidently)

  • 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

  • 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

  • \ then Enter adds a new line in the session composer, as in the terminal (no more half-sent prompts)

  • 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

  • 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

  • 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

  • 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)

  • 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 gh login; Perch never touches a token

  • Questions from Claude offer “Other” for typing your own answer (the options were suggestions all along)

  • 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)

  • 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.name token for your /rename title

  • 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

  • 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)

  • 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_modules churn 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

  • Check the arcade again (bring a friend, and something to draw with)

  • 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)

  • 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

  • Status line tokens for the signed-in account and org, read live per config directory
  • The round filter takes decimal places now (round:2), not just whole numbers

  • 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)

  • Retuned the usage bar’s pace colours: green stays longer early on, red arrives the moment you’re over pace

  • 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

  • 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

  • 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

  • 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

  • Choose how long friends’ statuses stay visible (the old 12 hours was stingy; now 2 days)

  • 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

  • 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)

  • Session composer shows the current git branch, beside the permission mode
  • Branch pill flags how far ahead or behind its upstream you are

  • 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

  • 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

  • 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)

  • 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

  • Config directories show which org each one is signed into
  • Hover a session’s directory chip to see its org

  • Inline code reads 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

  • 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)

  • 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)
  • perch from Git Bash hands your prompt back (it had been quietly holding mintty hostage)

  • 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

  • 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
  • perch hands the terminal back its prompt instead of holding it hostage until you quit

  • /remote-control (/rc) connects a Perch session to your phone or claude.ai, QR and all
  • /usage opens 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 perch in a terminal opens a session right there

  • 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

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

  • 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

  • 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

  • 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

  • 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)

  • 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)

  • “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)

  • 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

  • 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)

  • 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

  • No more premature “done” when a background agent finishes — Perch waits for the session to actually stop

  • 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

  • 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

  • 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)

  • 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

  • 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)

  • 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

  • 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)

  • Quiet mode: mute the fun/social/silly features for a while (right-click the header)
  • The perch dozes off while it’s on (💤)

  • 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)

  • 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

  • Fixed the context thermometer sizing Fable to 200k (it has a million, like Opus and Sonnet 5)

  • 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

  • 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)

  • 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

  • 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)

  • Settings, History and the Markdown viewer now open on your current virtual desktop, instead of dragging you off to theirs

  • 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

  • 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)

  • 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

  • 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)

  • Markdown preview tucks SKILL.md-style frontmatter into a collapsed “Preamble” block (it used to spill out as garbled text)

  • 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

  • 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

  • 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

  • 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)

  • 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

  • Task-list checkboxes render as rounded, ticked boxes instead of flat squares

  • 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

  • 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)

  • Clicking the perch icon a few times does even more now (no, we won’t say why)

  • 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)

  • Fixed black fringing around the “Achievement Unlocked!” text (ClearType, meet transparency)

  • Try clicking the perch icon a few times (no, we won’t say why)

  • Fixed quick-link icons rendering mirror-image (they were being rotated, not un-flipped)

  • 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

  • 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

  • Fixed the floating overlay clipping its bottom rows after a drag (the drag never knew it had ended)

  • Added “Whoops” achievements for prompts you cancel and re-type (we all do it)

  • Fixed task checklists reading 0-done when they weren’t (the tool renamed its fields; we hadn’t noticed)

  • 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)

  • 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

  • Hovering the last session row no longer pokes its corners past the panel’s rounded edge

  • 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)

  • PR status now follows branch switches, dropping the old branch’s PR immediately (no more clinging to it for five minutes)

  • 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)

  • 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

  • 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)

  • A bottom-parked overlay anchors by its header, so it stops leaping about as sessions come and go

  • 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

  • Fixed the overlay jumping to an old spot when you toggle dense mode on a small screen (it now stays where you left it)

  • 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

  • Locked-screen ntfy pushes now start with “AFK” (so you know why your phone buzzed)

  • 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)

  • 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)

  • 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)

  • 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

  • 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

  • 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)

  • 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)

  • 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

  • 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)

  • New achievement: swear in your prompts 10 times for Fowl Mouthed, 100 for Like a Sailor (it counts; it does not judge)

  • Dense-mode hotkey no longer collapses the preview while you’re hovering it (it would just pop back)

  • 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)

  • Dense-mode hotkey now dismisses the popped-open list preview before leaving dense (a second press still exits)

  • 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

  • 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

  • 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

  • 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 gh CLI 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

  • Roughly halved memory use by switching the overlay to software rendering
  • Retired the ambient screen-edge glow (an experiment nobody switched on)

  • 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

  • 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

  • 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 perch clears the hooks and login entry, like the real uninstaller

  • 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)

  • 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”)

  • 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

  • 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)

  • 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)

  • 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

  • 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

  • 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

  • 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)

  • 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

  • Per-model weekly limits in the usage strip (Fable’s was there all along)

  • 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).

  • 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).

  • Token achievements split into Input, Output, and Cached milestones.
  • Retired the lumped “total tokens” trophy (it just measured cache reads).

  • 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.

  • Clicking the “update available” toast now starts the update, not just the button.
  • Reworded the toast to admit both routes exist.

  • 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.

  • 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.

  • 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.

  • Fixed the dense strip eating clicks where “Hide inactive members” had removed rows (invisible, but still grabby).

  • 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.

  • Stopped the overlay hopping to the front every five seconds (it kept landing on its own tooltips).

  • 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).

  • 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).

  • Achievement badges — trophies that level up with your lifetime stats, earned retroactively.

  • 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.

  • 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.

  • 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.

  • Outage footer now reflects the worst live incident (a major outage no longer poses as “minor”).
  • Outage menu opens on either mouse button.

  • Fixed auto-start hanging your first prompt.

  • 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.

  • 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).

  • Rebuilt on Avalonia so you can use this on MacOS!

  • 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).

  • 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).

  • 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).

  • 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).

  • Cancelling a turn (Esc / Ctrl+C) no longer fires a phantom “done” alert.

  • 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).

  • 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.

  • “Waiting on you” timer on blocked rows — warms yellow to red the longer you ignore it (configurable, default 10 minutes).

  • 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.

  • The attention border is now a travelling neon glow, not a hard orange flash.
  • 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.

  • 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.

  • Stopped reading an open /workflows menu as “awaiting input” (it was just a menu).

  • 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 claude process.
  • Sub-agents fold into their session’s bar (they share one process; there’s no prising them apart).

  • “Hide inactive members” toggle for Agent Teams — idle teammates drop off the roster (they reappear the moment they do something).

  • Sonnet 5 reads as a 1M window, not 200k (it was quietly shrinking everyone’s headroom).

  • 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.

  • The “done” badge now sticks until you look at it, instead of vanishing after five minutes.

  • 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.

  • Fixed the Claude Code plugin “Update” button, which had only ever produced errors (it asked for the plugin by the wrong name).

  • Sub-agents and teammates retire the instant they finish, not a staleness window later.
  • Driven by Claude Code’s SubagentStop/TeammateIdle hooks; the old timer still backs it up.
  • A re-tasked teammate springs back to life on its own (it never really left).

  • 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.
  • Idle sessions now time out after a stretch of inactivity.

  • 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”).

  • 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.
  • Live activity now describes PowerShell commands, not just Bash (PowerShell was getting the silent treatment).

  • 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.

  • Permission-mode badges dim on idle sessions (they were shouting into an empty room).

  • 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.

  • 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.

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.

  • 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 /rename show 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.
  • “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 /doctor no longer trigger a “done” alert — no work, no ping.
  • 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.
  • 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.
  • 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).
  • 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-plugins rather than a full restart.
  • 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_DIR environment variable, matching Claude Code itself.
  • 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.