Agent Notch 0.3.5

Agent Notch 0.3.5

A small follow-up to 0.3.4: the menu no longer asks for your Mac password, and the hover panel
shows only your agents.

What's fixed

• Opening the menu no longer asks for the Mac login password. The menu read the Keychain every
  time it updated, and because Agent Notch is a non-activating panel the prompt had no focused
  window: the first keystroke went nowhere until you dismissed it and tried again. The menu now
  uses a non-secret flag, polling starts only once the app is active, and disconnecting activates
  the app before it touches the Keychain. A one-time migration adopts connections made before this
  release, so nobody is asked to reconnect.
• The hover panel lists agents, not deployments. The expanded notch rendered every production
  Vercel deployment above your sessions (up to a hundred rows of project, state, repository, commit
  and author). That section is gone. The collapsed badge still shows a running build, and the
  notification body still carries the deployment details.

Also in this release (Worker side, no app change)

• The connection page after authorizing Vercel is a proper page you can close, with a readable
  reason when something fails.
• Disconnecting now asks Vercel to revoke the token as well as deleting the local session.

Upgrading from 0.3.4

Quit Agent Notch, replace the app in Applications, and reopen it. If macOS asks once for Keychain
access on the first launch, allow it: the app is ad-hoc signed, so a new build has a new identity.
Reconnecting once from the new build removes the prompt for that build.

Install

1. Download AgentNotch-0.3.5.dmg, drag Agent Notch to Applications.
2. This build is not notarized: the first time, try to open it, then go to
   System Settings → Privacy & Security, scroll down to Security, click Open Anyway and
   confirm.
3. Click Connect when the app offers it (or choose Connect agents… from the menu bar item).
4. Restart any running Claude Code / Codex / Pi session.
5. Optional: choose Connect Vercel… and authorize to see production deployments in the notch.

On macOS 14 the installer needs jq (brew install jq); macOS 15 and later include it.

Known limitations

• Not notarized yet (see above).
• Ad-hoc signing: a rebuilt app can ask for Keychain access once. A Developer ID signature would
  remove that.
• The Vercel integration is not listed publicly; connecting uses the Agent Notch integration. If you
  fork the project, deploy your own Worker and register your own integration.
• Disconnecting removes the local credential and asks Vercel to revoke the token; if Vercel rejects
  the revocation (logged as a non-200 revoke), remove the integration in Vercel as well.
• Gentle Shell phase poses require explicit gentle_odd_phase reports.
• Codex task-list rendering remains untested on real runs.

Checksum

SHA-256 for AgentNotch-0.3.5.dmg:

0aeb00479b7a41e608c0730aecb486fc8bdaac4e1169416fe79fffa23f0f5a99  AgentNotch-0.3.5.dmg

Agent Notch 0.3.4

Agent Notch 0.3.4

Production deployments from Vercel can now appear in the notch, quietly and only if you connect
them.

What's new

• Vercel deployments (optional). Choose Connect Vercel… in the menu bar, authorize the
  integration, and the notch starts showing your production deployments. While a build runs you get
  a small Vercel badge with a state dot when the notch is otherwise idle; project, repository,
  commit and author are in the expanded list, one hover away. It stays completely off, and hidden,
  until you connect.
• Silent by default. Deployment notifications are off unless you enable them, and when enabled
  they are passive: no sound, no interrupting banner.
• A quiet notch. A deployment never resizes or shifts the notch. The collapsed width comes from
  agent activity only.

What changed

• The collapsed n/m step strip is gone. Step progress is still in the expanded list, so the
  collapsed notch no longer grows to show it. If you relied on it, this is the one visible
  regression in this release.
• Notifications about a deployment that finished while the app was closed are no longer announced;
  only transitions observed while it runs notify.
• The app no longer sends anything anywhere without your action: the single outbound request it can
  make is the Vercel connection you start yourself. The privacy section of the README says exactly
  what leaves the Mac and what does not.

What's fixed

• Connecting a personal Vercel account works: the token exchange returns no team, and the Worker no
  longer rejects it.
• A redirect from the authorization endpoint is refused instead of leaving an opaque Cloudflare
  error page.
• An expired or revoked Vercel token now asks you to reconnect instead of showing a generic network
  failure.

Upgrading from 0.3.3

Quit Agent Notch, replace the app in Applications, and reopen it. The hook bridge, the installer and
the Pi extension are unchanged. Vercel stays disconnected until you connect it.

Install

1. Download AgentNotch-0.3.4.dmg, drag Agent Notch to Applications.
2. This build is not notarized: the first time, try to open it, then go to
   System Settings → Privacy & Security, scroll down to Security, click Open Anyway and
   confirm.
3. Click Connect when the app offers it (or choose Connect agents… from the menu bar item).
4. Restart any running Claude Code / Codex / Pi session.
5. Optional: choose Connect Vercel… and authorize. Only production deployments of the projects
   your integration can see are read.

