AGENT-EYE

A BOARD FOR YOUR CODING AGENTS

Find, sort, resume and finish your coding-agent sessions, even overnight.

agent-eye keeps a local list of every session on your machine, shows where each one stands and what needs you, and puts you back in it with one key. It lists each session's leftovers, and can run planned work while you sleep. Works with Claude Code, Codex, Antigravity and OpenCode.

brew install maxipavlovic/tap/agent-eye

macOS and Linux. Free and open source, MIT licence.

THE BOARD

This is the real board, running on made-up data. Click a card to open it, press / to search, right-click a card for its menu. On your machine it runs on 127.0.0.1, and Chrome or Edge can install it as an app with its own window.

127.0.0.1:7420 · sample data FULL SCREEN

WHAT IT DOES

  • Every session, found

    It reads the session files your agent already writes. Nothing to wrap, nothing to log by hand. New sessions show up on their own.

  • Search that understands you

    Word forms, typos, and the PR and ticket links in a session. From the board, from the terminal (eye or Ctrl-G), or by asking your agent.

  • Back in one move

    Ctrl-G, a few words, Enter: the session resumes where you left it, or forks. When your agent has already deleted an old transcript, agent-eye puts its own copy back first.

  • Nothing lost

    A compressed copy of every transcript. eye export writes one file to take it all to another machine.

  • Know what needs you

    Running, Needs you, Waiting on others, Paused, Done. A session stopped on a permission prompt or a question is the first card you see, with its state and next step.

  • Leftovers, cleaned up

    Servers still running, commits on no remote. You stop, remove or copy, and agent-eye asks first. eye forget removes a session for good.

  • Night shift

    Plan an idea or a session for tonight. It runs while you sleep, in its own worktree or copy, inside your plan, and never pushes. Off until you switch it on.

  • What it costs

    Tokens and an API-equivalent estimate per session, project and agent, plus where your plan limits stand.

  • Works with your agents

    Claude Code, Codex, Antigravity and OpenCode, and alongside T3 Code and claude agents. Local only: no account, no telemetry.

HOW IT WORKS

YOUR AGENT

writes every session to disk

~/.claude · ~/.codex · …

AGENT-EYE

a small background scanner with a local index and archive copies

~/.agent-eye
  • BOARD

    in your browser

  • PICKER

    in your terminal

  • /EYE SKILL

    inside your agent

  1. It reads. Your agent keeps a file per session. agent-eye reads them, and a few hook events, to know what is running and what is waiting.
  2. It sorts. Simple rules place each session in a lane. Your agent writes the one-line state and next step, so the card says something useful.
  3. You act. Open the board, press Ctrl-G in the terminal, or ask your agent where you left off. Resume, fork, or mark it done.

INSTALL

Pick one. Each puts agent-eye on your PATH. Homebrew works on macOS and Linux. You need macOS 11 or newer, or Linux with glibc 2.35 or newer, and Claude Code, Codex, Antigravity or OpenCode.

HOMEBREW

brew install maxipavlovic/tap/agent-eye

INSTALLER SCRIPT

curl -LsSf https://github.com/maxipavlovic/agent-eye/releases/latest/download/agent-eye-installer.sh | sh

CARGO

cargo install agent-eye
  1. Run agent-eye install. It adds the short name eye, the hooks, the background scanner and the /eye skill, and tells you what it did. agent-eye uninstall removes them.
  2. Run eye for the terminal picker. For the board, run eye board on, then eye board prints its address.

Read the docs for the keys, the settings and the API.

PRIVATE

Everything stays on your machine.

  • No account, no telemetry, no server of ours. The board listens on 127.0.0.1 only, behind a token.
  • Summaries use your agent’s own login and plan. For each one, a short excerpt of the session (with secrets masked) goes to your agent, the way the session already did. You can turn summaries off and keep everything else.
  • Open source under the MIT licence, so you can read every line that touches your sessions.

AGENTS

Claude Code, Codex, Antigravity and OpenCode.

agent-eye reads the files each agent already writes, so it works with the agents you already use, and alongside T3 Code and claude agents: the sessions they run are listed like any other, and each card says where it was started (App, Headless, IDE…). It follows the ones it finds on your machine. Those files are not a public API and can change; if one does, agent-eye may need an update.

Codex runs hooks only after you trust them once: open Codex and approve them with /hooks. The code keeps each agent behind one layer, so any of them can be switched off.

agent-eye is an independent project. It is not affiliated with Anthropic, OpenAI, Google or OpenCode.