jayintheday

Peeksy — Development skill for Claude Code

Development community

A macOS notch companion for monitoring Claude Code and Codex sessions.

How to install Peeksy

This entry records only its repository, not the path inside it, so there is no exact command to give. Open jayintheday/peeksy and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Peeksy does

A macOS notch companion for monitoring Claude Code and Codex sessions. See agent status at a glance and jump back to your terminal.

Alternatives in Development

Tmux Claude Session Manager — Run many Claude Code sessions across your projects, each in its own tmux session — then list them, see which a 380 ★
Device Control Agent — You are an autonomous macOS agent with full control of this device via two CLI tools: - steer — GUI automation 250 ★
CoderBar — Native macOS agent control for Codex and Claude — monitor, approve, ask, and jump back from the menu bar 100 ★

README

Peeksy

**Mission control for your AI agents.**

Peeksy is a background macOS app that sits a small pill next to your MacBook's notch. Its colour reflects the most urgent state across your **Claude Code and Codex** sessions. Hover to see the list; click a row to return to its terminal tab or owning application.

Peeksy expanded beside the notch, showing one working session

When you run several agents at once, it is easy to lose track of which one finished, which is still thinking, and which has been waiting on a permission. Peeksy keeps that visible without another window to watch.

Requirements

macOS 14 or later
Claude Code and/or a current Codex CLI with lifecycle hooks (integration baseline: Codex CLI 0.154.0)
A Swift toolchain (Xcode or the Command Line Tools). You build it yourself; see Installing.

Designed for Macs with a notch. There is a fallback for displays without one (the pill sits at the right of an ordinary menu-bar band), but that path is untested, as is multi-display. See [Known gaps](#known-gaps).

Installing

Releases contain source code; build the app locally using the commands below. The resulting app is ad-hoc signed. Rebuilding can require granting Automation permission again; see [Signing](#signing).

See [what changed in v0.2.0](CHANGELOG.md).

git clone https://github.com/jayintheday/peeksy.git
cd peeksy
./scripts/build_app.sh --install      # → ~/Applications/Peeksy.app
open ~/Applications/Peeksy.app

The pill should appear next to the notch. Then do these two things once:

Register your agent hooks. Hover the pill, open the gear menu, and choose Agent hooks…. Select Claude Code or Codex, review the diff, and install. Repeat for the other agent if you use both. For Codex, then **open /hooks in Codex and review and trust the Peeksy hooks