Skip to content

0.3.0 - 2026-11-22

Latest

Choose a tag to compare

@github-actions github-actions released this 22 Nov 11:56
2bda805

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 -p runs from its process log; sub-agent conversations as child streams; a global plugin with SessionStart and Stop hooks and the /eye skill in ~/.gemini/config; Gemini prices for the cost estimate; eye forget --transcript also clears its history lines and caches; a restored archive is a conversation agy --conversation can open; night runs only with [night] allow_unsandboxed = true (new [night] agy_model). No fork, plan limits or terminal origin: agy offers none. See docs/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 its session_index.jsonl line, 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 a manual backup 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, origin and origin_raw in eye ls --json and the card JSON, and eye ls --origin app. Sessions indexed before are filled from the first lines of their transcripts, with no re-read. docs/agents.md has 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 loose lists them and eye loose stop|remove|ignore <key> and eye loose send <session> act. Stop sends SIGTERM to a process whose pid and start time still match; remove runs git worktree remove without --force; commits and files only get a command to copy. Every action asks first. [loose] enabled and days in config.toml.

  • Antigravity CLI (agy) and OpenCode as agents ([agents] enabled = ["agy", "opencode"]; eye install turns 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). New Agent::transcript_exists for 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) and git push, gh, ssh and 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, and docs/night.md. A codex exec rollout 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) and copy, a separate local clone with no origin where your folder is locked completely, .git included. [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.isolation is a column of schema 17. docs/night.md explains 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, in eye show and 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 install does not turn it on (see docs/usage.md).

  • eye export writes one .eyepack file with everything eye knows (database, transcript archive, and copies of transcripts the agent still has), and eye 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/max to /home/max, also in Claude's -Users-max-… folder names). Import shows the plan first, asks [y/N] (--yes, --dry-run), and keeps a pre-import snapshot. The board's token is never in a pack. eye export --to - and eye import - stream a pack through standard output and input, so age -p or gpg -c can 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 (loose and loose_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 (+N for 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.panel in ui.json), and a search that matches inside one opens it. The panel still ends with the resume command and the action row.

  • /eye on its own gives a short overview: what needs you, what runs now, what sessions left behind and what is planned tonight. The skill also knows eye usage, eye loose, eye night and eye forget. After upgrading, run eye install once to bring the installed /eye skills (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 install puts in ~/.config/opencode/plugins/ and uninstall and doctor know), summaries (opencode run --format json, validated against the schema, one retry, --archived and deleted afterwards; default model free), the /eye command (~/.config/opencode/commands/eye.md), archive and restore through opencode session export and import, $0 cost for -free models and the Claude and OpenAI prices for provider/model names, and OpenCode as a night agent ([night] opencode_model; refused unless allow_unsandboxed = true, since it has no sandbox). Not possible, and said in docs/agents.md: prompt history of deleted sessions, plan limits, origin and a fork from its terminal UI.

  • New Agent::restore_archived for 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 (tokens finds token), 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 --json and /api/search add relevance (higher is better). score keeps its 0.2 order, lower is better: it is relevance negated.
  • 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 = false indexes 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 acceptEdits mode only build and test commands are allowed.
  • eye import takes the pre-import snapshot before copying files, skips files that already match, and refuses a pack that unpacks to more than its manifest says. POST /api/loose/stop|remove need confirm: 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 | sh

Install prebuilt binaries via Homebrew

brew install maxipavlovic/tap/agent-eye

Download 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-eye

You 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