What Is SupaYatta? The Beginner's Guide to Watching Your Claude Code and Codex Sessions From the Mac Notch

CodexFuse Team · 2026-11-05T15:39:03.252Z · 26 min read min read

What Is SupaYatta? The Beginner's Guide to Watching Your Claude Code and Codex Sessions From the Mac Notch

What Is SupaYatta?

SupaYatta is a macOS app that watches your Claude Code, Claude Cowork and Codex sessions from the Mac notch and pings you when a session finishes or needs you. It is an agent session watcher Mac app: it lives in the notch on MacBooks that have one, or as a detachable floating bar on any Mac, and it shows every session in one list, newest first. The idea is simple — you stop babysitting your agents and get back to your own work until one of them actually needs you.

The vendor's own tagline says it plainly: "Stop babysitting your agents. One notch tracks Claude Code, Cowork and Codex, and flags the one that needs you." SupaYatta was listed on November 5, 2026, and on the same day it took the number 3 spot in StillWorks' "Today's picks" for November 5, 2026. That makes this a same-day explainer: the app is brand new, and at the time of writing no independent review, how-to, or hands-on article about it exists anywhere else.

SupaYatta is built for a specific pain. Long agent runs take minutes, and during those minutes you either stare at a terminal or keep switching back to check whether the agent finished, hit an approval, or errored out.

SupaYatta replaces that checking loop with a glance: the notch shows which sessions are working, which one needs you, and which one just finished. If you run one agent at a time, you may not need it. If you run three or four sessions at once, it is the difference between flow and constant context-switching.

One clarification belongs up front, because the name invites confusion. SupaYatta is a Mac notch app for watching coding-agent sessions, made by Kshetez Vinayak, the indie developer behind SupaSidebar.

It is not Supa Studio, an unrelated iOS app studio; it is not Supatips, a football predictions site; and it is not SUPA, a video-editing product. The "Supa" prefix is shared, the products are not.

SupaYatta is also not a coding agent itself. It never writes code, never answers an approval, and never resumes a session for you.

It only watches whether your existing sessions are working, stuck, or finished, and it tells you when to look. That narrow job is the whole product, and it is what separates SupaYatta from the session managers it is often compared with.

A quick way to think about it: a SHA-256 hash generator does one small job exactly, and SupaYatta does the same for session watching. If you self-host your own tools, you already know the pattern — a small, focused utility beats a bloated one. The same logic applies to the machine the app runs on: SupaYatta watches agents that run locally or in the cloud, and the question of where those agents run is a hosting question, which is why this guide also points at VPS hosting when the setup section talks about keeping sessions alive.

How SupaYatta Watches Your Sessions

SupaYatta watches sessions through local lifecycle hooks, not through a cloud service. When you connect Claude Code or Codex CLI, SupaYatta adds its own hooks to that agent's settings on your Mac, and the hooks report each session's state — working, needs you, or done — back to the app. Nothing leaves your machine in that loop: the hooks run locally, the state stays local, and the app has no server of its own in the middle.

Two of the four supported surfaces work differently, and the difference matters. Claude Cowork is watched through a read-only transcript reader, with no hooks at all — SupaYatta tails the end of Cowork's transcript file and never edits it.

Codex desktop is watched the same gentle way: your existing local tasks appear automatically, with no hooks to install. Only Claude Code and Codex CLI use the hook path, and for Codex CLI you trust the hooks once with the /hooks command.

Connecting an agent changes exactly one small thing on your Mac, and only when you click Connect. SupaYatta first saves an exact copy of ~/.claude/settings.json or ~/.codex/hooks.json, then adds only its own hooks, leaving your other settings untouched.

Clicking Disconnect removes only what SupaYatta added, so later edits you made stay in place, and the backup stays too. That is a careful design for a tool that touches agent configuration files.

SupaYatta works with either Claude or Codex on its own. The vendor FAQ says so directly: connect just the one you use, and the notch shows whatever sessions it can see. You do not need both agents installed, and you do not need to run them together for the app to be useful.

One support claim needs a caution flag. A testimonial on the vendor site from an OpenCode and Cursor user thanks the maker for "implementing the OpenCode and Cursor support," but OpenCode and Cursor do not appear in the vendor's own "Works with" section.

