Peeksy

See which AI coding session needs you, without another window.

Keeping track of my agents

I built Peeksy for myself as part of a wider AI engineering workflow. I often have multiple terminals open, with agents from different providers working on different things. It can be difficult to keep track of which ones need attention. Sometimes I'm expecting an agent to be working when it's actually waiting for my input, and that slows everything down.

A glance at the notch

I wanted a custom harness that gave me an overview of my agents, what they were working on and when they needed me. It also needed to stay small. I didn't want a big, bloated app or another screen to manage, so I built it into the Mac's notch: something I could glance at without it becoming a distraction.

Finding the session that needs me

Peeksy uses a traffic light system to gently alert me when an agent needs input or assistance. Opening it shows each session's title, how long it's been running, and whether it's working, waiting on me or finished. Clicking a session brings its terminal or IDE window to the front, so I can quickly deal with whatever is holding it up. Once I'm done, Peeksy disappears back into the notch and the agents keep working.

Part of my daily workflow

I initially built it for Claude Code, then extended support to Codex and agents running inside Cursor. That was part of what interested me about the project: making something useful in my day-to-day work while getting further into building harnesses around agents.

Peeksy is open source and runs locally, with no telemetry. I had a lot of fun building it, and it's something I use every day.

Built with: Swift, SwiftUI, AppKit, Claude Code and Codex hooks

Part of the Rolling Waves work archive.