catoenm

Perch — Development skill for Claude Code

Development community

A calm view over every Claude Code agent you have running — status, context, attention ranking, one click back to the terminal.

How to install Perch

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

What Perch does

A calm view over every Claude Code agent you have running — status, context, attention ranking, one click back to the terminal.

Alternatives in Development

Setup Context — Set up your Skill Memory — a pm-context.md every skill reads so outputs come back tailored to you 1.3k ★
Herdr Reviewr — Review your coding agent's diff in a terminal pane and send line comments back to Claude Code, Codex, OpenCode 823 ★
Maestro Session Manage — Manage a v3 Session — inspect status/resume-view, review knowledge candidates, complete, archive/unarchive 530 ★

README

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/