Treat OpenCode and Cursor support as unconfirmed for now — possibly beta, possibly coming — and do not buy SupaYatta for those agents until the vendor lists them. The confirmed list is Claude Code, Claude Cowork, Codex CLI, and Codex desktop.

If you have never used the agent SupaYatta watches most, start with how to use Claude Code before you install anything. SupaYatta assumes you already run sessions; it does not teach you the agent. Once you have sessions worth watching, the notch app earns its place.

What the Notch Shows You

SupaYatta shows every session in one list, grouped by when each session last moved, newest first. Each row names the task and the project folder, so you can tell at a glance which session is which when three of them are running at once. Finished turns you have not opened keep a red dot until you mark them seen, so nothing finished slips past you silently.

The list also carries usage bars for your Claude and Codex subscriptions. Those percentages are the ones your agents already report — Codex usage comes from your own signed-in Codex CLI — so SupaYatta is not inventing a new meter. It is surfacing numbers you already have, in the same place as the session list.

Next to the agents sits your own list: up to five lines for what you are working on today. The vendor's reasoning is that agent noise should never replace your focus, so your own tasks stay visible beside theirs. Five lines is a deliberate cap — enough for a day's priorities, too few to become a second task manager.

On a MacBook with a notch, SupaYatta docks into the notch itself. On any other Mac, or whenever you prefer it, you drag it off the notch to float it anywhere on screen, and drop it back at the top to dock it again. The floating bar is the same app in a different place, not a separate mode with different features.

How the Alerts Work

SupaYatta has two kinds of alerts, and they behave very differently. A finished turn gets a quiet alert card: it carries the first lines of the agent's reply — a preview trimmed to 200 characters — and a one-click way back into that exact session. You read the preview, decide whether the result is worth opening, and jump straight into the right session instead of hunting through terminals.

A blocked session gets a loud alert. Approvals, questions and errors turn the count yellow, play a chime, and glow the screen edge until you look.

The glow does not stop on its own, which is the point: a blocked agent is burning your time while it waits, so the app keeps demanding your attention until you answer it. The vendor calls this "a hand goes up when it's blocked," and the yellow count is the visual version of that raised hand.

The two alert styles map to the two ways agent work stalls. Finished work stalls silently — you forget to check, and the next task never starts.

Blocked work stalls loudly — the agent waits on you, and every minute you miss is a minute lost. SupaYatta treats the first with a preview you can triage and the second with a signal you cannot ignore, which is the right split for a watcher.

That split is also why the 200-character preview matters. It is long enough to tell you whether the agent finished with an answer, a question, or an error, and short enough that the alert card stays a glance, not a reading task. The preview never leaves your Mac: it is kept on your machine for the alert card, and it is never sent to the vendor's trial or licensing service.

Claude Code session alerts and Codex session notifications work the same way in SupaYatta, even though the two agents report through different paths. Claude Code reports through lifecycle hooks, Codex CLI through hooks you trust once with /hooks, Codex desktop through its local task list, and Cowork through its transcript file. The alert you see is identical either way, which is the point of watching four surfaces from one notch.

How to Set Up SupaYatta in Five Steps

Setup takes a few minutes, and most of it is deciding which agents to connect. The app is macOS 13 and newer, it docks into the notch on MacBooks that have one, and it runs as a floating bar on any other Mac. SupaYatta Mac users download it from supayatta.com — the vendor's own site is the download source, and the app is free to download with the license handled in the app.

1. Download SupaYatta from supayatta.com and open it on your Mac (macOS 13 or newer).
2. Start the 7-day free trial inside the app. No credit card is required, and email verification is only for the optional trial.
3. Click Connect next to Claude Code. SupaYatta backs up your ~/.claude/settings.json first, then adds only its own hooks.
4. For Codex CLI, trust the hooks once with /hooks. Codex desktop tasks appear automatically, and Cowork needs no hooks — it is read through its transcript file.
5. Watch the notch. Finished turns show a reply preview with a one-click jump back, and blocked sessions turn the count yellow, play a chime, and glow the screen edge.

That is the whole setup, and the fifth step is the product: once the hooks are in, you stop opening terminals to check. The vendor ships a 34-second demo on the homepage that shows the same flow end to end, and it is worth watching once before you connect anything, because it shows the notch, the alert card, and the floating bar in real use.

What SupaYatta Costs

