# The Eye — a menu bar and system tray monitor for AI coding agents

Know the moment an agent turns to you.

The Eye keeps watch over every AI coding agent you run. It opens red the instant one
stops to ask, and closes again when the work is done.

**Free · macOS 14 Sonoma or later, Apple-notarized · [Download for macOS](https://www.theeye.dev/releases/TheEye-1.4.0.dmg)**

**Windows 10/11 (64-bit), beta · not code-signed yet, so SmartScreen warns once · [Download for Windows](https://www.theeye.dev/releases/TheEye-1.2.1-windows-x64-setup.exe)**

Watches Claude Code, OpenAI Codex CLI, Cursor, GitHub Copilot, and Google Antigravity.

---

## The whole watch, in one glance

Open the menu and every agent is there: who calls for aid, who is idle, and what
each one is doing right now.

## Built to stay out of the way

- **A glance is enough.** The Eye opens red with a count when agents need you,
  watches while they work, and closes when all is quiet, reinforced with distinct
  shapes, not colour alone.
- **Watches every agent.** Claude Code, Codex, Cursor, GitHub Copilot, and Google
  Antigravity, in the terminal or your editor. One setup brings them all under the
  same gaze.
- **Go straight to it.** Click a session and the exact terminal or editor window
  comes forward. No hunting through tabs for the one that paused.
- **Keep it in sight.** A draggable always-on-top status window expands into the
  live agent list on both macOS and Windows.
- **Told the way you want.** A sound, a notification, a Telegram message to your
  phone, or bring the window forward on its own. Each one is opt-in.
- **Never leaves your machine.** It reads local lifecycle signals and writes small
  local status files. On Windows, Codex's local rollout log is the fallback when
  Codex does not invoke hooks. Your code, prompts, and output never leave your machine.
- **Always current.** On macOS, signed and notarized updates arrive quietly in the background and
  verify themselves before installing.

## It watches from the side, and never runs your agents

Your agents keep running in their own apps. The Eye only listens for the signals
they already emit.

1. **Turn it on.** In Settings, Tools, one button adds a small status hook to each
   agent's config. Removing it takes back only what it added.
2. **Agents report in.** As an agent starts, works, finishes, or stops to ask you
   something, the hook writes a tiny local status file.
3. **The Eye reflects it.** It watches those files and shows the combined state, the
   instant anything changes.

## The Eye compared to agent orchestration dashboards

Orchestrators run your agents for you: they wrap the agent process, own the
workflow, and give you a dashboard to keep open. The Eye does the opposite. It never
launches or controls anything; it reads the lifecycle signals your agents already
emit and reports them in one light in the menu bar. You keep your own terminal, your
own editor, and your own way of working.

The tradeoff is deliberate: The Eye cannot start or retry an agent for you, and in
exchange it cannot get in the way of one.

## Supported agents

Claude Code · Codex CLI · Cursor · GitHub Copilot CLI · Copilot in VS Code · Google Antigravity

---

## Questions

**What is The Eye?**
A small macOS menu-bar and Windows system-tray app that keeps watch over the AI coding agents you run. It
stays dark and quiet while they work, opens red with a count the instant one stops
to ask you something, and rests again when the work is done.

**Which agents can it watch?**
Claude Code, OpenAI Codex CLI, Cursor (CLI and in-editor), GitHub Copilot (CLI and
in VS Code), and Google Antigravity (CLI and in-editor).

**How does it help day to day?**
When you run several agents in parallel, you stop babysitting their windows. The Eye
gives you one place to glance, and clicking a waiting session brings its exact
window forward.

**Can it reach me on my phone?**
Yes, through Telegram. You connect your own bot once from Settings, Connectors. Your
bot token is kept in the macOS Keychain, the message carries only the agent and
project name, and nothing is sent until you turn it on.

**How does it actually work?**
It listens for the lifecycle hooks each agent already emits. A one-time setup from
Settings adds a tiny status hook to each agent's own config; that hook writes a
small local status file, and The Eye watches those files. It never runs, drives, or
controls your agents. On Windows, when Codex does not invoke hooks, The Eye reads
the same lifecycle state from Codex's local rollout log instead.

**Is it secure? Does any of my code leave my machine?**
Your code, prompts, and output never leave your machine. The status files carry only
a session name, its tool, and whether it is working or waiting. On Windows, the
Codex fallback reads lifecycle records and the final assistant message locally only
to determine working versus waiting; that content is not copied into analytics.
There is no account and no server of ours. On macOS and Windows it sends nothing on its own except
optional, anonymous app launch and heartbeat counts, which you can turn off in
Settings or Preferences, Privacy. Those counts include app version, OS, and CPU
architecture, never agent names, paths, prompts, output, or code.

**What does it cost, and what do I need to run it?**
It is free. macOS 14 Sonoma or later, universal for Apple Silicon and Intel, or
64-bit Windows 10/11 for the beta. Download it, drag it to Applications (or run the
Windows installer), and set up the hooks from Settings, Tools in about a minute.

**Is there a Windows version?**
Yes, as a beta, currently version 1.2.1. Same watch light, same agents, same one-button hook setup. It is not
code-signed yet, so SmartScreen warns once on first run; it installs per-user with no
admin prompt; and its optional anonymous usage counts can be turned off. It includes
the draggable floating status window, the in-app feedback form, and a daily update
check that notifies you and installs on your click.

**How do updates work?**
On macOS, signed and notarized updates arrive quietly in the background, verified
against both a cryptographic key and the app's Developer ID signature before
installing. From 1.2.0 the Windows beta checks daily as well and tells you when a
new version is published — a notification, a tray-menu item, and the release notes
under Settings, General, Updates — but it installs only when you click Install, and
verifies the download against a cryptographic key. Windows copies older than 1.2.0
are updated by downloading the newer installer and running it over the old version.

**How do I remove it?**
In Settings, Tools, Remove all takes back every hook The Eye added, leaving the rest
of your settings untouched. Then quit The Eye and move it to the Trash on macOS,
or uninstall it from Windows Settings, Apps.

---

Built by [Amit Raz](https://rzailabs.com/) at RZ AI Labs.
[Project page](https://rzailabs.com/projects/the-eye) ·
[Why it exists](https://rzailabs.com/blog/the-eye-monitor-parallel-coding-agents) ·
[Changelog](https://www.theeye.dev/changelog) ·
[Full briefing for agents](https://www.theeye.dev/llms-full.txt)

Last verified: 2026-08-10
