Repository navigation
Release Notes
Added
-
Antigravity CLI (
agy) support on a par with Codex: live status (busy, idle, waiting for your approval) from its presence lock, summaries row and database; its Remote Control link and-pruns from its process log; sub-agent conversations as child streams; a global plugin withSessionStartandStophooks and the/eyeskill in~/.gemini/config; Gemini prices for the cost estimate;eye forget --transcriptalso clears its history lines and caches; a restored archive is a conversationagy --conversationcan open; night runs only with[night] allow_unsandboxed = true(new[night] agy_model). No fork, plan limits or terminal origin: agy offers none. Seedocs/agents.md. -
eye forget <id>... | --folder <path> [--transcript] [--yes] [--dry-run]removes sessions from eye (the session, its search text, its other rows and its archive copy) and, with--transcript, the agent's own copy: Claude Code's transcript and sub-agent folder, Codex's rollout and itssession_index.jsonlline, agy's conversation folder, database and summary row, OpenCode's rows or JSON files. It asks first, refuses a session that is open now and takes amanualbackup snapshot before removing anything. The board has FORGET… in the card menu and the panel (key X) with a confirm and a box for the agent's copy (POST /api/sessions/:id/forget). -
Where a session was started: T3 Code, Conductor, the desktop app, an editor, the web or a headless run. Its name (App, Headless, Desktop, IDE, Web, Night) in the card's top line and the panel's facts line for anything but the terminal, "started from: an app (sdk-ts)" in the picker preview,
originandorigin_rawineye ls --jsonand the card JSON, andeye ls --origin app. Sessions indexed before are filled from the first lines of their transcripts, with no re-read.docs/agents.mdhas the table. -
Leftovers: each session lists what it left behind. Servers and shells still running (on a port, or in the session's folder or scratchpad), containers, git worktrees in a scratchpad or whose folder is gone, commits on no remote and modified files nobody committed. A card shows the count in a box on its top edge; the panel has a two-line LEFTOVERS block (what is left, by kind, with REMOVE ALL… for what eye can stop or remove and IGNORE ALL; SHOW opens one line per item with its own actions); the picker's preview has a line and Ctrl-L opens the list;
eye looselists them andeye loose stop|remove|ignore <key>andeye loose send <session>act. Stop sends SIGTERM to a process whose pid and start time still match; remove runsgit worktree removewithout--force; commits and files only get a command to copy. Every action asks first.[loose] enabledanddaysinconfig.toml. -
Antigravity CLI (
agy) and OpenCode as agents ([agents] enabled = ["agy", "opencode"];eye installturns on the ones it finds). agy: read from its JSON log, with titles, tokens by model, history, archive and summaries (see the agy entry above for live status, hooks and the rest). OpenCode: checked on OpenCode 2.3.2, with its older database and file layouts read too (see the OpenCode entries below for live status, summaries, restore and night runs). NewAgent::transcript_existsfor sessions that live inside a database. -
Night shift (off until
[night] enabled = true): plan an idea ("TONIGHT") or a session ("CONTINUE TONIGHT") and the daemon starts it, headless, inside a window (01:00-07:00 by default) when no session you work in is live. Each run works in its own git worktree on a new branch (or a copy of a plain folder), and runs in parallel with others up to[night] parallel. A Claude run's Bash can reach only package registries ([night] network; no git host) andgit push,gh,sshand the publish commands are denied; Codex runs have no network. Claude's own tools (WebFetch, MCP) are not limited by that list. Each run can set one limit (weekly plan above N%, a token budget, or minutes); a limit eye cannot check is refused when planned. A run whose plan runs out can start again on the other agent (--switch). In the morning the run's session is a Needs-you card with a night mark, its report, diff stat and leftovers, and RESUME, OPEN FOLDER and DISCARD.eye night on|off|add|ls|cancel|log|window|parallel|run-now|discard, a Tonight chip and list on the board,/api/night, anddocs/night.md. Acodex execrollout is a session only when it ran in a night run's folder. -
Night shift has two ways to keep your folder safe:
worktree(the default, as before) andcopy, a separate local clone with nooriginwhere your folder is locked completely,.gitincluded.[night] isolation,eye night add --isolation worktree|copy, and a Work in choice in the TONIGHT and CONTINUE TONIGHT forms; the NIGHT RUN section shows which one a run used. For a repo copy, BRING INTO MY REPO (eye night bring <run>,POST /api/night/:id/bring) fetches the night branch into your repo after you confirm, and refuses when the branch exists.night_run.isolationis a column of schema 17.docs/night.mdexplains when to pick which. -
eye usage [--days N | --week | --month] [--by project|folder|agent|model|session] [--json]: tokens and an API-equivalent cost estimate (not your bill) per day, project, agent, model or session, with plan limits on top. Prices live in one file with their sources;[usage.prices]adds or overrides a model, and a model without a price shows tokens and no cost. Sessions from before are counted in the background. -
A USAGE panel on the board (this week by project and by agent, the top 10 sessions, four weeks, the limit lines) and
GET /api/usage; tokens and cost on the session panel, ineye showand in the picker preview. -
Codex plan limits, kept as the newest seen. For Claude Code, an opt-in
eye statusline [--wrap '<cmd>']status line command stores the limits Claude Code hands to its status line;eye installdoes not turn it on (seedocs/usage.md). -
eye exportwrites one.eyepackfile with everything eye knows (database, transcript archive, and copies of transcripts the agent still has), andeye import <file>reads it on this machine or another one: a fresh install takes the pack's database, an existing one gets the missing sessions and ideas merged in (the newer row wins). Home folders are rewritten for the new machine (/Users/maxto/home/max, also in Claude's-Users-max-…folder names). Import shows the plan first, asks[y/N](--yes,--dry-run), and keeps apre-importsnapshot. The board's token is never in a pack.eye export --to -andeye import -stream a pack through standard output and input, soage -porgpg -ccan encrypt it on the way (eye has no encryption of its own). -
eye export <session> [--html|--md]writes one session as a readable, self-contained page (secrets masked, tool calls folded to a line), from the archive when the agent deleted the transcript. The board's session panel has an EXPORT button (GET /api/sessions/:id/export). -
The terminal preview says when a session's folder does not exist on this machine.
-
Database schema 14 (
looseandloose_ignore). -
Database schema 15 (
usage_day,usage_state). -
Database schema 16 (
night_run). -
Database schema 17 (
session.origin,session.origin_raw). -
A card has one fixed frame: a top line in plain words (the project, the agent when there is more than one, where it was started) that never wraps, the age, a two-line title and the next step. Its states are small boxes on the top edge, most important at the right: Needs you, a reminder, a night run, leftovers (their count) and Remote Control, at most four (
+Nfor more). Tokens are no longer on the card (the panel, USAGE and the picker have them; the API field stays). A test screenshots a card that carries everything at three widths. -
The session panel: what to do at the top (the moves and RESUME, a MORE menu in the top bar with every other action and its key, the state, the next step, the night run in one line, LEFTOVERS, and the forms you open, such as continue tonight); then what happened (recap, topics, sub-agents, outputs, the first prompt, where). Only the long or seldom needed parts fold to one line until opened: the night run's details, the conversation, tokens and the reminder. eye keeps the ones you open open (
eye.ink.panelinui.json), and a search that matches inside one opens it. The panel still ends with the resume command and the action row. -
/eyeon its own gives a short overview: what needs you, what runs now, what sessions left behind and what is planned tonight. The skill also knowseye usage,eye loose,eye nightandeye forget. After upgrading, runeye installonce to bring the installed/eyeskills (and the OpenCode plugin and command) up to date. -
Board panel keys: the existing N, W, P, D and R stay as they were; new are M (remind me), T (continue tonight), F (fork), C (copy the resume command), H (hide), L (leftovers), E (export) and X (forget).
?lists them; the moves and RESUME show their letter, and the panel's MORE menu shows the key of each other action. -
OpenCode on a par with Codex, checked on a real OpenCode 2.3.2 with free models: live status (running and idle from the turn times on its session row, waiting on a permission from a small plugin that
eye installputs in~/.config/opencode/plugins/anduninstallanddoctorknow), summaries (opencode run --format json, validated against the schema, one retry,--archivedand deleted afterwards; default modelfree), the/eyecommand (~/.config/opencode/commands/eye.md), archive and restore throughopencode session exportandimport,$0cost for-freemodels and the Claude and OpenAI prices forprovider/modelnames, and OpenCode as a night agent ([night] opencode_model; refused unlessallow_unsandboxed = true, since it has no sandbox). Not possible, and said indocs/agents.md: prompt history of deleted sessions, plan limits, origin and a fork from its terminal UI. -
New
Agent::restore_archivedfor an agent that puts a session back through its own import, and the daemon applies a wait that arrived before the scan indexed a new session.
Changed
- Search is one engine for the picker, the board and
eye find. Word forms match (tokensfindstoken), a mistyped word is fixed from your own sessions, and half of the words are enough. A pasted link finds the session that made it. Titles and rare words count most; status and age no longer lift a session, so old sessions are not pushed to the bottom. Archived sessions still come last. eye find --jsonand/api/searchaddrelevance(higher is better).scorekeeps its 0.2 order, lower is better: it isrelevancenegated.- Database schema 13 (the search index stems words; 0.2.x still reads it).
- Dependencies: axum 0.8, zstd 0.14, toml 1.2, jiff in place of chrono, vite 8.3.7 (face).
config.toml: a section or key this version does not know is listed once on standard error and ignored; text that is not TOML is still refused.- Sessions started in a temp folder (
/tmp, the system temp folder, Claude's scratchpads) are not indexed, so test and scratch runs stay off the board.[exclude] temp = falseindexes them again (for testing). Sessions indexed before stay until you forget them (eye forget --folder /tmp). - Night runs: a run is claimed before it starts, so two starters or a cancel cannot start it twice; a run whose process start time cannot be read is marked lost and never signalled. In
acceptEditsmode only build and test commands are allowed. eye importtakes thepre-importsnapshot before copying files, skips files that already match, and refuses a pack that unpacks to more than its manifest says.POST /api/loose/stop|removeneedconfirm: true. The usage backfill runs in its own thread.- Going back to 0.2.x works: it ignores the new config sections and still reads and writes the schema 17 database.
Fixed
- The accent colour picker now closes on an Esc or a click outside that comes right after it opens.
- The reminder's date picker moved from the old day when two keys came before it was drawn again (Down then PageDown from late in a month landed a month short).
Install agent-eye 0.3.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/maxipavlovic/agent-eye/releases/download/v0.3.0/agent-eye-installer.sh | shInstall prebuilt binaries via Homebrew
brew install maxipavlovic/tap/agent-eyeDownload agent-eye 0.3.0
| File | Platform | Checksum |
|---|---|---|
| agent-eye-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| agent-eye-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| agent-eye-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| agent-eye-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo maxipavlovic/agent-eyeYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation> --repo maxipavlovic/agent-eye