SupaYatta pricing starts with one confirmed fact: the app is a one-time purchase, not a subscription. That much is confirmed on two independent sources: the PitchWall listing calls it a "one-time purchase with a 7-day free trial," and the vendor FAQ confirms purchases include a 14-day money-back guarantee. The 7-day trial needs no credit card, and email verification is only for the optional trial.

The exact dollar price is not published on any public page fetched on November 5, 2026. The vendor homepage's "Honest and affordable pricing" section carries no dollar figure at all, PitchWall lists no amount, and the StillWorks product page lists "Price: 0 USD," which means free to download, not that the license is free.

Do not quote a price from any of those pages, because none of them states one. The price is shown inside the app at checkout, so check there before you buy.

Add the two confirmed windows together and the cover is generous: 7 days of free trial plus 14 days of money-back guarantee is 21 days from first install during which you can try the app and still get your money back. That is three full weeks of protection on a one-time purchase, which is a fair deal for a utility whose value you can only judge by living with it for a few days.

One group gets SupaYatta free. If you hold a SupaSidebar Believer license — SupaSidebar is the maker's other Mac app — your license includes SupaYatta at no extra cost.

Claim it from the vendor's claim page by emailing [email protected] with the subject "SupaYatta key" from the email address you used to buy SupaSidebar. That is a genuine perk for the maker's existing customers, and it is worth checking before you pay.

What SupaYatta Does With Your Data

SupaYatta's privacy story is the strongest part of its pitch, and it is also the part that needs the most careful reading. The vendor says, in its own words: "No account, no API key and no server of ours." The app never uploads your prompts, code or replies, it has no analytics and no telemetry built in, it never asks for an account or an API key, and it never calls an AI model or asks for your provider key. Those are vendor claims, stated as vendor claims, and they are the reason the app can watch your sessions without becoming a second cloud service in your workflow.

What the app reads is limited to what it needs to show a session's state. It reads the session status — working, needs you, or done — sent by the Claude Code and Codex hooks on your Mac.

It reads the task title and project folder, so each row in the notch says which task it is. It reads a short preview of the agent's last reply or question, trimmed to 200 characters, for the alert card.

And it reads local agent files, read-only: the end of Cowork's transcript and Codex desktop's task list. It never edits those files.

What it keeps also stays on your Mac. Session states and recent alerts are saved in files only your user account can open.

Settings — placement, sound, which agents and usage bars are on — stay local. Usage percentages are the ones your agents already report.

Trial keys and receipts stay in macOS Keychain. Nothing in that list needs a server, and nothing in it is your conversation history.

Here is the nuance the vendor's own page states plainly, and this guide states it the same way. The "no server" claim is shorthand: the vendor's licensing server keeps the email and device trial record, or the paid-license data, needed to provide access, and access is verified online.

So there is a vendor server — for trial and license verification only — and it is claimed to hold only email, device, and license records, never your prompts, code, replies, or agent events. Your work stays private even when access is verified online, per the vendor's own wording.

That distinction is worth holding onto, because it is the difference between a privacy claim and a privacy fact. SupaYatta does not route your agent traffic through its own servers, and it does not need your conversations to do its job.

It does phone home to check whether your trial or license is valid, and that check carries your email and device record. Both statements are true at once, and the honest version of the privacy story includes both.

What SupaYatta Does Not Do

SupaYatta never acts for you. It does not answer approvals, it does not reply to questions, and it does not resume a session.

You stay in control, and the app's job ends at telling you that a session needs you. If you want a tool that manages sessions — starting them, boarding them, resuming them — SupaYatta is the wrong category, and the comparison section below names the right one.

Green does not mean the task succeeded. The vendor FAQ answers this directly: green means the agent's turn ended, not that the result is right.

Review what the agent did before handing it the next task. That warning matters more as agents get better, because a confident-sounding finished turn is exactly the one you are tempted to trust without checking.

SupaYatta is macOS only, and it will stay that way for the foreseeable future. There is no Windows or Linux version, and the notch-or-floating-bar design is a Mac idea from the ground up. If your agents run on a Windows machine or a Linux server, SupaYatta cannot watch them, and no setting changes that.

Two more limits deserve a plain sentence each. Cowork sessions are read-only: SupaYatta watches them through a transcript tail, so it can tell you a Cowork session finished or needs you, but it cannot hook into Cowork the way it hooks into Claude Code. And OpenCode and Cursor support is unconfirmed: one vendor testimonial thanks the maker for it, but the vendor's "Works with" section does not list either agent, so do not plan around them.