On macOS 14 the installer needs jq (brew install jq); macOS 15 and later include it.

Known limitations

• Not notarized yet (see above).
• The Vercel integration is not listed publicly. Connecting uses the Agent Notch integration; if you
  fork the project, deploy your own Worker and register your own integration
  (integrations/vercel-worker/README.md).
• Disconnecting removes the local credential but does not revoke the token in Vercel; remove the
  integration in Vercel for that.
• Gentle Shell phase poses require explicit gentle_odd_phase reports.
• Codex task-list rendering remains untested on real runs.

Checksum

SHA-256 for AgentNotch-0.3.4.dmg:

7f385526d10f80269676023e711c2a5830eb9fae79884d5a1528934146337876  AgentNotch-0.3.4.dmg

Agent Notch 0.3.3

Agent Notch 0.3.3

Claude desktop plan updates now advance the task list instead of leaving it stuck.

What's fixed

• Incremental update_plan calls advance the existing list. The Claude desktop app sends items only on its first call; later calls carry advance (finish the running step and start the next pending one), done and start (1-based step numbers), or wrap_up (finish every step). Those now move the steps already on screen instead of leaving a stale checklist or showing the raw JSON in the row.
• Incremental changes apply on PreToolUse only, so PostToolUse does not advance the same step a second time.
• The list keeps its identity between updates, so the collapsed strip and the expanded checklist move one step at a time instead of jumping back.

Upgrading

Quit Agent Notch, replace the app in Applications, and reopen it. Nothing else is needed: the hook bridge, the installer and the Pi extension are unchanged since 0.3.1.

Install

1. Download AgentNotch-0.3.3.dmg, drag Agent Notch to Applications.
2. This build is not notarized: the first time, try to open it, then go to System Settings → Privacy & Security, scroll down to Security, click Open Anyway and confirm.
3. Click Connect when the app offers it (or choose Connect agents… from the menu bar item).
4. Restart any running Claude Code / Codex / Pi session.

On macOS 14 the installer needs jq (brew install jq); macOS 15 and later include it.

Known limitations

• Not notarized yet (see above).
• Gentle Shell phase poses require explicit gentle_odd_phase reports; inferred phases do not change the mascot.
• Codex task-list rendering remains untested on real runs.
• This build does not monitor Vercel deployments. That prototype stays on main and is not part of 0.3.3.

Checksum

SHA-256 for AgentNotch-0.3.3.dmg:

dc55021f9f87d720f2032440bddcdbbfa1242f96ada9492e7fbed92af8296fa7  AgentNotch-0.3.3.dmg

Agent Notch 0.3.2

Agent Notch 0.3.2

What's changed

• Latest activity first on hover: agent groups now follow their most recent session activity, with the newest sessions first inside each group.
• Claude desktop task lists: task-list updates from the desktop app's update_plan MCP tool now appear as steps in the notch instead of raw JSON, alongside existing Claude TodoWrite and Codex update_plan support.
• Gentle Shell ODD phase mascots: exploring/researching shows a magnifying glass; authorizing/deciding/planning a lightbulb; checking a clipboard; and closing a gift box. Implementing keeps the normal working pose. Includes refreshed Gentle Shell sprites.
• Clearer mascot documentation: illustrated state guides for Claude Code, Codex and Gentle Shell in the English, Spanish and German READMEs.
• Project maintenance: contribution and security policies, issue and pull-request templates, CI, dependency-update configuration, and regression tests for hover ordering.

Upgrading / install

Requires macOS 14 or later. Download AgentNotch-0.3.2.dmg.

• Upgrading from 0.3.1: quit Agent Notch, replace the app in Applications, and reopen it. No new hook installation is needed: the hook bridge, Pi extension and hook installer are unchanged since 0.3.1.
• First install: drag Agent Notch to Applications, open it, choose Connect agents…, then restart your agent sessions. On macOS 14, the hook installer requires jq (brew install jq).

Known limitations

• This build is ad-hoc signed and not notarized. If macOS blocks the first launch, try opening the app, then use System Settings → Privacy & Security → Open Anyway and confirm.
• Gentle Shell phase poses require explicit gentle_odd_phase reports; inferred phases do not change the mascot.
• Codex task-list rendering remains untested on real runs.

Checksum

SHA-256 for AgentNotch-0.3.2.dmg:

44310c9578af689b43b4a735ca3c1a7e5169d65e2fe3540b5c2d31c4f46e8b40  AgentNotch-0.3.2.dmg

Agent Notch 0.3.1

Agent Notch 0.3.1

Questions from Claude now show up as questions.

What's fixed

