Codex sessions as birds in an always-on-top window

3 minutes from github.com. Saved Oct 8, first published September 2026.

Short summary

Tomarigi is a macOS app that visualizes Claude and Codex coding agent sessions as animated birds in a floating window, letting you monitor multiple agents' status at a glance and jump between their terminal panes. It reads session transcripts directly without requiring hooks or config changes, and optionally uses API keys for speech summaries and question detection.

Displays each AI coding session as a bird with status indicators (working, waiting, done) in an always-on-top floating window that's click-through to windows below
Works passively by reading existing transcript files from ~/.claude/projects and ~/.codex/sessions with no agent-side modifications needed
Integrates with Ghostty terminal to jump directly to the pane running a specific session with one click

Full summary

Tomarigi is a macOS app that visualizes your Claude Code and Codex sessions as birds in a floating window. Each active session gets its own bird, so you can see at a glance who's working, waiting for input, or finished. Click a bird to jump directly to its Ghostty pane. The window stays on top and mostly transparent—just showing the birds and their chat bubbles—so it doesn't get in your way. You can drag the handle to move it around or click to expand to full view. The app supports five icon sets (Birds, Gnome, Cat, Robot, Frog) assigned per project. The app reads session transcripts directly from `~/.claude/projects` and `~/.codex/sessions` without needing any hooks or config changes in your agent setup. You can optionally bring your own API keys from OpenAI, Anthropic, or TypeSafe to get summaries of finished turns and detection of questions or frustration in the chat. Voice readout uses your system's built-in speech synthesizer and doesn't require any key. Installation is straightforward—just grab the .dmg from Releases, though jumping to Ghostty panes only works on macOS with Ghostty installed. The project uses Tauri for the desktop shell and Vite for the frontend, built with Bun. Development is handled through standard commands: `bun run dev` for local testing, `bun run build:verify` for a greenish-background test build, and `bun run tauri build` for release. The codebase supports 43 locales and includes a mock mode for testing (`TOMARIGI_MOCK=1`). Distribution builds are automated through CI when you push a version tag—they get signed, notarized, and attached to a GitHub Release. The whole thing is MIT licensed, including the character images generated with OpenAI's image API.

Ask about this article

No questions yet.