SupaYatta vs Clawdline: Watcher or Manager?

The closest comparison on CodexFuse is Clawdline, and the difference between the two is the difference between watching and managing. SupaYatta watches sessions and alerts you; Clawdline manages sessions — it runs and boards them.

Both cover Claude Code and Codex, both live on your Mac, and they solve the same underlying problem, which is that running several agent sessions at once is hard to keep track of. They solve it from opposite ends.

That is why the "supayatta vs clawdline" question has a clean answer: pick SupaYatta if your sessions already run fine and you only need to know when they finish or stall. Pick a manager like Clawdline if your problem is starting, organizing, and resuming sessions, not just noticing them. The two tools do not compete for the same job, and nothing stops you from using both — a manager to run the sessions and a watcher to tell you when they need you.

Ravenry is the same kind of sibling: another session manager that runs and boards sessions, while SupaYatta only watches and alerts. If you want the manager side of the story, read how to use Clawdline and what Ravenry is next. If you only need the watcher, this page is the one to keep.

SupaYatta vs Other Notch Apps

SupaYatta is not the only app that puts agent sessions in the Mac notch, and the alternatives are worth one honest paragraph each. ClaudeNotch is free for personal use and covers Claude Code plus Codex in beta, on macOS 13 and newer, on Apple Silicon and Intel.

Halo costs $9.99 as a one-time purchase and covers Claude Code, Codex and Cursor in the notch. Superagent is free and open source, and covers Claude Code, Codex and Antigravity. CodexBar is the older notch app one vendor testimonial mentions by name — a user says they uninstalled CodexBar after switching to SupaYatta — but CodexBar covers Codex only, which is a narrower job.

The differences between them are smaller than the marketing suggests, and they cluster around three questions. First, which agents do you run: SupaYatta is the only one of the four that lists Claude Cowork, through its read-only transcript reader.

Second, how much do you trust the vendor's privacy story: SupaYatta's local-only watching plus a licensing server is stated in unusual detail on its own page, while the alternatives state less. Third, what do you pay: ClaudeNotch and Superagent are free, Halo is $9.99 one-time, and SupaYatta's exact price is not published on its public pages, so compare the free tier and the trial before you compare the price tags.

None of the four is an established standard yet, and none has independent reviews worth citing. The notch-app category is weeks old, not years old, and every app in it is a small indie product. That is not a reason to avoid them — it is a reason to use the free trial, watch how each one behaves with your own sessions, and keep the one whose alerts you actually trust.

Who SupaYatta Fits — and Who Should Skip It

SupaYatta fits developers who run several Claude Code or Codex sessions at once on a Mac and keep losing track of which one finished. If you run three terminals in parallel, if you start a long agent task and switch to other work, or if you have missed an approval prompt sitting unanswered for twenty minutes, the notch list and the yellow-count alert solve a real problem you already have. The 7-day trial exists for exactly this test: run your normal week with it on, and count how many times it catches something you would have missed.

SupaYatta also fits the privacy-conscious developer who wants a watcher, not a platform. There is no account, no API key, and no AI model call in the loop, and the app's own page documents exactly what it reads, keeps, and never does. The licensing-server nuance is real, but it is a small, disclosed exception — an email and device record for trial and license checks — not a pipeline that carries your code anywhere.

Skip SupaYatta if you run one session at a time and already notice when it finishes. Skip it if you are on Windows or Linux, because there is no version for you.

Skip it if what you need is a session manager — something that starts, boards, and resumes sessions — because SupaYatta deliberately never acts for you. And skip it, for now, if you need OpenCode or Cursor support, because that support is unconfirmed and you should not pay for a promise.

Limits to Know Before You Install

The first limit is the missing price. A one-time purchase with no dollar figure on any public page is unusual, and it means you cannot compare SupaYatta's cost with Halo's $9.99 until you open the app and look at checkout.

The 7-day trial and the 14-day guarantee soften that — 21 days of cover in total — but a buyer who wants the price before installing will have to install first. That is a fair criticism of the launch, and it is the first thing the vendor should fix.

The second limit is the platform. macOS 13 and newer only, with no Windows or Linux version, and no statement on the vendor site about Apple Silicon versus Intel.

If you split your work across a Mac and a Windows machine, SupaYatta watches only the Mac half. Check the download page for chip requirements before you install if you run an Intel Mac.

