They peek.
Every so often, for no reason at all, someone pops out of the notch, has a look around and ducks back in.
Never leave your agents hanging.
Bring all your terminal agents into a single team, manage them with an AI Chief of Staff, and never miss them when they need you from your Mac or iPhone.
Free and open source. The Mac app brings the notch; the iPhone app brings the same inbox to your pocket.
Inbox
One inbox for every agent's questions.
Agents stop and ask, and the question sits in a tab you closed an hour ago. gawkbot runs your agents as a team and collects every question they ask in one list, so nothing sits there waiting while you look somewhere else.
- Tagged at a glance. Each question shows which agent asked, the tool that runs it, and whether it runs on this Mac or on a cloud computer.
- Answer in place. Approve, reject, pick an option or type a reply, right there in the panel.
- Nothing through your accounts without you. Emails, posts and every other action through an account you connected wait for your yes, one at a time. Reads don't have to.
auth-refactor
Run the migration on staging? It drops the old sessions table.
RejectApprove ↵
flaky-tests
Which fix should I keep?
1 Add a retry2 Freeze the clock3 Skip it
changelog
What should this release be called?
Type a reply…
Voice
Talk back with your voice.
Some answers are quicker said than typed. Hold V, say it, let go. gawkbot shows you what it heard, and nothing goes to the agent until you press ↵.
- On-device on the Mac. The Mac app uses Apple's speech recognition, on-device when your Mac supports it.
- A draft, not a send. Fix a word before it goes, or press Esc and it never happened.
iPhone
Reply from your iPhone, even to agents running in the cloud.
Walk away from the desk and the questions come with you. Pair your phone once by scanning the code in Access & Health, with the phone on a network that can reach your Mac (your Wi-Fi or Tailscale), then answer with a tap, a few words or the mic.
- Every agent in one list. The ones on your Mac and the ones in the cloud, with the same faces as on the desktop.
- Same one-tap answers. Approvals and choices arrive as cards with buttons.
- Hold to talk. The big button at the bottom does what you would expect.
iPhone Coming soon
The iPhone app is new and builds from source with Xcode, from apps/ios in the repo. It is not on the App Store, and push notifications are not in yet.
Keyboard
Everything is a keystroke.
Your hands stay where they are. Open the notch from anywhere, walk the list, answer, and get back to work.
⌃⌥Space
Open the notch
From anywhere on your Mac, whichever app has focus.
JK or ↑↓
Move between questions
Down the list and back up again.
1–9
Pick an answer
Every option is numbered. One key answers it.
↵
Take the recommendation
When the agent suggests an answer, Return takes it.
V hold
Talk
Speak while it's held. Let go to read the transcript.
R
Reply in words
Opens a reply box for the selected question.
esc
Close
Puts the notch away, or cancels the reply you're typing.
Detection
Detects every agent on your machine.
No setup per tool. gawkbot notices the agents you already have; one click adopts them, and each one is tagged with the tool that runs it and where it runs. Claude Code, Codex, Opencode and local models can ask you in the inbox; the others take work and report back.
- Claude Code
- Codex
- Opencode
- Gemini CLI
- Cursor CLI
- Aider
- Goose
- Amp
- Qwen Code
- Copilot CLI
- Crush
- Factory Droid
- Ollama
- OpenClaw
- Hermes
Using one that isn't here? Open an issue.
Team
A team, not just an inbox.
Every agent gawkbot adopts joins a team run by a Chief of Staff. The team splits up the work, runs the recurring jobs on a schedule, writes down what it learns, and builds small tools so you can use the results.
Chief of Staff
They work together.
The Chief of Staff breaks a job into tasks and hands them out. Bots claim tasks, review each other's work and report back. They come to the notch when they need an answer or a yes.
Routines
Work runs on a schedule.
Give a bot a routine, like every Monday at 9:00, and it runs without you. Each run keeps a transcript, and every change to the prompt is versioned.
Wiki
They keep their own knowledge base.
What the bots learn goes into a wiki they write and maintain: pages about your company, your processes and themselves, with every claim cited back to its source.
Apps
They build small apps for you.
When a job produces something you need to use, a bot builds a small app for it: a real screen over your workspace data, running in a sandbox inside gawkbot. Something to work with, not a chat log to scroll.
Routines fire through a small service in the repo, agent/. gawkbot finds and runs it from a source checkout; the Mac download does not include it.
Personality
Fun on purpose.
Waiting on an agent is dull. Being waited on shouldn't be. So the agents got a little personality, and the notch got a sense of humour.
They gang up.
When several agents need you at once, they don't queue politely. They pile onto the notch together.
They get chatty.
Keep them waiting and they get restless, then start talking to each other about it.
Pricing
Free. Open source. No subscription, no seat count, no trial.
gawkbot
$0for all of it
- The notch for Mac, with every shortcut
- The open-source web app, if you build it from source
- The iPhone app, built from source
- Every agent it detects, local or in the cloud
- Voice replies, and all the silly sounds
- Your own agents and API keys, with no usage fee from us
Public source under the Sustainable Use License. Free to self-host, on your own API keys, for your own internal business purposes and for non-commercial use. You can read it, modify it and share your changes free of charge for non-commercial use; the licence does not let you sell gawkbot itself as a hosted product. There are no seats, no usage fees, and no plan to add them.
FAQ
Questions, answered.
Is gawkbot free?
Yes. There is no subscription, no seat count, no trial and no usage fee. You bring the agents and API keys you already use. The source is public under the Sustainable Use License: free to self-host for your own internal business purposes and for non-commercial use.
Which agents does it work with?
Claude Code, Codex, Opencode, Gemini CLI, Cursor CLI, Aider, Goose, Amp, Qwen Code, Copilot CLI, Crush, Factory Droid, Ollama, OpenClaw and Hermes. Each one is tagged with the tool that started it and whether it runs on your Mac or in the cloud.
Do I need a MacBook with a notch?
No. On a Mac without a notch the same strip shows as a pill at the top centre of the screen, with the same panel, shortcuts and sounds.
Is there an iPhone app?
Yes, and it is new. It lives in the repo under
apps/ios and you build it with Xcode; it is not on the App Store. Pair it once by scanning the code in Access & Health, with the phone on a network that can reach your Mac (your Wi-Fi or Tailscale). Push notifications are not in yet.Where does my data go?
gawkbot runs on your machine and your workspace is local files you can read. Release builds include anonymous product analytics (counts and shapes, never your content) and, unless you turn it off, session replay that masks everything you type but can show what is on screen. Switch either off in onboarding or Settings. A build from source has no analytics key and sends no analytics; the only call home is the update check.
Can an agent do something external without asking me?
Not through your connected accounts. Reads are free, but an email, a post or any other action through an account you connected waits in the notch until you approve it, one action at a time, unless you choose always-allow for that one action. An agent working in a repo on your machine still uses the tool's own permissions.
How does voice work?
Hold V and talk. In the Mac app speech recognition uses Apple's speech framework, on-device when your Mac supports it; on the iPhone it is the same. You see the transcript first, and nothing is sent until you press ↵.
Does it work on Windows or Linux?
gawkbot is a Mac app with an iPhone companion. The notch, the shortcuts and the sounds are Mac only. The web app without the notch also has a Windows installer. Linux has no installer; the source is public, so anyone can build the web app from source and run it there.