A native macOS menu bar app for monitoring AI CLI sessions (Claude Code, Codex) — never lose a conversation, see what's running at a glance, resume any session in one click.
- Unified session list — every Claude Code and Codex session across every project, sorted by activity. One source of truth for
/resume. - Smart resume — click a row → if the session is running, focus its existing terminal tab (Terminal / iTerm2) or activate the host IDE (VS Code / Cursor / JetBrains). Not running → launch in your preferred terminal with
claude --resume <id>/codex resume <id>. - Live activity detection — per-session
generating…/idlebadge based on JSONL tail heuristic (Claude:stop_reasonaware; Codex:task_started/completeevent stream). - Animated tray icon — eye-themed frames reflect global state: closed eye idle, blink animation while any session is generating, open eye + count when sessions are waiting for your attention. Auto-clears on tray click / per-session interaction / 24h expiry.
- Per-session ✓ checkmark — sessions that just finished are flagged until you interact again (click row, acknowledge, or user types in that terminal).
- Inline + hover preview — each row shows last user/assistant text snippet inline (muxbar-style); hovering opens a right panel with the last ~10 turns full text.
- Cleanup & bulk archive — filter by CLI / age / search, checkbox multi-select, move old sessions to Trash. 7-day safety window protects recent sessions in both frontend and backend.
- Overflow menu per row — Reveal in Finder · Open in new terminal (force fresh) · Copy session ID · Move to trash (if idle).
- Adapter architecture —
SessionAdaptertrait makes adding new AI CLIs a single-module change.
| Icon | State |
|---|---|
 |
No sessions active — closed eye (idle) |
 + N |
N sessions currently generating responses — blinking animation |
 + N |
N sessions recently finished — open eye (awaiting attention) |
Panel screenshot & demo GIF coming in
docs/assets/— see Live panel preview (TODO).
- macOS 13 (Ventura) or later
- Node 18+ and pnpm 8+ (
brew install pnpm) - Rust 1.70+ (
brew install rustup && rustup default stable) - Xcode Command Line Tools (
xcode-select --install)
git clone https://github.com/1989v/aieye.git
cd aieye
./build.sh install
open /Applications/aieye.appAn eye icon appears in your menu bar. Click to see every Claude Code and Codex session you've ever run.
git clone https://github.com/1989v/aieye.git
cd aieye
./build.sh # Debug build + .app bundle (keeps fast rebuild cycle)
./build.sh release # Production build
./build.sh open # Build + launch from repo
./build.sh install # Build + copy to /ApplicationsWhat build.sh does:
- Verifies
pnpm/cargo/rustc pnpm install+pnpm tauri build- Injects
LSUIElement=trueintoInfo.plist(menu-bar mode — no Dock icon) - Ad-hoc codesigns with
codesign --sign -(no Apple Developer account needed) - Strips the quarantine attribute so the app launches without Gatekeeper prompts
brew install --cask 1989v/tap/aieyeAttached to GitHub Releases. On first launch, right-click → Open (ad-hoc signed, not notarized).
pnpm install
pnpm tauri dev # HMR dev mode
# Tests
export PATH="/opt/homebrew/opt/rustup/bin:$PATH"
cargo test --manifest-path src-tauri/Cargo.toml --lib| CLI | Detection | Resume | Live preview | Activity |
|---|---|---|---|---|
| Claude Code | ✅ | ✅ --resume <id> |
✅ | ✅ stop_reason aware |
| Codex | ✅ | ✅ resume <id> |
✅ | ✅ task_started / task_complete events |
| Gemini CLI / Aider / GPT CLI | 🔜 | 🔜 | 🔜 | 🔜 |
Adding a CLI = implementing SessionAdapter and registering in the coordinator.
| Action | Behavior |
|---|---|
| Click tray icon | Toggle panel · clears all finished acknowledgements |
| Click row | Smart resume (focus existing terminal tab or launch new) |
| Click row in "정리" mode | Toggle selection checkbox |
| Hover row | Right pane loads recent turns |
| ⋯ menu | Per-session actions |
| ESC / outside click | Close menu / confirm dialog |
MIT © 2026 kgd