The third limit is the evidence base. There are no independent reviews, explainers, or how-tos about SupaYatta as of November 5, 2026 — only the vendor site, the PitchWall listing, and the StillWorks pick.

The vendor's 12 named testimonials are vendor-hosted quotes, not independent reviews, and they should be read that way. This article is itself the first independent explainer, and it leans on vendor claims attributed as vendor claims, not on hands-on testing.

The fourth limit is Cowork. The read-only transcript reader means Cowork sessions are watched, not hooked: SupaYatta can tell you a Cowork session finished or needs you, but it cannot integrate with Cowork the way it does with Claude Code. If Cowork is your main agent, expect the lightest integration of the four supported surfaces.

The fifth limit is youth. SupaYatta was listed on November 5, 2026 — the same day this article was written — and a product that young has no track record for reliability, updates, or support.

The maker has a track record with SupaSidebar, which counts for something, but a new app is a new app. Use the trial, watch whether the alerts fire correctly for a full week, and only then decide whether the one-time purchase is worth it.

Sources

Every fact in this article comes from a page fetched on November 5, 2026, and every capability claim is attributed to the vendor unless stated otherwise. No price, rank, or review is asserted without a source. The exact one-time price is the one fact this article could not verify, and it is stated as unverified rather than claimed.

SupaYatta vendor homepage, including the privacy section, FAQ, and pricing section — https://supayatta.com/ — fetched November 5, 2026. SupaYatta free-key claim page for SupaSidebar Believer owners — https://supayatta.com/claim — fetched November 5, 2026.

PitchWall listing for SupaYatta — https://pitchwall.co/product/supayatta — fetched November 5, 2026. StillWorks "Today's picks," November 5, 2026, SupaYatta at number 3 — https://stillworks.dev/ — fetched November 5, 2026.

StillWorks SupaYatta product page, listed November 5, 2026 — https://stillworks.dev/products/p/supayatta/ — fetched November 5, 2026. SupaSidebar blog bylines identifying the maker, Kshetez Vinayak — https://supasidebar.com/blog/safari-vs-zen-vs-arc-mac-2026 — fetched November 5, 2026.

Show HN post for SupaSidebar, the maker's earlier product — https://news.ycombinator.com/item?id=47167284 — posted March 2026. Competitor pages: ClaudeNotch — https://rawsun007.github.io/claude-notch/ — Halo — https://www.halo-mac.com/guides/codex-done-notification-mac/ — AyCode — https://aycode.ai/ — Superagent — https://superagent.computer/ — all found November 5, 2026.

Frequently Asked Questions

Is SupaYatta free?

SupaYatta is free to download, but the license is a one-time purchase, not a free app. The 7-day free trial needs no credit card, and purchases include a 14-day money-back guarantee, so 7 plus 14 is 21 days of cover from first install.

The exact price is not published on any public page — it is shown inside the app at checkout. SupaSidebar Believer license holders get SupaYatta free by claiming a key from the vendor's claim page.

Does SupaYatta work on Windows or Linux?

No. SupaYatta is macOS 13 and newer only, and it docks into the notch on MacBooks that have one or runs as a detachable floating bar on any Mac.

There is no Windows or Linux version. If your agents run on Windows or Linux, SupaYatta cannot watch them.

Does SupaYatta read my code or conversations?

Only enough to show a session's status, per the vendor's own privacy page. It reads the session state, the task title and project folder, and a 200-character preview of the agent's last reply or question for the alert card.

It never uploads your prompts, code or replies, it has no analytics or telemetry, and it never calls an AI model. One nuance: a vendor licensing server keeps the email and device trial record or paid-license data needed to verify access, so the "no server" claim covers your work, not the license check.

What is the difference between SupaYatta and Clawdline?

SupaYatta watches sessions and alerts you; Clawdline manages sessions by running and boarding them. If your sessions already run fine and you only need to know when they finish or stall, SupaYatta is the tool.

If your problem is starting, organizing, and resuming sessions, you need a manager like Clawdline or Ravenry. The two kinds of tool do not compete, and using both together is a sensible setup.

Does green mean my task succeeded?

No. The vendor FAQ answers this directly: green means the agent's turn ended, not that the result is right.

A finished turn can still contain a wrong answer, a partial change, or an error the agent did not notice. Review what the agent did before handing it the next task, every time.