• Claude's question tool (AskUserQuestion) is shown as "Your turn". Before, the notch showed it as a running tool ("Running AskUserQuestion", timer included) and raised an Allow / Deny card. An Allow there could not carry your answers back to Claude. Now:
  • the peek under the notch shows the question in amber and the mascot gets the amber dot;
  • the session row says Your turn with the question underneath, and the hover card lists the question and its options;
  • the permission request for the question is handed back to the terminal, so Claude uses its own question UI;
  • it sounds like an approval, does not count as a finished turn, and the row goes back to "Thinking" when you answer.
• Found by recording the real hook events of a question: Claude sends the tool event, then a permission request, then a notification, and finally the answers.

Upgrading

Replace the app. Nothing else is needed: the hook script installed by 0.1.1 is unchanged.

Install

1. Download AgentNotch-0.3.1.dmg, drag Agent Notch to Applications.
2. This build is not notarized: the first time, try to open it, then go to System Settings → Privacy & Security, scroll down to Security, click Open Anyway and confirm.
3. Click Connect when the app offers it (or choose Connect agents… from the menu bar item).
4. Restart any running Claude Code / Codex / Pi session. Codex may ask you to trust the new hooks.

The installer only appends hook entries that run agent-notch-hook; uninstall.sh (inside the app, in Contents/Resources/scripts) removes exactly those.

Known limitations

• Not notarized yet (see above).
• If one call asks several questions, the notch shows the first and counts the rest.
• Plan approval (ExitPlanMode) and questions from MCP servers probably need the same treatment; they are not covered yet.
• Tested by replaying real recorded events against the app, not with a new live question on the final build.
• The language picker was tested from a copy outside /Applications; the restart from /Applications or from a login item is untested.
• macOS 14+. Built for notched MacBooks; other screens get a pill at the top center. On macOS 14 the installer needs jq (brew install jq); macOS 15 and later include it.
• The "jq is required" message (macOS 14 without jq) is untested.
• Codex update_plan step lists are untested on real Codex runs.
• Claude TaskCreate / TaskUpdate task lists are not shown (only TodoWrite).

Checksum

SHA-256 of AgentNotch-0.3.1.dmg: 07380f3daec0571f859dd61ad1d0ddbcc1ba0c32b60eb80177486d00c76e74be

Agent Notch 0.3.0

Agent Notch 0.3.0

Pick the app's language from the menu bar.

What's new

• Language picker. The menu bar item has a new Language submenu: Match system language, English, Español and Deutsch. It does not depend on your system language list any more (before, a system set to English, Español always got English).
• Choosing a language asks for confirmation and restarts the app. A restart sends pending approvals back to the terminal, and sessions reappear with their next activity.
• The choice is stored where System Settings keeps its per-app language, so picking it in the menu or in System Settings → General → Language & Region → Applications gives the same result.
• README updated in English, Spanish and German.

Upgrading

Replace the app. Nothing else is needed: the hook script installed by 0.1.1 is unchanged.

Install

1. Download AgentNotch-0.3.0.dmg, drag Agent Notch to Applications.
2. This build is not notarized: the first time, try to open it, then go to System Settings → Privacy & Security, scroll down to Security, click Open Anyway and confirm.
3. Click Connect when the app offers it (or choose Connect agents… from the menu bar item).
4. Restart any running Claude Code / Codex / Pi session. Codex may ask you to trust the new hooks.

The installer only appends hook entries that run agent-notch-hook; uninstall.sh (inside the app, in Contents/Resources/scripts) removes exactly those.

Known limitations

• Not notarized yet (see above).
• The language picker was tested from a copy outside /Applications; the restart from /Applications or from a login item is untested.
• The translations are new: if some wording sounds odd, please open an issue. The screenshots in the README show the English interface.
• macOS 14+. Built for notched MacBooks; other screens get a pill at the top center. On macOS 14 the installer needs jq (brew install jq); macOS 15 and later include it.
• The "jq is required" message (macOS 14 without jq) is untested.
• Codex update_plan step lists are untested on real Codex runs.
• Claude TaskCreate / TaskUpdate task lists are not shown (only TodoWrite).

Checksum

SHA-256 of AgentNotch-0.3.0.dmg: 274531af49f1b7a52eb060ea50349128e05656a36825f3e5639b7884a0c5812b

Agent Notch 0.2.0

Agent Notch 0.2.0

Agent Notch now speaks English, Spanish and German.

What's new

• The app follows your system language. Menu, dialogs, session list, detail card, approval card, statuses and error messages are translated to English, Spanish and German. If a language is not supported, you get English.
• "Gentle Shell" is now the name of the Pi-based agent in the interface, the README and the mascot sheet (it was shown as gentle-shell, the folder spelling). Paths such as ~/.gentle-shell/agent do not change.
• "Your turn" detection also recognizes German phrases such as "gib mir Bescheid" or "bitte bestätige".
• The release script now checks that every string is translated before building.

Upgrading

