Better T3 Notch app icon

Better T3 Notch

A Dynamic Island for T3 Code on macOS. See what your agents are doing, answer them, and stop them, without leaving the app you're in.

Free and open source · macOS 14+ · Under 1% CPU

The open notch listing T3 Code threads with their branch, model, diff counts, PR status and current activity
At a glance

It says one thing, and leaves nothing out.

Closed, the notch shows either what needs you or how many agents are working. Anything waiting on you comes first.

5 working
WorkingNothing's waiting on you, so you just see how many agents are running.
?1 needs you
Needs youA question, an approval or a guest message. It gives a little wiggle.
✓3 done
DoneIt clears by itself once you've looked at the thread in T3 Code.
✕1 failed
FailedFollows T3's own read state, so it never nags you twice.
Answer from the notch

When an agent needs you, you never switch apps.

An approval card under the notch with Decline and Approve buttons

Approve or decline

See the exact command and why it needs a look. Approve with A and decline with D.

A question card under the notch with answer choices

Answer questions

Tap an answer or press 1–9. To reply in your own words or steer a running agent, press R.

A finished run's final message dropping down from the notch

See it finish

When a run ends, its final message drops down for a few seconds with a soft chime. It goes away once you've seen the thread in T3 Code, however you got there.

Everything else

Small, and it doesn't miss anything.

01
T3's own statuses

Working, Waiting, Pending Approval, Awaiting Input, Plan Ready, Failed and Completed. The logic is ported from T3's sidebar and covered by tests.

02
Pixel logos

Claude, Codex, Cursor, Grok, opencode and more, each as pixel art with a radar sweep while it works.

03
Live terminal

Hover a running command to watch its last lines stream in.

04
PRs and limits

Branch, model, PR checks, review state and conflicts, plus a countdown until your usage limit resets.

05
Keyboard first

⌘⇧Space opens it. Arrow keys select and ⏎ opens. Esc closes it.

06
Matches your theme

Follows T3's palette live: T3 Chat, Grove, Ocean, Ember and Iris.

07
Cozy sounds

A soft chime when a run finishes and a wooden knock when an agent needs you. Each one can be turned off.

08
Private by default

Hidden from screen sharing, recordings and screenshots.

09
Talks to T3 directly

Connects to your local T3 server with its own scoped token. Nothing leaves your Mac.

Performance

It's on screen all day, so it costs almost nothing.

The first version was built in SwiftUI and used about 19% CPU while agents ran. Rebuilt on AppKit and Core Animation, it uses under 1%.

Average CPU, 2 agents running
18.8%0.6%
Wakeups per second
2,61158
Memory over a minute
+3.8 MB0 MB

Core Animation lets the window server run the springs, slides and rolling digits, so the app does no work per frame. The method and every step of the migration are in the README.

Install

Build it in a minute.

# clone and build
$ git clone https://github.com/notkainoa/better-t3-notch
$ cd better-t3-notch
$ ./build.sh
$ open BetterT3Notch.app
  • macOS 14 or later. It works with or without a camera notch.
  • T3 Code desktop app, running. It finds the local server on its own.
  • Xcode command-line tools (Swift 5.9+) to build it.
  • On first launch it gets its own token from T3's CLI. Nothing to configure.