agent-eye

agent
Security Audit
Warn
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Find, sort and resume your coding-agent sessions: local index, terminal picker and board

README.md

agent-eye

Find, sort, resume and finish your coding-agent sessions, even overnight.
A local index, a terminal picker and an optional pixel-art board. macOS and Linux.

CI Quality gate Coverage crates.io Release License: MIT Platform: macOS | Linux

The terminal picker: search by words, preview a session, read its conversation, press Ctrl-G to put the resume command on the prompt

Why

Coding agents forget, and they leave things behind. Claude Code deletes transcripts after 30 days, you lose track of which session did what, nothing tells you which one is waiting on you, and finished work leaves servers running and commits on no remote. agent-eye keeps an index of every session on your machine, puts you back in one with one key, and shows what is left to finish.

Features

Search that understands you: word forms, typos, and the PR and ticket links in a session.
Resume from your prompt: Ctrl-G, a few words, Enter. Ctrl-F forks.
Nothing lost: a compressed copy of every transcript, and eye export to take it all to another machine.
Know what needs you: each session's state, next step and owner.
Leftovers, cleaned up: servers still running, commits on no remote. You stop, remove or copy, and eye asks first. eye forget removes a session for good.
Night shift: planned work runs while you sleep, in its own worktree or copy, inside your plan, and never pushes. Off until you switch it on (night).
What it costs: tokens and an API-equivalent estimate per session, project and agent, plus plan limits (usage).
Works with Claude Code, Codex, Antigravity and OpenCode, and alongside T3 Code and claude agents.
Local only: no account, no telemetry.

Install

brew install maxipavlovic/tap/agent-eye   # or: cargo install agent-eye
agent-eye install                         # --dry-run shows what it changes

No Homebrew or Rust? Take the installer script from the latest release. agent-eye install sets up the hooks, the background service and the eye command. Upgrade the way you installed (brew upgrade agent-eye, cargo install agent-eye, or the script again); the background service moves to the new version by itself. Run agent-eye install once after an upgrade to bring the /eye skills up to date.

Needs macOS 11+ or Linux (glibc 2.35+), and Claude Code, Codex CLI, Antigravity CLI (agy) or OpenCode. Codex runs eye's hooks after you approve them once with /hooks. Linux notes: docs/linux.md.

Use

eye                       # the picker: type to search, Enter resumes
eval "$(eye init zsh)"    # in ~/.zshrc: Ctrl-G opens the picker from your prompt
eye board on --open       # the board
eye usage                 # tokens, cost and plan limits
eye loose                 # leftovers: what sessions left running or unpushed
eye night                 # work planned for tonight
eye export                # one file with everything, to move or keep
eye forget <id>           # remove a session (--transcript: from its agent too)

The board: Needs you, Running, Waiting on others, Paused, Done and Ideas

eye import <file> reads an export back on another machine, paths rewritten (docs/backups.md).

Privacy

Everything stays on your machine. Summaries run your agent's own CLI on a short excerpt (secrets masked) and count against your plan; turn them off in ~/.agent-eye/config.toml. agent-eye uninstall reverts every change. Details: docs/security.md.

Works with Claude Code, Codex CLI, Antigravity CLI (agy) and OpenCode. Unofficial: not affiliated with Anthropic, OpenAI, Google or OpenCode.

Docs

Site · Terminal · Board · Config · Usage · Night shift · Backups · Agents · API · Testing · Changelog

License

MIT. The board's fonts are under the SIL Open Font License (licenses/).

Reviews (0)

No results found