Replace the app. Nothing else is needed: the hook script installed by 0.1.1 is unchanged.

Install

1. Download AgentNotch-0.2.0.dmg, drag Agent Notch to Applications.
2. This build is not notarized: the first time, try to open it, then go to System Settings → Privacy & Security, scroll down to Security, click Open Anyway and confirm.
3. Click Connect when the app offers it (or choose Connect agents… from the menu bar item).
4. Restart any running Claude Code / Codex / Pi session. Codex may ask you to trust the new hooks.

The installer only appends hook entries that run agent-notch-hook; uninstall.sh (inside the app, in Contents/Resources/scripts) removes exactly those.

Known limitations

• Not notarized yet (see above).
• The translations are new: if some wording sounds odd, please open an issue.
• The screenshots in the README show the English interface.
• macOS 14+. Built for notched MacBooks; other screens get a pill at the top center. On macOS 14 the installer needs jq (brew install jq); macOS 15 and later include it.
• The "jq is required" message (macOS 14 without jq) is untested.
• Codex update_plan step lists are untested on real Codex runs.
• Claude TaskCreate / TaskUpdate task lists are not shown (only TodoWrite).

Checksum

SHA-256 of AgentNotch-0.2.0.dmg: 0dc03262cc1ff72c1cd708069fa6c0a0d5a0017ddedb2de9e0527eadcb067ed7

Agent Notch 0.1.1

Agent Notch 0.1.1

Connecting your agents no longer needs a terminal.

What's new

• Connect agents… in the menu bar item: adds the hooks to Claude Code, Codex and Pi and shows exactly what changed (installed, updated, unchanged). Safe to run again.
• First-launch offer: if the hooks are not installed yet, the app asks once whether to connect your agents.
• The hook no longer needs jq while agents run. jq is only used to connect them: macOS 15 and later include it; on macOS 14 run brew install jq once.
• README redesigned, with Spanish and German translations.

Upgrading from 0.1.0

Replace the app, open it, and choose Connect agents… once. It refreshes the hook script copied to ~/.local/bin; your existing hook entries are kept.

Install

1. Download AgentNotch-0.1.1.dmg, drag Agent Notch to Applications.
2. This build is not notarized: the first time, try to open it, then go to System Settings → Privacy & Security, scroll down to Security, click Open Anyway and confirm.
3. Click Connect when the app offers it (or choose Connect agents… from the menu bar item).
4. Restart any running Claude Code / Codex / Pi session. Codex may ask you to trust the new hooks.

The installer only appends hook entries that run agent-notch-hook; uninstall.sh (inside the app, in Contents/Resources/scripts) removes exactly those.

Known limitations

• Not notarized yet (see above).
• macOS 14+. Built for notched MacBooks; other screens get a pill at the top center.
• The "jq is required" message (macOS 14 without jq) is untested.
• Codex update_plan step lists are untested on real Codex runs.
• Claude TaskCreate / TaskUpdate task lists are not shown (only TodoWrite).

Checksum

SHA-256 of AgentNotch-0.1.1.dmg: dcd31464d1b444a634f69978d70a29735a4579e3f2b8de1cac475b737981e5f7

Agent Notch 0.1.0

Agent Notch 0.1.0

Live activity of your AI coding agents (Claude Code, Codex CLI, Pi / Gentle Shell) in the MacBook notch.

• Collapsed notch: mascot per agent, accent line while it works, turn timer, and a one-line peek of the last reply.
• Step by step: when an agent keeps a task list, each step shows a spinner while it runs and a check when done.
• Hover to expand: sessions grouped by agent, with today's summary and a detail card (prompt, reply, Copy reply).
• Allow / Deny permission requests right from the notch.
• Click a row to focus the exact Terminal.app or iTerm2 tab the agent runs in.
• "Your turn" state when the last reply asks you something.

Install

1. Download AgentNotch-0.1.0.dmg, drag Agent Notch to Applications.

2. This build is not notarized: the first time, try to open it, then go to System Settings → Privacy & Security, scroll down to Security, click Open Anyway and confirm.

3. Connect your agents (needs jq: brew install jq):

   "/Applications/Agent Notch.app/Contents/Resources/scripts/install.sh"

4. Restart any running Claude Code / Codex / Pi session.

The installer only appends hook entries that run agent-notch-hook; uninstall.sh (same folder) removes exactly those.

Known limitations

• Not notarized yet (see above).
• macOS 14+. Built for notched MacBooks; other screens get a pill at the top center.
• Codex update_plan step lists are untested on real Codex runs.
• Claude TaskCreate / TaskUpdate task lists are not shown (only TodoWrite).

Checksum

SHA-256 of AgentNotch-0.1.0.dmg: 0ae1d8f770850b10bd9e6d3bd81576ef5f6496bbcbfc2d2e4a2fe3456b5bdbc8