Changelog
What's new in ClaudeNotch
Every release and what changed. Grab the latest build any time from the releases page.
v0.8.6
July 25, 2026Fixed
- More security hardening: history CSV exports are protected against spreadsheet formula injection, the saved state file is now readable only by you, and a few extra edited-file types (configuration profiles and web-link files) are revealed in Finder instead of being launched.
Changed
- Cleaner updates: installing a new version now quits and replaces the running copy instead of colliding with it, and a full uninstall can also clear the app's saved data.
v0.8.5
July 24, 2026Changed
- Security hardening across the app: the local hook server rejects browser-originated requests (drive-by and DNS-rebinding pages), pull-request links and edited-file paths that arrive in a hook can only ever open a web page or your editor rather than launch an app or script, and the standup's git reads are locked down against untrusted repositories.
- Launcher scripts are written owner-only and stale ones are cleaned up instead of accumulating in the temp folder.
v0.8.4
July 24, 2026Added
- A History page that archives every finished session with a one-line summary, cost, lines changed, files touched, and duration, searchable by project, summary, or branch.
- A one-click "what I shipped" standup, on the History page and in the menu bar, built from your finished sessions and the day's git commits and copied straight to the clipboard.
Fixed
- Durations longer than an hour now read as hours and days instead of a runaway minute count.
- The standup now includes projects you committed in even when no session was formally ended there.
Changed
- A broad internal cleanup: shared helpers for terminal launching, git reading, file tailing, the clipboard, and repeated UI, so behaviour stays consistent and there is less duplicated code to drift.
v0.8.3
July 23, 2026Added
- A Send feedback action, on the About page and in the menu bar, that opens the author's LinkedIn so you can reach out in one click.
Fixed
- Settings search now handles multi-word queries and matches across a setting's name and keywords, instead of only exact substrings.
- The settings window centers its content, so maximizing or full-screening it no longer leaves everything hugging the left edge.
v0.8.2
July 23, 2026Added
- Codex (beta) is much fuller. Codex sessions now get a live context meter, resume (codex resume), start Codex in a folder, a task-progress bar from Codex's plan, the git branch, token usage on the Usage page, session previews, and a heads-up card when Codex is about to ask for approval.
- Dropping a folder on the notch asks whether to open it in Claude Code or Codex (only when Codex is enabled; otherwise it just opens Claude).
Fixed
- The notch top card always reflects the session that is actually running, with its own model, context, cost and branch, instead of mixing values across agents.
- The multi-session card no longer shows the running session twice or clips its text; the current session sits at the top and the others below.
- Codex context now reads the true occupancy against the window, and no dollar figure is shown for Codex (gpt pricing is unpublished).
- Opening a terminal from the notch no longer jumps the display to another Space, and the custom notch name can be set from Settings without the field vanishing.
v0.8.1
July 22, 2026Added
- Per-session agent tags. When you run more than one agent, each session row shows which CLI it is (a small CODEX or GROK chip; Claude stays untagged), so a mixed list is unambiguous.
- Name the notch during setup, not only in Settings. Leave it blank to use the agent's name.
Fixed
- The notch header now names the agent from the sessions actually running. A Codex-only session reads Codex instead of Claude, and a mix of agents reads the app name rather than claiming a single wrong one.
v0.8.0
July 22, 2026Added
- Codex support (beta). Enable it in Settings > General > Integrations, approve Codex's one-time hook-trust prompt, and your OpenAI Codex CLI sessions surface in the notch: live activity, a running-command card, session status, and a heads-up card when Codex is asking to run a risky command. It is beta, so expect rough edges.
- The notch header now names the agent for the active session (Claude or Codex), so multiple agents are not all labelled "Claude".
Changed
- Codex keeps its own permission prompt. ClaudeNotch surfaces and observes Codex sessions but does not gate them, because Codex's own approval is the safe primary gate. Codex cost and resume are not wired yet.
v0.7.9
July 22, 2026Added
- A 4-week estimated-cost trend on the Usage page, alongside the daily one.
- Resume sessions are grouped by day (Today, Yesterday, Earlier this week, Older) inside each project.
- A weekly digest: a once-a-week roundup of sessions and estimated cost, under the digest toggle.
Fixed
- Weekly totals now reconcile. The week window was one day too wide, so This week, the model mix, and the project leaderboard summed an extra day the trend chart dropped; they now all cover the same seven days.
- The context meter shows "no usage yet" before the first status line, instead of a misleading 0%.
v0.7.8
July 21, 2026Added
- The Usage page is now a proper dashboard: a 7-day estimated-cost trend, a model-mix breakdown by cost, cache savings in dollars, and a one-click CSV export of your session history.
Changed
- Cost figures are clearly labelled as estimates at public API prices, not your subscription bill. On a Pro, Max, Team, or Enterprise plan you pay a flat fee, so the numbers show what the usage would cost pay-as-you-go, not money you spent.
Fixed
- A completed task list no longer leaves its full progress bar in the notch after the turn ends; it clears when you send the next message.
v0.7.7
July 21, 2026Added
- Task progress in the notch now follows your to-do list. When Claude works through a TodoWrite checklist, the open notch card shows a done-over-total progress bar, not just the subagent task system.
- An in-app update banner. When a newer release is out, the General settings page shows the version with a one-click download, release notes, and a copyable Homebrew upgrade command.
- A Spend breakdown in the menu bar: today, the last 5 hours, and this week, with a jump into the full Usage page.
- A What's new panel on the About page showing the current release's highlights.
Changed
- The Developer settings page opens compact, with its sample cards and pet animations tucked into collapsible sections.
- A drag-a-folder-onto-the-notch tip on the setup screen, plus tidier onboarding copy.
v0.7.6
July 21, 2026Added
- Lines changed this session. The Session settings page now shows how many lines the current session has added and removed, with the net, read straight from Claude Code's status line.
- Code churn today on the Usage page: lines added, removed, and net across everything you have worked on today.
Changed
- The cost tooltip now says whether the dollar figure is Claude Code's own reported cost or the app's estimate from the transcript, so you know which number you are looking at.
v0.7.5
July 20, 2026Added
- Plan usage limits on the Budget page. See how close you are to your Claude plan's 5-hour and weekly limits, each as a percentage bar with a reset countdown, turning amber and then red as you approach the cap.
- A burn-rate forecast under each limit. From how fast you are using the window, ClaudeNotch estimates whether you are on track to hit the limit before it resets, for example "at this pace you hit the limit in about 2h".
- A per-project spend leaderboard on the Usage page, ranking your projects by estimated spend over the last seven days.
- Task-list progress in the notch. When the current session is working through a multi-step task list, the open notch card shows a thin done/total progress bar.
- Name a session. Give any resumable session a short name so the list reads by intent instead of by its first prompt; the original prompt stays visible underneath and names persist across relaunches.
Changed
- An unanswered permission now escalates. Instead of a single reminder, ClaudeNotch nudges you again every few minutes (up to three times) while a prompt sits unanswered, replaying the sound and re-posting the notification.
- Tidied the session rows: Resume is the one button, and rename, copy resume command, reveal transcript and delete now live in a single overflow menu.
v0.7.4
July 20, 2026Added
- Keep auto-approve on until you turn it off. Alongside the timed windows, the Session settings page now has a Keep on until I turn it off option for when you want auto-approve to stay on indefinitely, with a matching status and a Turn off now button.
Fixed
- The always-open notch now shows the same detail as it does on hover. With keep-notch-open on, the card used to render the compact version and hid the agent and file counts, model version, effort and git branch until you moved the cursor over it. Held-open and hovered now look identical.
v0.7.3
July 19, 2026Added
- Resume a past session. ClaudeNotch reads the sessions Claude Code keeps on disk, so if you close a terminal by accident you can pick up right where you left off. The Session settings page lists your projects, and each one expands to its recent sessions with the first prompt, how long ago it ran, and a Resume button that reopens it with claude --resume in its original folder.
- Resume Last Session in the menu bar. One click reopens the newest session on disk, named after its project, for the fastest recovery after an accidental close. In the notch, the session history's Resume now reopens the exact session rather than starting fresh.
- A search box over the sessions list. Filter by project name or by anything in a prompt, and matching projects expand so the sessions are visible without a click.
- A preview of the last reply on each session, so you can tell sessions apart before resuming, plus a running badge on any session that is currently live in another terminal.
- Pin the projects you return to most so they stay at the top of the list, a button to copy a session's claude --resume command for your own terminal, and a trash button that moves an old session's transcript to the Trash (recoverable) after a confirmation.
v0.7.2
July 18, 2026Fixed
- A long git branch name no longer crushes the notch. Working on a branch like fix/some-long-feature used to squeeze the context meter and cost down to nothing; the branch is now shortened and the busy row is given room, so everything stays readable.
Changed
- Installing is now a single line: brew install --cask rawsun007/tap/claudenotch. The cask is served from one tap only, so there is no more tap step and no ambiguous-cask error.
v0.7.1
July 18, 2026Added
- A search box in the settings sidebar. Type a setting's name or a keyword and it lists the matches with the page each lives on, so you can jump straight there.
- Setup health in the General settings page. It shows at a glance whether the Claude Code hooks and the status-line forwarder are wired, with a Fix button that reinstalls them in place if either is missing.
v0.7.0
July 18, 2026Added
- A full Settings window, opened with Option-Cmd-comma or from the menu bar. A sidebar (Workspace, Session, Alerts & Cost, Info, Advanced) leads to pages for everything ClaudeNotch does: General, Notch, Pet, Session, Alerts, Sounds, Budget, Privacy, Usage, Developer, and About.
- Per pop-up sounds. With per-tool sounds on, each kind of pop-up (shell commands, edits, new files, notifications, everything else) gets its own sound, each auditionable and overridable.
- A Usage page with a GitHub-style activity heatmap of the last seven weeks (hover a day for its tool-call count), all-time counters, top tools, and token usage with estimated cost read from Claude Code's own transcripts.
Changed
- The menu bar is slimmed to the essentials now that everything lives in Settings: the session status, the update notice, Start Claude in a folder, Recent Projects, Settings, and Quit.
v0.6.0
July 18, 2026Fixed
- Dropping a file or folder on the notch is smooth now. The launch no longer blocks while it finds the Claude CLI, so the dragged icon does not hang on screen, and the notch no longer flickers open a second time after you let go. It opens the drop panel, takes the drop, and closes cleanly.
v0.5.9
July 17, 2026Added
- Drop a file or folder on the notch to open Claude there. Drag a folder over the notch and it turns into a drop panel with a dashed drop zone, blue until the file is right over it and green when it is. Let go and Claude Code opens in that folder; drop a file and it opens in the parent folder with the file already handed to Claude as an @-mention.
v0.5.8
July 17, 2026Fixed
- The branch and the touched-files count no longer vanish from the notch part-way through a long session. When a session compacts or resumes it gets a new internal id, and the notch was losing that detail with it. It now carries across, so a long run keeps showing its branch and what it has edited.
v0.5.7
July 17, 2026Added
- A warning before you hit a plan limit. The notch now tells you as your 5-hour or weekly usage fills, once at 80% and once at 95%, so a lockout in the middle of a task is not a surprise. On by default, and the pet cries about it on the card so the bad news is not grim.
Fixed
- Closing a panel you opened yourself (history, the response detail, an export) returned you to the terminal even when you had opened it from a full-screen browser or chat app. It now returns you to whatever app you were actually in.
v0.5.6
July 17, 2026Added
- An optional alert when a single tool call runs long. Turn on "Alert on Long Tool Runs" and the notch notifies you once when one tool call passes five minutes, so a stuck agent does not sit unnoticed while you are looking elsewhere. It fires once per run, not on a loop. Off by default.
- VoiceOver support. The notch had no accessibility labels, which made every card invisible to blind users. Buttons now read their label and announce as buttons, a permission request reads as one sentence with any danger flagged first, and the status pill announces what Claude is doing.
v0.5.5
July 17, 2026Added
- A live run timer while a tool is working. When Claude sits in one long tool call, the notch now ticks a count beside the command, so you can tell at a glance whether it is still working or stuck. Past a minute it warms to amber. The clock resets on each new tool call and clears the moment the turn ends, so it only ever times something that is actually running.
v0.5.4
July 16, 2026Changed
- The diagnostic log is off unless you ask for it. It only wrote to disk to help with debugging, and there is no reason for normal use to leave a trail of session ids, working directories and costs. Launch with CLAUDENOTCH_DEBUG=1 when you actually need it.
- Usage and cost numbers refresh far more cheaply. The seven-day pass used to re-read and re-parse every recent transcript every thirty seconds. It now reuses the parse of any file that has not changed, so the work drops from over a second to a few milliseconds, with the same figures.
v0.5.3
July 16, 2026Changed
- Hardening from a security pass over the code. The local hook server now caps how much it will buffer from a single request, so a misbehaving process on the same machine cannot make it read without end. The diagnostic log moved out of the shared temp folder into your own Application Support, owner-only and rotated, and the per-session cost reader will not be pointed at an oversized file. None of this changes anything you see; it just closes the doors an audit found open.
v0.5.2
July 15, 2026Fixed
- Playing the Spider-Pet twice in a row stacked two copies of the theme over each other. It now restarts the song instead of layering it.
- The Spider-Pet's mask lenses have a black outline now, like the real suit.
v0.5.1
July 15, 2026Added
- A friendly neighbourhood Spider-Pet, for Brand New Day. Turn Pet Mode on and every so often the mascot suits up, drops head-first out of the notch on a web, hangs upside-down and swings, with a theme to match. Fan build, beta, and wide open to ideas: tell us what he should do next.
Changed
- Background agents (claude --bg) show up in the notch now, named by their task, with one-click attach, and a clear flag when one is stuck waiting on you.
- Session cost is Claude Code's own figure rather than an estimate, and every session shows the permission mode it is running in, not just the one you are looking at.
- Break reminders you never have to start: measured from real activity, off by default.
Fixed
- Question cards no longer clip the option text you open them to read.
- One Claude session shows as one row, not two, and a one-off run in a temp directory is no longer listed as a project.
v0.5.0
July 14, 2026Added
- Background agents in the notch. Claude Code runs agents in a daemon now (claude --bg), with no terminal attached, which is exactly the situation this app exists for: work happening somewhere you are not looking. Each one shows up named by the task it was given, because a background agent has no other label, and you can attach to it in one click. An agent that is blocked waiting for you says AGENT WAITING, since it has stopped, it has no terminal to be stuck in front of, and nothing else on your machine will tell you.
- Break reminders, measured rather than declared. Every notch app's most-requested feature is some kind of pomodoro, and all of them make you start a timer. This one does not need you to: Claude Code's hooks say when work is actually happening, so the stretch is measured. Eight minutes away counts as the break, and after 55 minutes of real work it nudges once. Off by default.
Changed
- The session cost is now Claude Code's own figure rather than our estimate. Everything the app showed about money was computed from the transcript at public per-token prices; Claude Code reports the real number on its status line, in a field the notch had never read. On the session that built this release, ours said $226 and Claude Code said $217.87.
- Every session shows the permission mode it is running in, not just the one you are looking at. A session in another project running with permissions bypassed used to show nothing at all, and that is the one it matters most to see.
Fixed
- A session row could be labelled with a title nobody wrote. Claude Code auto-names sessions, and the notch preferred that name over the project, so the row read "Caveman speech pattern impleme…" where the folder should have been. The project names the row again, with the session name beside it as a subtitle.
- The context and cost appeared twice, a line apart: the header describes the current session, and the list below then drew the same bar for the same session.
- A one-off run in a temp directory was being listed as a project, next to a repo with a fortnight of work in it. It is real work, but it is not a project, and it will not exist tomorrow.
v0.4.0
July 14, 2026Fixed
- The notch works in full-screen apps. Moving the cursor to it did nothing, and you had to leave full screen to reach it. The notch was not ignoring the mouse, it was behind the app: setting isFloatingPanel on the window quietly assigns its level, and it was running after the level we had chosen, so the panel had been sitting at the floating level all along, underneath ordinary windows and underneath anything in full screen.
- The plan limits kept showing an old reading as though it were current, so the notch could say 31% while /usage said 52%. Claude Code only reports usage while a session is redrawing its status line, so the newest reading goes quietly out of date whenever Claude is idle, and it was thrown away entirely when the app restarted. Readings now persist across a relaunch and, once one is more than five minutes old, the row says how old it is. An old number presented as a current one is worse than no number.
- The notch title menu said "Claude" after you chose "Project name". The submenu label was only rebuilt when you clicked one of its rows, which was invisible for the choices that do not depend on the running session, and wrong for the one that does.
v0.3.9
July 13, 2026Changed
- The plan limits live in the history panel now, behind the clock icon. They were in the notch itself, where there was never room for them: the collapsed notch is exactly as wide as the hardware cutout, so they truncated to "8…", and in the hover card they turned a two-line pill you glance at into a dashboard you have to read. The history panel is the screen you open when you actually want numbers, and it is wide enough to print them in full, reset countdowns and all.
Fixed
- A limit whose window had already reset kept showing its old percentage, so the notch could sit there reading "0% · now" as if it were a fact. Claude Code only reports usage when it redraws, so a reading can outlive the window it was measured in. Once the reset instant has passed, the reading shows as unknown until a real one replaces it.
v0.3.8
July 13, 2026Fixed
- Opening the notch hid the rate limits. They live in the collapsed notch's status row, and expanding the notch replaced that row, so the one question you open the notch to answer (how much have I got left, and when does it come back) was the one thing you could not see. The limits now stay when the notch is open, and because the expanded card is wide enough, they print their reset countdowns instead of hiding them in a tooltip.
- The pet faded out on its way back into the notch, so it dissolved in mid-air rather than climbing home, which was worst on the rope where the whole point is a creature hanging in space. It is solid the whole way now. The fade was never doing anything: the retract already carries the pet up behind the hardware cutout, which hides it better than any amount of transparency.
v0.3.7
July 13, 2026Added
- The pet works while Claude works. It used to tuck itself into the notch for the entire length of a tool run, which meant it hid exactly when there was something to watch. Now it comes out and keeps the job company: pacing, bobbing, tracking your cursor. It still never performs over a card you are reading.
- The pet flinches when something goes wrong. A turn that dies (rate limit, overloaded, billing) or a command you deny startles it: arms up, a fast recoil, then a wary look at whatever just happened. It was a mascot for good news only.
- The rate limits show when they reset, not just how full they are. "82%" tells you that you are in trouble but not whether you can wait it out, so the notch now reads "82% · 1h 12m", with the exact reset time in the tooltip.
- The open pull request for the session's branch shows as a badge you can click, tinted by its review state. Claude Code resolves it, so nothing shells out to gh.
Changed
- Sessions are named the way you named them. A session renamed with /rename shows that name rather than its folder, and a session in a git worktree shows which worktree, which is the thing that actually tells two sessions in one repo apart.
- The effort shown is the effort the session is actually running on. It used to be read out of settings.json, which only describes what a new session would start at, so changing effort mid-session left the notch showing the old value.
Fixed
- The notch panel is created in the right place instead of being created at the corner of the screen and moved. It was briefly a card-shaped window in the bottom-left on every single launch.
v0.3.6
July 12, 2026Fixed
- A second, fake notch could appear next to the real one, showing the status bars that are meant to stay hidden behind the hardware cutout. The panel only repositioned itself when a card opened, so anything that moved the screen under it (a Space switch, a resolution change, a display sleeping and waking, plugging in a monitor) left it at a stale position. Since the collapsed notch hides by sitting exactly over the cutout, being off by any amount made it visible. It now re-pins whenever the screen or Space changes, and checks its own position periodically as a backstop.
v0.3.5
July 12, 2026Changed
- The context window is no longer guessed. Claude Code reports the real window size to its status line command, and ClaudeNotch already receives that payload, so it now uses that number rather than working it out from the model name. It is remembered per model, so a new session starts with the truth instead of an inference. Forcing 200k or 1M by hand still overrides everything.
Fixed
- A 1M-window session was being measured against 200k. Opus 4.8 ships the million-token window, but the app inferred window size from a hardcoded list of model names that Opus 4.8 was not on, so a context 16% full was drawn as 81% full with the bar in the red. Beyond taking the real number from Claude Code, the fallback now reads the model's version instead of matching names, so the next model does not reintroduce the same bug.
- The context reading was truncating to "161k / 2…", hiding the one number that gives the other one meaning. It holds its width now, and a million-token window reads as "1M".
- The notch showed a branch icon followed by "m". That was "main", squeezed down to a single letter. Long branch names are shortened from the middle now, and short ones are left alone.
v0.3.4
July 12, 2026Fixed
- Every cost the app showed was inflated, often close to double. Claude Code does not write one transcript line per response, it writes one line per content block, so a turn that thinks, then talks, then calls a tool lands as three lines that all repeat the same usage. All three were being billed. A turn is now charged once. If your numbers drop by half after updating, the new ones are the real ones.
- The Projects tab could show one figure on a project's card and a completely different one in the seven-day header directly above it. The card was adding up costs stored on the app's own session records, most of which are zero. Both figures now come from the transcripts, over the same seven days, so the rows add up to the header.
- The seven-day chart showed one tall bar today and six flat ones, for a week that was not flat. It was drawn from session records, which only exist for sessions the app was running for, so everything else charted as zero. It now reads real per-day spend.
- Sessions in the history read as seconds for work that took an afternoon. Claude Code's Stop hook fires at the end of every turn, not at the end of the session, and the history froze each row on the first one. A row now spans the whole session.
- The history filled with one-second sessions named after folders that do not exist. Every hook carries a working directory, so any stray hook became a "session". A session now needs Claude to have actually done something in it: spent tokens, cost money, or touched a file. Rows already saved under the old rule are swept on launch.
v0.3.3
July 12, 2026Added
- The pet dangles out of the notch on a rope, and the rope is simulated rather than animated. It hops off the lip, falls under gravity while the rope pays its slack out, and when the rope goes taut its velocity splits: the part along the rope is absorbed by the rope's stretch, and the part across it becomes the swing. So it swings because it was still moving sideways when the rope caught it, not because anything told it to. After that it hangs as an elastic pendulum, swinging at the period its rope length and gravity give it and bleeding the energy off.
- The pet celebrates on the task-complete card with a four-beat dance, and flinches on the destructive-command card.
Changed
- The pet moves on real springs. Its drop out of the notch is the step response of a damped spring, and its squash and stretch comes straight off that spring's velocity, so it thins out as it dives and goes wide when it lands.
Fixed
- Session cost was lower than it should have been on any session where Claude used subagents. Subagent turns were being skipped by the per-session meter but counted in the project totals, so the two numbers disagreed. Subagent spend is now counted in both.
- Session timestamps stop counting hours forever. An old session showed "312h ago"; it now reads "13d ago", and past a week it shows the date.
v0.3.2
July 10, 2026Changed
- The orange EDITS badge is gone from the notch. Auto-accepting file edits is a normal way to work rather than something you need warning about, and the badge sat there permanently for anyone who works that way. BYPASS, PLAN, AUTO and DON'T ASK stay, since those flag modes where Claude is doing something you might not expect.
v0.3.1
July 10, 2026Fixed
- The notch could get stuck showing "Thinking" forever after Claude finished a turn that started a background command (a Bash with run_in_background). Claude Code's hooks are not ordered, so that tool's completion hook arrives a second or two after the turn has already ended, and it was flipping the finished session back to a pulsing state that nothing was ever going to clear. A finished turn is now ignored by late hooks until real new work starts.
Changed
- The pet is far calmer. It was on screen about a quarter of every idle minute, which is charming for ten minutes and maddening for an afternoon. Every activity now buys a silence proportional to its own length, so a long nap earns a long absence. It is now visible around 3% of an idle hour.
- The pet is drawn from its pixel grid rather than as a flat image, so it has moving parts: it walks on four legs in diagonal pairs, swings its arms, blinks, watches your cursor, shuts its eyes to sleep, grips the notch with both arms when hanging, and tucks its limbs in to backflip.
Added
- Demos > Pet plays any pet activity on demand without closing the menu, so you can watch the rare ones (like the nap) without waiting for them.
v0.3.0
July 10, 2026Added
- Pet Mode: the Claude mascot lives in your notch. While nothing is happening it peeks out, looks around, hangs off a corner, strolls along the edge, and curls up for a nap after five quiet minutes. When a task finishes, it hops with sparkles.
- The pet is interactive. It watches your cursor and turns to face it, holds still to be petted while you rest the pointer on it, and boops when you click it. Boop it five times in a row and it backflips.
- The notch icon now breathes at the pace of whatever Claude is doing, so a glance tells you it is thinking, running a tool, or idle before you have read the status text.
- Pet Mode is on by default, respects the system Reduce Motion setting, never appears over an active session or a card you are reading, and can be switched off from the menu bar.
- Demos > Pet plays any pet activity on demand, without closing the menu, so you can watch the rare ones (like the nap) without waiting for them.
v0.2.61
July 9, 2026Fixed
- The hover-expanded idle card used a fixed width, which left a big empty gap on a sparse session (no model/branch/cost detected yet) and could still truncate a busy one. The card now measures its actual content and sizes itself to that.
- Model name could get squeezed down to just "…" when the card was near its width limit. It now holds its own space like the rest of the row.
v0.2.60
July 9, 2026Changed
- The idle notch card was showing everything at once (agent count, file count, model version, effort, git branch, context %, cost) and it got cramped, especially with persistent notch display on. Secondary detail is now hidden until you actually hover over the card; name, status, model, context %, and cost stay visible at all times.
Fixed
- Context % and cost could get squeezed down to unreadable fragments like "8…" and "$…" once the hover-revealed detail filled the row. They're now the highest layout priority in the row and the hover card is wider, so nothing gets truncated.
v0.2.59
July 6, 2026Fixed
- Permission cards could go dead if you took more than 30 seconds to respond: Claude Code would give up and print its own yes/no prompt in the terminal, and answering the notch card afterward (even with Touch ID) silently did nothing. The hook timeout now matches how long the app actually waits for you, so a card stays live for the same window it visually promises.
v0.2.58
July 6, 2026Fixed
- Always-Allow rules could silently approve a dangerous command (rm -rf, sudo, force-push) with no Touch ID or hold-to-confirm. Dangerous commands now always show the guardrail card, even when a matching rule exists.
Changed
- Always-Allow Rules in the menu bar is now a submenu listing every rule individually, each removable on its own, instead of only an all-or-nothing Clear.
v0.2.57
July 3, 2026Added
- Reply from the notification: completion banners now have a Reply action with an inline text field. Type a follow-up and Send, and it lands in the terminal that ran the session, or a fresh terminal opens in the project folder with your message as the first prompt.
- Git branch per session: the checked-out branch (read from .git/HEAD, worktrees included) shows next to the model in the header and beside each project in multi-session rows.
- Today's spend in the menu bar: optional live readout next to the icon, e.g. "2 · $1.24", showing working sessions plus today's estimated cost. Toggle: Show Today's Spend in Menu Bar (off by default).
v0.2.56
July 3, 2026Added
- Privacy: the notch is now invisible in screen shares, recordings, and other apps' screenshots, since it renders commands, file paths, and code that don't belong in a Zoom call. You still see it live; viewers don't. Toggle: Hide from Screen Recordings (on by default).
- Waiting-on-you timer: permission cards show "waiting 2m" once they pass a minute, multi-session rows get an orange elapsed chip for unanswered prompts, and after 3 minutes the alert sound replays once and the notification re-posts. One nudge per request, never a nag loop.
- Files touched: every file Claude edits is tracked per session. The notch shows an "N files" chip, and a Files Touched menu lists them newest-first, so you can click to open in your editor, or Reveal All in Finder.
v0.2.55
July 3, 2026Added
- API failure alerts: when a session dies from a rate limit, server overload, billing error, or auth failure (Claude Code's StopFailure hook), the notch shows a red alert card with the reason and mirrors a banner to Notification Center. Long tasks no longer die silently while you're away.
- Permission-mode badge: sessions running in non-default modes get a colored badge in the notch header: red BYPASS for --dangerously-skip-permissions, blue PLAN, orange EDITS / DON'T ASK, teal AUTO.
- Sessions appear instantly: the SessionStart hook is now wired, so a session shows in the notch the moment it opens (with the correct model name from the first second) instead of after the first tool call. Session titles are shown in multi-session rows when set.
Changed
- Existing installs are auto-migrated to the new hook events on next launch, with no manual reinstall needed.
v0.2.54
July 3, 2026Added
- Copy button on the last-reply detail card: one click (or ⌘C while the card is open) copies Claude's full reply to the clipboard, with a brief "Copied" confirmation.
- Resume buttons in history: hovering a session or project row reveals a green Resume button that opens a new terminal in that directory and launches Claude.
- Session history export: the Sessions tab now has an Export button that saves all recorded sessions (times, project, duration, tokens, cost, tool calls, model) as CSV or JSON.
- 7-day spend trend on the Projects tab: a compact sparkline of daily cost with the trailing-week total and session count.
v0.2.53
July 2, 2026Added
- Daily spend digest: on first launch each day, if yesterday had sessions, ClaudeNotch can send a notification showing yesterday's total cost, session count, and top project (e.g. "Yesterday: $2.40 · 5 sessions · top: my-app"). Enable it via the new Daily Spend Digest toggle in the Permissions submenu. Off by default.
- The Insights menu digest row now shows cost and session count from session history, in addition to tool counts.
v0.2.52
June 30, 2026Added
- Completion notifications now have their own toggle (Notify When Claude Finishes) in the Permissions submenu, independent of the permission-prompt mirror. Off by default, so opt in when you want banners on task completion.
v0.2.51
June 29, 2026Fixed
- Model name now updates correctly when the status line arrives without a context percentage (common early in a session or on plan-only updates). Previously the model string was silently dropped in that case.
- Switching to a fresh session no longer clears the displayed model name. The notch now retains the last known model until the new session reports its own.
v0.2.50
June 29, 2026Added
- Global keyboard shortcut: press ⌘⌥Space from any app to toggle the history panel open or closed, with no need to click the notch or menu bar.
- Native completion notifications: when Claude finishes a task and you are in another app, a macOS banner notification fires with the project name and response snippet. Controlled by the existing Mirror to Notification Center toggle.
v0.2.49
June 26, 2026Added
- Projects tab in the history panel: session history is now grouped by project, showing each project's total sessions, time spent, tokens consumed, cost, and tool calls. A relative cost bar lets you compare projects at a glance. The history drawer now has three tabs: Sessions, Projects, and Events.
v0.2.48
June 25, 2026Added
- Menu bar badge: a live session count now appears next to the menu bar icon whenever one or more Claude sessions are actively working. The number disappears when all sessions are idle, so a non-zero count means Claude is running right now, visible without opening the notch.
v0.2.47
June 25, 2026Added
- Session history panel: the history drawer now opens to a Sessions tab showing a summary of every completed Claude Code session: project name, when it ran, duration, token count, cost, and number of tool calls. Sessions are archived on Stop/SessionEnd/stale timeout and persist across app restarts. The existing per-tool-call event log is still available on the Events tab.
v0.2.46
June 25, 2026Added
- The context bar in the expanded notch now shows actual token counts (e.g. "45k / 200k") instead of just a percentage. The bar color warms from blue to orange to red as the window fills, and the running session cost appears alongside it. Multi-session rows get the same upgrade.
v0.2.45
June 24, 2026Fixed
- The "N agents" badge now appears in single-session mode. Previously it only showed in the multi-session list view, so if you had one project open the badge was invisible even while subagents were running.
v0.2.44
June 24, 2026Fixed
- The subagent indicator now stays visible while agents are running. A purple "N agents" badge appears next to the project name and is tracked as a counter on the session, so it survives tool-activity label updates that would otherwise overwrite it immediately.
v0.2.43
June 24, 2026Added
- The notch now shows when Claude spawns a subagent. While an agent is running you'll see its type in the activity strip (e.g. "Agent: Explore"). When it finishes the session goes back to its normal thinking state instead of showing a spurious "Claude finished" notification for each agent.
v0.2.42
June 23, 2026Fixed
- Session rows now show the current working directory accurately. When Claude changes directory during a session (cd, worktree switch, etc.) the project label in the notch updates to match. Previously it kept the original directory for the whole session.
v0.2.41
June 23, 2026Changed
- Hooks now use Claude Code's native HTTP hook type instead of shell scripts. Claude Code posts events directly to the running app over localhost, so there are no shell scripts to trust and no jq dependency at runtime. Re-run Setup in the app or install-hooks.sh to migrate; existing command-hook installations continue to work.
v0.2.40
June 16, 2026Fixed
- The command-line hook installer (used when installing from source) now preserves any other Claude Code hooks you already have, instead of replacing them with only ClaudeNotch's. The in-app Setup already did this; the script now matches it. Most people install via the app and were never affected.
v0.2.39
June 16, 2026Fixed
- Fixed a rare crash that could happen when no display was attached, for example with the laptop lid closed and no external monitor connected, or while displays were being reconnected. The notch now falls back gracefully instead of quitting.
v0.2.38
June 11, 2026Fixed
- Deny-with-a-reason now works for non-English text. A longer reason written in a language like Japanese or Chinese could be cut mid-character and then dropped entirely, so Claude received a bare deny with no explanation. Reasons are now trimmed safely on character boundaries.
v0.2.37
June 10, 2026Fixed
- Question cards no longer carry over state between prompts. When two sessions each asked a question and they showed one after another, the second card could keep the first one's selected options or typed answer, and a question with a different number of parts could leave some unanswerable. Each prompt now gets a clean card. The hold-to-confirm progress on a permission card also no longer carries over to the next request.
v0.2.36
June 9, 2026Fixed
- You can now paste into the notch's text fields. Pasting (Cmd+V) into the "type your own answer" field, the quick compose box, and the search box did nothing before, because the menu-bar app had no Edit menu for the shortcut to hook into. Cut, Copy, Paste, and Select All now all work.
v0.2.35
June 9, 2026Fixed
- More multi-session polish. After one of several sessions ended, the notch could jump to the wrong session (the oldest one) instead of your most recently active one; it now picks the right session. The top lists in the Claude Usage menu (busiest hours, top tools, by model, by project) also no longer reshuffle when entries are tied.
v0.2.34
June 8, 2026Fixed
- Stable order for multiple sessions. When more than one Claude session was running, the rows in the notch reshuffled their position about once a second. They now keep a fixed order based on when each session started, and a new session simply appears at the bottom instead of bumping the others around.
v0.2.33
June 6, 2026Added
- Personalise the notch title. The first part of the title used to always read "Claude". A new Notch Title menu now lets you choose what it shows: Claude (the default), Project name (which tracks whatever project is active and falls back to Claude when there is none), or a Custom label you type in. Handy when you run several projects at once and want the notch to say MyApp instead of Claude. Thanks to Luca Galli (@Lvcaa) for suggesting it.
v0.2.32
June 5, 2026Added
- Real plan-limit usage in the status bar, and you choose what it shows. The bottom bar used to estimate usage by dividing a guessed dollar cost by a hardcoded cap, which read 100% for heavy users with no way to change it. It now reads the authoritative numbers Claude Code itself reports: real 5-hour and weekly plan-limit usage, plus true context-window usage. Pick any two items to show via menu, Status Bar: 5h plan limit, Weekly plan limit, or session cost. You can also override the context window there (Auto / 200K / 1M). Heads-up: to read those numbers, ClaudeNotch now installs a status line forwarder into Claude Code. It chains to whatever status line you already had so your terminal display is unchanged, is captured and restored if you uninstall, and degrades gracefully if the app is not running. Thanks to Luca Galli (@Lvcaa) for this one.
Fixed
- The context bar is now accurate. Sessions on the 1M context window read far too high (a 50k-token session showed 25% instead of 5%) because the bar always divided by 200k; it is now model-aware. Sub-agent (Task) turns no longer deflate the reading, and the bar clears immediately when context is compacted instead of holding a stale-high value. Thanks again to Luca Galli (@Lvcaa).
v0.2.31
June 4, 2026Added
- A cleaner idle pill. The collapsed notch header now leads with the Claude brand icon, followed by the project name, a small status dot, and the status text on a single tighter line, so more reads at a glance while Claude is idle. Thanks to Luca Galli (@Lvcaa) for the redesign.
Fixed
- Loading a skill now shows which one. When Claude Code invoked the Skill tool, the notch showed nothing useful. It now reads the skill name (and args) and shows it in the command strip with a wand icon, with matching "Load skill" and "loading skill" labels on the cards. Thanks again to Luca Galli (@Lvcaa).
- Status labels in the idle pill are now capitalised (Ready, Thinking, Running command).
v0.2.30
June 4, 2026Added
- Make a cost cap a real ceiling, not just a warning. Cost Budget has a new "Enforce: block new commands at 100%" toggle. With it on, once a session or daily cap is reached, the next tool or command Claude tries is held in the notch for a decision instead of running, even when you have auto-approve or an always-allow rule on. The card shows what is over budget and gives you Deny, Allow once, Raise to the next preset above your spend (so the run can continue), or Turn off. Pressing Enter does not auto-allow a budget block, the same as a destructive command, so you can't blow past a cap on muscle memory. Note this gates tool and command calls, which is what drives runaway spend; sending a message and getting a reply are not blocked. There is also a "Budget Hard-Stop" entry under Demos. Off by default.
v0.2.29
June 4, 2026Added
- Act on permission prompts from the lock screen or another Space. Blocking permission requests now also arrive as native macOS notifications, so you don't have to be looking at the notch to respond. Safe commands get Allow, Deny, and Deny with reason right on the banner; dangerous commands offer Deny only, and Allow still brings you back to the Mac to confirm with Touch ID (the Allow action also requires unlocking first). Because they are real macOS notifications, they automatically respect Focus and Do Not Disturb: during a Focus session the banner stays quiet and the request waits for you in Notification Center and on the lock screen. They carry no sound, since the notch already chimes when you are at your desk. You can turn the whole thing off under Permissions, "Mirror Alerts to Notifications".
v0.2.28
June 3, 2026Added
- Search, filter, and export your activity history. The activity drawer (the clock in the notch) used to keep only your last 50 decisions with no way to look anything up, so it emptied out fast. It now keeps up to 500, with a search box that filters live across the tool, command, project, and details as you type, plus quick filter chips for All, Allowed, Denied, Risky, and Q&A. A new Export button saves the whole log to a file as JSON or CSV (just name it .csv), so you have an audit trail of everything Claude asked and how you answered.
v0.2.27
June 1, 2026Added
- Confirm dangerous commands with Touch ID. Destructive actions like rm -rf or sudo can now be approved with Touch ID (or Face ID) instead of press-and-hold. Tap "Confirm to Allow" and authenticate, and only a successful fingerprint runs the command. Turn it on or off under Permissions, "Require Touch ID for dangerous commands" (on by default when your Mac has biometrics); with it off, the press-and-hold button stays exactly as before.
- See which projects cost you the most. The per-project breakdown under Claude Usage now sorts by cost, highest first, and leads with the dollar figure, so your priciest repos for the week stand out at a glance.
v0.2.26
June 1, 2026Added
- Set a spending cap and get a heads-up before you blow past it. A new Cost Budget menu lets you cap spend per session (say $5) and per day across all your sessions (say $25). As you approach a cap, the session's cost figure in the notch warms orange and then red, and you get a card at 80% and again at 100%. Setting a cap checks what you have already spent right away, so it works even if you set it mid-run. The figures are estimates from public pricing, so treat the caps as a guardrail rather than a hard limit. There is also a "Cost Budget Alert" entry under Demos so you can see exactly what the warning looks like.
v0.2.25
May 30, 2026Fixed
- Replies and composed messages now reliably type into your terminal. The composer used to send by driving AppleScript, which needs the separate Automation permission and could fail with nothing appearing in your session. It now types using synthesized key events, which need only the Accessibility permission ClaudeNotch already uses, so a reply lands in the running Claude session as expected.
- The composer shows which session you are replying to. When you hit Reply on a finished task, the header now reads the project alongside the terminal it runs in (for example "claude mac app · Terminal") instead of just "Terminal", so it is clear where your message is going.
- Clearer prompt when typing needs permission. If Accessibility is not granted yet, sending no longer fails silently. ClaudeNotch opens the system prompt and the right Settings pane, keeps your text, and tells you to enable it and press Send again.
- Fixed the composer's placeholder sitting on a different row than the blinking cursor, so the hint and the caret now line up.
v0.2.24
May 30, 2026Added
- Deny a permission with a reason. The permission card now has a small speech-bubble button next to Deny. Tap it and a quick editor opens where you can tell Claude what to do instead, for example "use ripgrep instead of grep" or "write it to a temp file first". Claude receives your note and adapts, instead of just being blocked. A plain Deny (or Esc) still denies instantly with no note.
- Reply to Claude straight from the finished card. When a turn completes, the card now has a Reply button that opens the composer already pointed at that session, typing into the same terminal it ran in (or opening a fresh one in the project folder if that terminal has closed). You can send a follow-up without switching windows.
- Type your own answer to a question. When Claude asks you to pick from options, each question now has a "Something else…" field, so you are not limited to the presets. For a single-choice question your typed answer is used; for a multi-choice one it is added to whatever you have ticked. Either way Claude receives it just like a picked option.
v0.2.23
May 30, 2026Fixed
- Sending a multi-line message from the notch composer now works. If your message ran to more than one line, it used to silently fail to type into your terminal and nothing was sent. Each line is now typed correctly, so longer messages go through.
- The Insights totals stay accurate when you approve a batch at once. When Claude fired several identical requests and the notch folded them into a single card, approving or denying it only counted as one decision in your allow and deny tallies. Each folded request is now counted, so the numbers match what actually happened.
- A handful of small robustness fixes under the hood, including guarding against a rare crash when no display is attached and tidying up the global hotkey when the system declines to register it.
v0.2.22
May 30, 2026Added
- A context and cost meter on each session. The notch now shows how full Claude's context window is and a running estimate of what the session has cost so far, next to the model name. The little bar warms from blue to orange to red as the window fills up, so you get a heads-up before Claude pauses to compact, and it switches to "compacting context" while that happens. It handles both the standard and the 1M-token context windows automatically. Cost is an estimate from public pricing, not a real bill, and it lives right on the session row so you can keep an eye on long runs without leaving your editor.
v0.2.21
May 29, 2026Added
- A live command strip in the notch. While Claude is working, the notch now shows what it's doing right now, the active tool with an icon and its target (for example a pencil next to "Edit: src/foo.swift"), with the status label gently shimmering. The moment a tool is approved the strip updates to show it running, and it switches to "Thinking" between steps, so the notch reflects what's happening as it happens instead of lagging a step behind. Thanks to @Lvcaa.
v0.2.20
May 29, 2026Added
- More prompts now reach the notch. Approvals that Claude Code raises separately from a normal tool run, like "proceed with this plan?" after plan mode and the confirmation for updating its to-do list, used to appear only in the terminal. They now show up as a card in the notch so you can approve or deny them without switching back. If the notch can't handle one for any reason, Claude's usual terminal prompt still runs, so nothing ever gets stuck.
Fixed
- The status line under the notch no longer flickers between two sessions. When you had more than one Claude session open, or had just closed one, the last-reply line could rapidly switch back and forth between them. The notch now pins that line to the session you're actually watching.
v0.2.19
May 29, 2026Added
- Task progress in the notch. When Claude works through a multi-step task list, each session's row now shows a small progress bar with a running count like "3/5", so you can see at a glance how far along it is. The bar fills as tasks complete and turns green once they're all done. It appears automatically whenever Claude uses its task list and clears when a new list starts.
Fixed
- Reinstalling over a running copy now actually swaps in the new version. The installer used to just re-focus the already-running app, so an update could silently keep the old build in memory until you quit and reopened it. It now restarts the app on install.
v0.2.18
May 29, 2026Added
- Multi-session awareness. When you run more than one Claude Code session at a time, the notch now tracks each one separately instead of collapsing them into a single status. The header shows how many sessions are live (e.g. "Claude · 2 sessions"), and opening the notch lists each session by project with its own live status and a dot that pulses while that session is working. Tap a session's row to read its latest reply. Sessions drop off the list as soon as you exit Claude (Ctrl+C / Ctrl+D / exit) or close the terminal, so the list reflects only what's actually running.
v0.2.17
May 28, 2026Added
- Optional persistent notch display. When turned on, the notch stays open while Claude works and shows a live status line (Claude thinking, running Bash, editing, replying, done) with Claude's latest output as it streams in, and the status dot pulses while Claude is busy. It's off by default and keeps the usual hover-to-open behavior; enable it with "Persistent Notch Display" in the menu bar. Thanks to @Lvcaa.
v0.2.16
May 28, 2026Added
- New "Claude Usage" section in the menu bar shows how much you've used Claude Code itself: tokens and an estimated cost for today and the last 7 days, broken down by model and by project, a 7-day token sparkline, your prompt-cache hit rate and the cost it saved, your busiest hours, and sessions with average tokens each. Token counts come from Claude Code's own local transcripts; cost is an estimate from public API pricing (a subscription isn't billed this way). This is separate from the existing Insights menu, which tracks ClaudeNotch's own permission and tool activity.
v0.2.15
May 28, 2026Fixed
- Your usage stats no longer reset when you update to a new version. The stats were always saved locally, but the app used to throw away the entire saved file whenever a release added a new field to it, so every update looked like it wiped your history. The app now reads older saved files field by field and keeps everything it can, so your stats and history carry across updates.
- Answering an AskUserQuestion in the notch no longer also leaves the terminal waiting for input. The notch used to let Claude Code render its own prompt and then type your answer in for you, which could miss if the timing or window focus was off. Your selection in the notch is now sent straight back to Claude, so the terminal never asks a second time.
v0.2.14
May 27, 2026Changed
- Notification and completed cards now lay their buttons inline next to the title and detail (instead of a separate bottom row), and the timestamp moves up next to the source label. Cards read tighter and more like a native macOS notification. Permission cards keep their bottom button row since diffs and long commands need the horizontal space. Thanks to @Lvcaa.
v0.2.13
May 27, 2026Changed
- Notch card horizontal padding bumped from 22 → 28 pt for a softer left/right rhythm, and extracted into a single named constant so it's easy to tune in one place. Thanks to @Lvcaa for the refactor idea.
v0.2.12
May 27, 2026Changed
- Balanced the spacing around the buttons row in every card (permission, notification, completed, response detail, history, composer, question). Previously buttons were tight against the content with a lot of empty space below; now there's roughly equal breathing room above and below the row.
v0.2.11
May 26, 2026Added
- TodoWrite prompts now surface in the notch with a checkbox preview of the proposed todos (□ pending, ▣ in-progress, ✓ done). Previously they were routed to the terminal.
- ExitPlanMode ("Approve plan") cards now render the proposed plan markdown right in the card, so you can read what Claude wants to do before approving.
v0.2.10
May 26, 2026Fixed
- "Check for Updates…" now shows an alert in every case: a Download/Later dialog when a new version is out, "You're up to date" when not, and a "Couldn't check" warning on network errors. Previously it could silently update the (closed) menu and look like nothing happened. Also brings the app to the front so the alert can't hide behind other windows.
- First-launch instructions (README, website Install, FAQ, DMG README) updated for macOS Sequoia 15+, which removed the right-click → Open bypass. The new path is: double-click → Done → System Settings → Privacy & Security → Open Anyway. Or install via Homebrew, which strips the quarantine attribute entirely.
v0.2.9
May 26, 2026Changed
- Swift 6 concurrency cleanup: replaced explicit NSLock lock/unlock pairs in EventServer with the modern withLock { } closure, and marked TerminalAutomator.debugLog as nonisolated. No behavior change, just a cleaner, exception-safe foundation. Thanks to @simo-hue.
v0.2.8
May 26, 2026Fixed
- The Sound submenu no longer closes when you pick a sound, toggle Per-tool sounds, or toggle Mute. You can now audition sounds back-to-back without re-opening the menu each time.
v0.2.7
May 26, 2026Added
- Activity heatmap in the Insights submenu: a 7-week grid showing when you've been active.
- Daily digest: once a day, Insights surfaces a quick "Yesterday: X tools, Y allowed, Z denied, W risky" line.
- Timed Auto-Approve: turn it on for 5, 15, 30, or 60 minutes and it reverts automatically. Survives restarts safely (timed state is never persisted as permanent).
- Snooze (15/30/60/120 minutes) suppresses notifications and completion cards. Permission cards still show, because Claude is waiting on them.
- Sound submenu: pick from 13 system sounds for alerts, or turn on Per-tool sounds so Bash, Edit, Write, and notifications each get their own chime.
- Group similar prompts: when the same tool fires repeatedly within 5 seconds, the card collapses to "(×N) command" and one tap resolves all of them.
- Welcome demo on first run: finish Setup and a sample card appears so you immediately see what the notch looks like.
v0.2.6
May 26, 2026Fixed
- Destructive-command detection now catches split flags (rm -r -f) and long forms (rm --recursive --force), not just combined (rm -rf). Closes a real guardrail bypass. Thanks to @simo-hue for spotting it.
- Hook installation no longer wipes existing user hooks in ~/.claude/settings.json. ClaudeNotch's entries are appended (and de-duped on reinstall), so any other hooks you have at PreToolUse/Stop/etc. are preserved.
v0.2.5
May 25, 2026Added
- Insights: a menu-bar view of your usage, covering approvals, denials, risky commands flagged, most-used tools, plus active days and streak. All local.
- In-app update checker: ClaudeNotch now tells you when a newer version is out and links straight to the download, with a manual "Check for Updates…" too.
- An Auto-Approve (Live Activity) demo so you can preview the button-less auto-approved card.
Fixed
- Demos always show their UI now, even if you have an always-allow rule or Auto-Approve turned on.
v0.2.4
May 22, 2026Fixed
- Esc reliably closes any card, and keys no longer beep when another app is focused (handled via a global event tap, with no focus stealing).
- Auto-approve now uses a soft, debounced sound, Esc dismisses the auto-approved card, and it stays visible for 4 seconds.
- Compose caret is aligned with the placeholder text.
- The DMG disk image now shows the ClaudeNotch logo.
v0.2.3
May 22, 2026Added
- Auto-Approve All toggle (menu bar + onboarding): allows every tool automatically and just shows what's changing; destructive commands still ask.
- Mute Sounds toggle.
- Allow All (N): one tap or Enter approves multiple simultaneous permission prompts.
- Send Message to Claude: pick a recent project to open a terminal with your message as the first prompt.
Fixed
- Open/close animation now runs even over other apps and in fullscreen.
- Fixed the blank AskUserQuestion card, so text and options now render.
v0.2.2
May 22, 2026Fixed
- Open/close animation runs even when another app is frontmost or fullscreen (timer-driven, no longer paused in the background).
- Keyboard returns to the terminal automatically after you press Enter.
- Open IDE works reliably.
- Cards no longer clip their buttons at the bottom.
Changed
- Menu cleaned up: Demos and Permissions submenus, Title Case.
- Real Claude logo for the app icon and menu bar.
v0.2.1
May 21, 2026Added
- Launch at Login, with macOS approval handling.
Fixed
- Keyboard returns to the terminal automatically after Enter (no more stuck keyboard or error beep).
- Open IDE now works reliably every time.
- Start Claude in Folder actually launches the CLI (resolves the real claude path).
v0.2.0
May 21, 2026Added
- Real Claude logo (app icon + menu bar).
- Smooth grow-out-of-the-notch animation (fixed-window, boring.notch-style).
- Cards size to their content with proper padding on all sides.
- Persistence, pattern-based always-allow rules, and a global hotkey (⌥⌘N).
- Multi-line compose, diff previews, destructive-command warnings, and a history drawer.
v0.1.0
May 20, 2026Added
- First release: a Dynamic Island-style notch UI for Claude Code.
Stay on the latest
ClaudeNotch updates often. Download the newest build to get every fix and feature above.
Download ClaudeNotch for macOS