Documentation
Everything agent-eye does, one page at a time.
Terminal picker
The package and binary are agent-eye; eye is its alias, and the examples use it. Data lives in ~/.agent-eye.
The board
The board is a web page the daemon serves on your machine: every session as a card, in lanes that say who acts next. eye board on turns it on and eye board prints its address (http://127.0.0.1:7420/?t=<token>); eye board off turns it off. It is off by default, and only your browser on this machine can open it (see security.md).
Configuration
Settings live in ~/.agent-eye/config.toml (or $EYEHOME/config.toml). eye writes the defaults on first run and reads the file on every start; the file is private to you (mode 0600). A key you leave out keeps its default, so an old file keeps working. The board and the daemon read the file when they start: after a change, eye board off && eye board on or restart the daemon.
Usage, cost and plan limits
eye usage answers "what did my sessions use and what would that cost" by day, project, agent, model or session, and shows where your plan limits stand. The board has the same in its USAGE panel.
Night shift
Park work during the day, let it run at night inside the plan you already pay for, and find results to review in the morning. It is off until you switch it on.
Backups
eye keeps compressed snapshots of its database, ~/.agent-eye/backups/eye-<date>-<time>Z-<reason>-s<schema>.db.zst (about a third of the database's size). The time in the name is UTC (the Z), and s<schema> is the schema version of the database inside, so eye backup ls never has to open a snapshot. The database holds what a rescan cannot bring back: your ideas, manual column moves, hidden flags and the summaries. The transcript archive (~/.agent-eye/archive/) is a separate copy of transcripts; see the mirror below.
Agents
eye follows coding agents through adapters. An adapter is one Rust type that implements the Agent trait in src/agents/mod.rs. Everything else (the scanner, database, picker, board, daemon, archive and search) talks to that trait and knows nothing about a particular agent. Claude Code (the default), Codex CLI, Antigravity CLI (agy) and OpenCode are the real adapters; src/agents/claude/ and src/agents/codex/ are the worked examples, src/agents/agy/ and src/agents/opencode/ show a session that is a folder with a database and one that is a row in a shared database.
eye board API
JSON over HTTP on 127.0.0.1:<port> (default 7420, [board] port in config). The board shows sessions of every enabled agent (Claude Code by default; see agents.md). The web board is optional and off by default: eye board on turns it on ([board] enabled = true in config; the daemon then serves it), eye board off turns it off, and eye serve runs it once in the foreground. The face in face/ uses only these routes; a different front end can do the same.
Architecture
agent-eye is one Rust program (agent-eye, with eye as an alias) that keeps a local index of coding-agent sessions. It has a terminal picker, a command line and an optional web board. Nothing leaves the machine except the excerpts sent to your agent for summaries (see security.md).
Linux
agent-eye works the same on Linux, with these differences:
Security
agent-eye is a local tool. This page says what runs, what listens, what is stored, what leaves the machine, and how to report a problem.
Testing
Four layers, from fastest to most realistic.