Seeybot

A cute, live Dynamic-Island widget for your Mac notch that tracks your Claude Code & Codex sessions.

English · 简体中文 · 日本語

---

What is it

Seeybot lives in your Mac's notch. At a glance it shows how many AI coding sessions are running, how many are working vs idle, and how many tokens they've burned — with a cute robot mascot that blinks, glances around and chatters when work is happening. Hover it and it springs open into a full dashboard.

Everything is read locally from the session files Claude Code and Codex already write to disk. No network, no API keys, no telemetry.

Features

• 🏝️ Lives in the notch — a small pill that expands into a dashboard on hover.
• 🤖 Animated mascot — blinks, looks around, tilts, hops, sways its antenna and throws off sparkles while work happens; dozes with zzz when idle.
• 📊 Live dashboard — total sessions, working vs idle, token throughput (output / input / cache-create / cache-read), Claude vs Codex split, and a chip per live session.
• 🎛️ Two forms — a pill hanging below the notch, or a bar across it. On Macs without a notch it shows as one flat bar automatically.
• 🖱️ Menu everywhere — a ⋯ button in the dashboard and a menu-bar icon: show/hide, switch form, check for updates, and quit.
• 🔔 Update checks — tells you when a new version is out.
• 🪶 Tiny & native — one SwiftUI binary, builds with the Command Line Tools (no Xcode), no dependencies.

Install

Homebrew

brew install --cask 7757/seeybot/seeybot

One-line script

Builds from source, installs to /Applications, starts now and auto-starts at login:

curl -fsSL https://raw.githubusercontent.com/7757/Seeybot/main/install.sh | bash

From source

git clone https://github.com/7757/Seeybot.git
cd Seeybot && ./install.sh

Apple-silicon Mac, macOS 14+, with the Command Line Tools (xcode-select --install). No Xcode required.

Usage

• Hover the widget → it opens into the dashboard. Move away → it collapses. (Collapsed, it never blocks clicks underneath.)
• ⋯ button in the dashboard, or the menu-bar gauge icon → switch form, show/hide, check for updates, Quit.

Forms

Hanging (notch)	Bar (notch)	Flat (no notch)

How it works

Every 3 seconds a background collector reads local files:

Metric	Source
Claude sessions & tokens	~/.claude/projects/**/<uuid>.jsonl — sums each assistant message's usage, de-duplicated by message.id (skips subagents/)
Codex sessions & tokens	~/.codex/sessions/**/rollout-*.jsonl — the last cumulative token_count
Today's tokens	attributed by each entry's timestamp
Live sessions	running claude / codex processes (ps + lsof for cwd / open transcript)
Working vs idle	transcript written within 45 s → working, otherwise idle

Token totals are parsed once and cached per file (size + mtime), so each tick only re-reads the sessions currently being written. Hover is detected by polling the cursor, so the panel never steals focus.

Token totals can reach billions because they include cache reads (context re-read every turn). The dashboard breaks this out and highlights Output — the tokens actually generated.

Roadmap

• Menu-bar + in-widget control (show/hide, switch form, quit)
• Non-notch Macs (flat bar)
• Update checks
• Homebrew cask
• 🔔 Desktop popup when a session finishes — next up. Agents rarely tell you the moment a long task is done; Seeybot will pop a notification the second a session goes from working to idle.
• 🔌 More AI CLIs — Cursor, Aider, Gemini CLI, Cline, opencode…
• ⚙️ Configurable refresh interval & "working" window
• 💵 Cost estimation (tokens → $ per model)
• 📈 History & trends
• 🧭 In-app auto-update

Uninstall

launchctl unload ~/Library/LaunchAgents/com.seeybot.notch.plist 2>/dev/null
rm -f ~/Library/LaunchAgents/com.seeybot.notch.plist
rm -rf /Applications/Seeybot.app
# or, if installed via Homebrew:  brew uninstall --cask seeybot

FAQ

Does it only track Claude Code and Codex? Yes for now — other tools store sessions differently and need per-tool adapters (see roadmap).

Is it automatic? Fully. It re-scans every 3 seconds and starts at login; tokens accumulate as you work.

Does it send my data anywhere? No. It only reads local files under ~/.claude and ~/.codex.

Contributing

Issues and PRs welcome — adapters for more AI CLIs, translations and UI polish are great first contributions.

License

MIT