amigoer

Roost — Development skill for Claude Code

Development community

Your Claude Code sessions, perched on the notch — a macOS menu bar app that shows at a glance which one has stopped and is waiting on you.

How to install Roost

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

What Roost does

Your Claude Code sessions, perched on the notch — a macOS menu bar app that shows at a glance which one has stopped and is waiting on you. · 让 Claude Code 会话栖在刘海上——一眼看清哪个停下来在等你的 macOS 菜单栏应用。

Alternatives in Development

Quosparr — 🐦 Native menu bar & tray app for macOS, Windows and Linux: track Codex, Claude Code and Grok quotas, resets 288 ★
Cc Bar — Native macOS menu bar app: track quota, usage and cost for Codex (multi-account) and Claude Code, from your me 119 ★
CoderBar — Native macOS agent control for Codex and Claude — monitor, approve, ask, and jump back from the menu bar 100 ★

README

Roost

**Your agent sessions, perched on the notch.**

A macOS menu-bar companion that answers one question from the corner of your eye: *which of my agent sessions has stopped and is waiting on me?*

**English** · [简体中文](README.zh-CN.md)

The expanded island: five sessions, what each is doing, and how long it has been doing it

Why

A long agent session does not fail loudly. It asks a question, raises a permission prompt, or quietly stalls on a tool — and then waits, in a window you tabbed away from twenty minutes ago. The cost is not the failure; it is the twenty minutes.

Roost keeps exactly that one fact where you already look: the notch. Nothing is happening? The notch stays the notch. Something needs you? It grows.

The chick

One mascot, seven faces, on a 15×12 pixel grid. The body wears the state's colour, so a glance answers *what is going on* before any glyph has to be read; the silhouette and the orange beak carry the identity. The eyes and the badge in the top-right corner say exactly which state it is.

Every face has a pulse of its own. All of it happens on the grid — whole cells, held frames, nothing