Far lighter on your CPU: mean use is around 1.5% with 5 concurrent sessions and roughly 0.01% when idle
Hidden panels no longer keep timelines, scans, or animations running in the background, and heavy work like record enrichment and directory resolution moved off the main thread
Faster launch: the app gets to a usable notch noticeably sooner after starting
Snappier notch transitions: the collapsed pill no longer computes expanded sizing or copies session history it isn't showing, and rendering is scoped to just the notch chrome
Leaner memory: session summaries are cached for rendering, text matching no longer allocates on every pass, and unnecessary rasterization and retained buffers were removed
Versionv0.2.25
Steady placeholders, one Settings lane, sturdier views
Text field placeholders no longer hop up when a field takes focus, and they render dimmer so an empty field does not read as filled in
Placeholders hold still in every field, from Fast Actions and Views to Settings, search, and the license key
Switching Settings tabs no longer nudges the window a few pixels wider or narrower
Clicking Launch, Edit, or Delete on a saved view no longer also opens the row's editor
Editing a view's panes no longer risks a crash when rows are added or removed mid-edit
Versionv0.2.24
Live checklists, branch chips, and big battery savings
Expanded session cards show the agent's working checklist as it updates, including Claude todos and Codex plans, plus a collapsible view of any adopted plan
Every session card shows its working directory's git branch, and a count chip appears while subagents run
Claude sessions nearing the context limit show a warning chip, and compactions are noted on the timeline
Session cards show Claude's own reported cost and cumulative lines added/removed instead of estimates
Quick Routes tiles show skill, plugin, and command counts, and each agent column shows its MCP server count
Polling pauses while displays sleep and background probes slow while collapsed, with an instant refresh on expand or wake
Fixed duplicated timeline markers across chained /clear sessions and the assistant-reply flicker at turn end
A performance release: the notch renders on the GPU
The waiting shimmer no longer eats a CPU core. The silver sweep on quiet sessions (user prompts, "Compacting context") now renders on the GPU at half its old tick rate. That loop could previously peg a full core and lag the whole Mac for as long as a session sat waiting.
Agent icons load once, not on every redraw. Opening Token usage and switching to By day used to stutter because agent icons were re-read from disk on each pass; they are now cached, so those transitions run at full frame rate.
The waiting-prompt dot costs almost nothing now. It used to re-render its glow up to 120 times a second for as long as a prompt sat unanswered; it now breathes at 20fps with the same look.
The token-usage headline presses more gently. The wide headline now dips like other full-width controls instead of lurching on release.
Quieter logs when Hermes is closed. AgentPeek opens Hermes's usage database in the right mode up front instead of failing loudly on every poll.
Versionv0.2.20
Lighter when idle, self-healing hooks, and clearer setup
AgentPeek runs much lighter when idle: less mouse tracking while collapsed, gentler polling on single-display Macs, and usage read from Claude's status line.
A new Settings Performance tab pauses the idle glow, parks avatars for sessions that aren't running, and slows usage polling to save battery.
AgentPeek now honors Reduce Motion across Settings, the menu bar, and onboarding, not just the notch.
Hooks heal themselves within minutes if a Claude Code update or config reset removes them, and now survive launching from Downloads.
Setup no longer needs a relaunch: a newly installed agent is detected in seconds, with a Check again button and a Doctor Session tracking row.
Empty states and a failed update check now explain themselves in plain English instead of leaving blank cards.
Every Hermes agent now shows in the notch, sessions return on their own after a cache clear, and OpenCode daily-usage bars are readable again.
Versionv0.2.19
Custom keyboard shortcuts, plus Views and permission polish
Record any custom keyboard shortcut for global actions and saved Views, not just the built-in presets.
The Views terminal picker shows each app's real icon and lists only the emulators installed on your Mac.
Permission Deny and Allow buttons redrawn as deeper red and green with white lettering, matching the diff colors.
Launching a Warp View no longer opens a stray blank window on a cold start.
The notch glass settles into its real look immediately on macOS 26 instead of after your first click.
Steadier collapse animation, plus assorted Settings and layout fixes.
Versionv0.2.18
Views, exact tab focus, and remote Hermes
Views: save named multi-pane terminal workspaces and launch them in one click or with Ctrl+Option+1-9
Session clicks land on the exact window, tab, or pane in Terminal, iTerm2, Ghostty, WezTerm, kitty, and tmux
Monitor Hermes on another machine through a remote dashboard URL
Menu bar usage popover reworked with live Now and By day pages
Notification settings reorganized into focused cards with smarter account-switch and quiet-hours alerts
Token totals survive /clear and session continuations, plus assorted fixes
Versionv0.2.17
Choose which displays show the notch, plus per-agent Quick Routes
Choose whether the notch appears on your built-in display, your external monitors, or both, from Settings > General.
Quick Routes now gives each agent its own labeled column, so you can scan straight to the folder you want.
Versionv0.2.16
OpenCode support, a roomier Ultra tier, and multi-account fixes
OpenCode sessions, usage, and model chips now appear in the notch alongside your other agents.
New Ultra tier for notch width, the collapsed pill, and spacing.
Steadier multi-account usage tracking, with per-account budget alerts.
Codex banked usage-limit resets now show in the usage panel.
Codex usage shows up again when Codex is installed only as its Mac desktop app, with no separate command-line tool.
Resizing the Settings window no longer jitters or bounces when you drag its bottom edge toward the smallest size.
Versionv0.2.14
Hermes Agent joins AgentPeek
Hermes Agent joins Claude, Codex, and Cursor as a fully tracked agent, with live sessions, permission prompts, model chips, and onboarding support.
Hermes usage shows a real monthly token readout with requests, tokens, and spend, read from Hermes's local session database.
A hairline divider now separates each agent's gauges in the usage panel.
Header gauges keep a stable order, and multi-file edits list every file in the session timeline.
Versionv0.2.13
Model chips on every session, plus a steadier notch
Session cards now show a model chip, read live from Claude and Codex transcripts and from the Cursor CLI.
A steadier notch: dismissing a session or answering a permission no longer collapses the panel, and hover behaves the same on every display.
Permission, plan, and question prompts now size to their own content instead of the session list's height.
Lighter tracking for long Codex sessions, plus usage gauges that keep their last good reading.
Versionv0.2.12
Reliable launch checks, a clearer notch, and steadier hover
More reliable agent verification on launch, with a Doctor banner when something still needs you and auto-clear once activity arrives.
Clearer notch over bright wallpapers.
Steadier notch hover, especially on external displays.
No blank account in the Usage account picker.
Versionv0.2.11
Usage accounts, metric opacity, and calmer notch motion
Pick your usage account for Claude, Codex, or Cursor in Settings, or leave every gauge on Automatic; the active account shows under the agent name.
A new metric opacity slider in Appearance lifts the notch's quiet text, from timestamps to the token, files, command, and cost chips, anywhere from subtle to white.
Usage bars now read like a battery, green to yellow to red as a window fills, with the same colors for every agent.
Opening, closing, and switching between sessions, usage, servers, and routes animate as one piece, with no bright flash on collapse and no rows stranded below the notch.
Ultra-wide is selectable again for the collapsed pill in usage mode.
Fixes: remaining-usage gauges drain from full, header clicks no longer dismiss the notch, first clicks land on secondary displays, restored Claude Desktop history won't fire a phantom completion, and Doctor flags usage-account issues.
Versionv0.2.10
Cursor usage now tracks real monthly spend
Fixed Cursor monthly usage for current Pro and Ultra plans by reading Cursor's live dashboard usage source instead of the legacy request-based feed.
Added Cursor monthly measure controls in Settings: choose Spend, Weighted, Auto, or API for the headline gauge. Weighted remains the default and matches the in-editor meter.
Added optional Cursor Auto/Composer and API usage bars in the notch usage detail view and menu bar popover.
Improved Cursor usage details with plan-aware spend display, including "$X of $Y" when the included monthly allowance is available.
Cursor usage setting changes now update visible gauges immediately, without waiting for the next usage refresh.
Added a dismissible usage health notice that points users to Doctor when usage accuracy may need attention.
Tightened usage panel sizing so added Cursor bars and notices reserve stable space instead of shifting the notch layout.
Versionv0.2.9
Cursor support and redesigned settings
Cursor is now a supported agent! Sessions, permission prompts, and monthly usage in the notch, right next to Claude and Codex.
Settings got a redesign - sidebar navigation, a resizable window, and search that filters every setting as you type.
New Usage settings tab. The Show usage, Headline gauges, and Count down toggles for each agent all live there now.
New Shortcuts settings tab with every hotkey in one place.
New Show account labels setting - session cards get a chip showing the subscription account they are running on.
More honest permission prompts - shell commands that write files no longer get summarized as harmless reads.
Codex questions answered in the notch now actually reach Codex. Before, Codex quietly ignored the answer and asked again in its own window, so you answered everything twice.
Long-running tools no longer get incorrectly flipped to waiting for your input after two quiet minutes; a session only flips when its process is actually gone.
Fixed a bug where Claude sessions could lose their final turn - last reply, tokens, tool runs - if AgentPeek was relaunched mid-turn.
Task complete notifications now fire when the agent finishes a turn and is waiting on you, not only when the CLI exits, with no duplicate notifications for the same turn.
Pressing Command-Comma can no longer open a second, conflicting Settings window.
Keyboard shortcut registration failures, for example when another app owns the combo, now show a warning in Settings > Shortcuts instead of failing silently.
The trial notice no longer overflows the empty notch panel; the panel now reserves room for it.
Smoother notch performance: the once-per-second clock no longer re-renders the whole expanded panel, and very long session histories no longer slow down list updates.
Package-runner detection, including npx, yarn, and pnpm, now uses one consistent, conservative rule everywhere, so folder names containing codex or claude cannot be mistaken for a running agent.
Closed a license loophole where rolling the system clock back could resurrect an expired trial; paid licenses and active trials are unaffected.
The website got a refresh too, with Cursor front and center.
Versionv0.2.8
Readable Liquid Glass and count-down usage
There's a new opacity slider for Liquid Glass: slide toward Opaque and the expanded glass firms up so text stays legible.
New Claude and Codex toggles flip the token readout to count down from 100% instead of climbing up from zero.
Right-click the menu bar icon for a quick way to quit the app.
Fixed an Always Allow bug where a prompt could still appear in the notch after you had already chosen Always Allow for it in the terminal.
Lighter on your Mac, with another pass at trimming RAM and CPU use.
Versionv0.2.7
Doctor, fixes, and polish
The Doctor tab in Settings now diagnoses hook and install issues, so when an agent isn't showing up you can see why.
A round of small bug fixes.
Quality of life polish across the app.
Versionv0.2.6
Daily token usage and Doctor settings
New token usage day-by-day statistics.
New "Doctor" settings tab to help improve performance and fix issues if any.
Increased opening and closing notch smoothness - per user feedback :)
Notification and update reliability improvements, plus a new Update setting.
Usage copy bug fix.
Less RAM and CPU, yay!
Versionv0.2.5
Fast Actions and bigger notch layouts
Fast Actions let you save shell commands and run or stop them from the notch.
New Ultra-wide width and Colossal density options give the expanded and compact notch more room.
Usage tracking is steadier across refreshes, stale snapshots, and sign-in checks.
Local server panels, empty states, and header controls got polish and sizing fixes.
Versionv0.2.4
Local servers list-style sizing
Local servers list-style sizing
Markdown rendering + plain-text extraction for last replies
Release note UI polish
Versionv0.2.3
Smoother session history
Tighten session ingestion and tool-activity tracking so history data is more complete and consistent.
Refine session history UI across the notch, headers, timeline rows, usage views, and collapsed/expanded states.
Versionv0.2.2
Codex desktop fixes
Codex desktop app Git bug duplicated sessions.
Codex token usage was over-sensitive to sign in, showing an incorrect warning tooltip.
Versionv0.2.1
Fixed onboarding bugs
Fixed onboarding bugs.
Versionv0.2.0
Meet AgentPeek v2
AgentPeek v2 opens with a guided, windowed welcome that walks you through connecting Claude and Codex and granting permissions. It never sees your provider credentials.
Sessions are far more reliable: they appear whether you start agents from the terminal or the Claude and Codex desktop apps, and duplicate sessions collapse into a single row.
Token usage is more accurate across both agents, with live counts that track real consumption and a clear note when an agent is signed out.
Liquid Glass is enhanced across the notch and panels, with more depth, refined per-tool colors, and clearer activity summaries.
Versionv0.1.32
Steadier session interactions and a cleaner notch
Clicking, expanding, and acting on a session row feels more solid, with fewer surprises.
Sessions launched from the Claude and Codex desktop apps read more clearly in the panel.
Small polish across the notch and menu bar.
Versionv0.1.31
Smoother notch, more accurate token counts
Smoother notch interactions: clicking a session row no longer collapses the panel, and approving or denying a prompt no longer flickers the notch.
Per-session token counts now track your live context more closely, so the input / output split reflects what the agent is actually working with.
Versionv0.1.30
Catch desktop-app sessions the moment they launch
Sessions started from the Claude and Codex desktop apps appear the moment they launch, instead of waiting for their first activity.
Each desktop session shows up exactly once, with no duplicate row while it connects.
Versionv0.1.29
Desktop apps in the notch, split token counts, and notch polish
AgentPeek now follows the Claude and Codex desktop apps, not just the terminal: launch an agent from either app and it appears in the notch as its own live session. Desktop sessions stay separate from your terminal runs, so permissions, tokens, and tool activity never cross between them, and idle desktop sessions retire sooner than long-running terminal jobs.
Token counts in each session header now split input and output (for example 24.6k / 66) and add up across every turn, so the number reflects the whole session instead of only the latest exchange.
Notch polish: the usage refresh button sweeps a silver shimmer while its icon spins, session headers and the expand-reply control gain cleaner press and hover feedback, long MCP server names shrink to fit instead of being cut off, and session rows no longer flash when you collapse a card.
Versionv0.1.28
Cleaner trial handoff and a steadier notch
When your trial ends, AgentPeek brings up the purchase screen right away, with no restart and no awkward in-between state.
The expanded notch stays pinned to the top edge while you switch between Fixed and Expand session-list modes, with a cleaner glass rim.
A lighter, tidier app under the hood.
Versionv0.1.27
Liquid Glass customization, a resizable Settings window, and a smoother session list
Liquid Glass, your way: turn the frosted rim on or off for Settings, the menu bar, and the notch, and dial its thickness with a new slider. The notch rim is opt-in, with a separate toggle for its top edge.
The Settings window is now resizable, opens in a better spot below the notch, keeps its window controls in place while you drag, and has a new quit button in the title bar.
Smoother session list: the expanding panel now sizes to each row exactly, so avatars no longer clip and the bottom padding looks right. Motion across the app is quicker and crisper.
On external displays the notch panel sits flush at the top, since there is no hardware notch to tuck behind.
A new refresh button for usage in the notch header and the menu bar popover, refreshing Claude and Codex on demand.
A bigger, crisper pixel avatar in the pill, plus a sharper app icon in the menu bar and About.
Send a test notification from Settings to confirm your alerts are working.
Crash, cursor, and stability fixes, so the notch stays calm even when several sessions are busy at once, plus an off-screen tooltip fix.
Versionv0.1.26
Fewer crashes, snappier session cards
Fixed crashes in the notch and during activation.
Session cards respond faster when you expand and act on them.
More stability and polish across the app.
Versionv0.1.25
Better local server labels
Local server rows now recognize Astro, Next.js, Vite, Wrangler, Storybook, Playwright, and static-site servers from command lines and project files instead of showing only the runtime process.
Usage gauges now keep the last known percentages visible during refresh lag, while real errors still show as unavailable.
Settings opens lower on the active display so the panel does not land under the notch overlay.
Expanded session replies now grow without the chevron ghosting or fading through the whole card.
Versionv0.1.24
Claude usage, straight from the source
Claude usage now comes straight from Claude Code's built-in /usage data, so the gauges, menu bar bars, and notch panel match what Claude Code reports.
Usage updates are steadier and recover on their own after a hiccup, so the meters keep flowing without gaps.
When usage data can't be refreshed, the meters and budget alerts hold back instead of showing stale percentages.
The menu bar keeps updating quietly in the background, so your meters stay current between checks.
Questions about this update? Read the docs at https://agentpeek.app/docs or reach out on X at https://x.com/brenhubr (@brenhubr).
Versionv0.1.23
Smoother long sessions and expandable replies
Long agent replies now expand inline: tap Show more on a session card to read the full reply with selectable text, then Show less to collapse it.
Fixed a crash and tightened performance for sessions with very long histories, so the notch panel stays smooth while you hover and resize it.
Sessions with thousands of timeline entries render and refresh faster, keeping the panel responsive as new activity streams in.
Questions about this update? Read the docs at https://agentpeek.app/docs or reach out on X at https://x.com/brenhubr (@brenhubr).
Versionv0.1.22
Token usage tracking and menu bar reliability
Token usage tracking is more reliable: a slow or failed refresh no longer risks a crash, so the gauges keep updating.
Menu bar reliability: opening a local server in your browser now shows a clear message when it cannot launch, stopping a server takes a deliberate confirm tap, and the menu bar and notch no longer compete over the local server scan.
Behind-the-scenes improvements to licensing and activation reliability.
Questions about this update? Read the docs at https://agentpeek.app/docs or reach out on X at https://x.com/brenhubr (@brenhubr).
Versionv0.1.21
Auto width in usage mode
Usage mode automatically keeps the collapsed pill at full width so the gauges stay visible.
The Collapsed width setting locks to Wide while usage mode is active and restores your choice when you leave it.
Versionv0.1.20
Usage gauges in the notch
New "Usage" option for the collapsed pill shows live Claude and Codex usage gauges in the notch.
The menu bar icon shows an amber attention dot when an agent is waiting on you.
Hovering the notch now uses a short intent delay, so the panel no longer flickers when the pointer grazes the top of the screen.
Plan approvals render their headings styled, and the menu bar popover shows a scanning indicator while finding local servers.
Versionv0.1.19
More reliable activation and bug fixes
Activating your license is more dependable.
Assorted bug fixes.
Versionv0.1.18
Prompts that grow to fit the notch
Permission, plan, and multi-question prompts now grow to fit. The full diff, plan, or question set expands the notch instead of squeezing into a cramped scroll.
Right-click or Control-click the menu bar icon for a quick Quit, available even before you have activated.
Usage meters reset to empty the moment your 5-hour or weekly window rolls over, instead of lingering on a stale reading.
Clearing a Claude session with /clear now keeps it in your session list instead of dropping the row.
Various bug fixes and performance optimizations.
Versionv0.1.17
Improved usage tracking for Claude and Codex
Improved usage tracking for Claude and Codex reads each tool's limits more reliably, so your 5-hour and weekly meters stay accurate.
Settings and the menu bar have a refined glass finish, with cleaner cards, controls, and usage meters.
Various bug fixes and performance optimizations.
Versionv0.1.16
A depth-lit interface
The menu bar and settings panels have a new depth-lit finish, with raised cards, beveled controls, and recessed wells set against the OLED-black background.
Activating your license now happens in a clearer, full-size window.
Various bug fixes and performance optimizations.
Versionv0.1.15
Truly expandable session list
The expanding session list now grows to fill the screen height before it scrolls, so every open session stays visible on a tall display.
Various bug fixes and performance optimizations.
Versionv0.1.14
A Session list size setting and a new activation window
Added a Session list setting to Appearance: keep the expanded panel at a fixed size that scrolls, or let it grow with each open session.
Added an activation window with a clear license card, $15 one time pricing, and an inline field to activate a key without opening Settings.
Various bug fixes and performance optimizations.
Versionv0.1.13
Roomier panels, exact refill times, and a cleaner menu bar
Usage, quick routes, and local servers now open at one consistent, roomier size with even spacing, so nothing feels crammed at the top and scroll bars no longer pop in.
Token usage shows exactly when your weekly limit refills, down to the time of day, like "refills Sun at 3:47 PM".
Added a Clock setting to show that refill time on a 12-hour or 24-hour clock.
Gave quick routes more breathing room in the notch, with each path tucked neatly under its name.
Refreshed the menu bar popover with a cleaner header and flat, divided sections in place of the boxed cards.
The menu bar popover now closes right away when you click another app, the desktop, or the menu bar.
Claude and Codex sessions now surface subagent activity, like "Running research subagent", and a session waiting on you stays put instead of flipping back to running when a subagent finishes.
Various performance optimizations and reliability upgrades.
Versionv0.1.12
Reliable Codex usage and steadier sessions
Fixed Codex usage so live readings load reliably.
Kept sessions that are waiting on your input from briefly flipping back to running when a tool finishes late.
Moved Quit to a red power button in the top-left of Settings.
Various performance optimizations and reliability upgrades.
Versionv0.1.11
Dual surfaces and session history polish
Added independent notch and menu bar toggles so both surfaces can run at the same time.
Added pixel-grid motion for session avatars, with active sessions in a diagonal wave and waiting sessions in a calm spin.
Claude and Codex sessions now behave the same way as they start, clear with /clear, exit with /exit, and drop off when they go quiet.
Removed the cap on history, so every timeline entry and the full reply text stay visible.
Versionv0.1.10
Update prompt and menu bar polish
Software update prompts now show the AgentPeek icon and a clean version number
The "What's New" window confirms with the Return key
Menu bar popover positions correctly across multiple displays and external monitors
Notch UI refinements across session cards, code diffs, permission prompts, quick routes, and agent avatars
Versionv0.1.9
A tidier menu bar icon across displays
Fixed the menu bar icon showing up where it shouldn't across Spaces on multi-display Macs.
Steadier notifications under the hood.
Versionv0.1.8
Polish pass on the marketing site and docs
Refreshed feature cards on the landing page
Docs split into install, configure, and troubleshoot sections
Expanded notification settings coverage
Quieter activity colors so background sessions stay calm
Versionv0.1.7
System notifications and Copy Session as Markdown
New: macOS system notifications for permission, budget, stuck, and complete events
New: Copy Session as Markdown from the context menu
New: kill and refresh-usage quick actions on session rows
New: threshold tint on token usage bars when nearing the limit
Improved: quiet terminal sessions can now be dismissed
Versionv0.1.6
Sessions panel matched 1:1 with the real notch UI
Improved: landing page sessions panel now mirrors the in-app session card
Fixed: unclickable landing nav links
Versionv0.1.5
Hourly update checks
New: Sparkle now checks for updates hourly so fixes ship within the day
Versionv0.1.4
More dependable signed releases
Updates now build, sign, and notarize cleanly, so each new version installs without a fuss.
Version numbers stay correct from one release to the next.
Versionv0.1.3
Cleaner install and UI polish
Settings now opens centered on launch.
Usage no longer gets cut off on narrow notches.
A tidier download window when you open the app's disk image.
Versionv0.1.2
Compact width and Local Server polish
New: compact notch width picker in Appearance settings
New: hold the notch open while the settings window is focused
New: local dev server rows now label the framework they're running
New: each server row shows how long it has been up
Versionv0.1.1
One-tap agent hooks
Install and repair are now a single enable toggle for agent hooks, so AgentPeek can see your local sessions.
Sessions reconnect on their own if the connection drops.
Cleaner activation wording and steadier session tracking.
Versionv0.1.0
Initial release
Live Claude Code and Codex sessions in the Mac notch
Inline permission prompts, questions, and plans
5-hour and 7-day token usage gauges
Local dev server list with one-click stop, copy, and open
Quick Routes to skills, plugins, config, logs, and project root
