Perch

Perch 🐦

**A calm view over every Claude Code agent you have running.**

If you run several Claude Code sessions across terminals, you know the feeling: something is working somewhere, something else is waiting on you, and you can't remember which tab is which. Perch is a local dashboard — made to live in your browser's new-tab page — that shows every live agent, **ranked by what needs your attention first**:

• Real titles — a small local model (via your own claude CLI) summarizes each session into a headline like "Fixing PR #32789 review comments"
• Attention ranking — agents are scored 0–100 and grouped into Needs you / Working / Parked, with a one-line reason ("needs YubiKey touch", "context almost full"). The header always shows what's next up.
• Status — working, running a shell command, or waiting on you (pulse when busy)
• Context meter — tokens used vs. the window, amber past 80%, red past 92%
• Vitals — model, tty, uptime, time in current status, project path, git branch
• A face — every agent gets a unique little bird, generated from its session id, so you can recognize "the orange one in backend" without reading anything
• Click to jump — clicking a card focuses that agent's exact Ghostty terminal: window, tab, even the right split
• Broadcast — send one prompt to many agents at once ("unblock your GPG and commit"): select cards, type, send — it's typed into each session and submitted, without stealing your focus

One Node process, zero npm dependencies. Nothing leaves your machine except the title summaries, which go through your own `claude` CLI like any other prompt.

How it works

Claude Code already writes everything Perch needs under `~/.claude`:

• ~/.claude/sessions/.json — one file per live session: pid, session id, cwd, name, live status (busy / shell / idle / …), timestamps. Perch cross-checks the pid against ps so dead sessions never show up.
• `~/.claude/projects/