R7 · HERO · CARD ON FILM

HERALD

The curtain parts — the card speaks.
The product card sits on the spotlight plate — cover made visible.

● WORKING ✅ DONE ⚠ NEEDS YOU

● WORKING 1:24

2 subagents · session grid-a

Any key reveals the live pane

v01 · spotlight · card overlays the plate

● WORKING

call 1:claude* 2:grok ctx 51% ● WORKING

Part the curtain

Before the draw

Agent fleets vanish when unfocused

Invisible work

A grid of panes. Only the focused one is legible. The rest are black rectangles — thinking, stuck, or waiting on you?

Stuck WORKING

Turn ended, subagents still live. Or the reverse: the card never settles.

No status language

Claude hooks, Grok payloads, different field names. Without a herald, every agent speaks a private dialect.

The draw

Curtain cards. Clear signals. One CLI.

Stage draw — opaque curtain cards cover unfocused agent panes; focus reveals the live session.
Hooks for Claude + Grok — normalized payloads; same cards for both fleets.
● WORKING / ✅ DONE / ⚠ NEEDS YOU — operational drama, not noise.
Bottom bars — Claude statusline chip + tmux strip.
Zero runtime deps — install alone; siblings optional.

Craft

Four pillars of the house

Multi-agent hooks

Claude and Grok stamp the same stage.

Truth leases

Settle to DONE when the stage is clear.

Cover / reveal

Unfocused panes wear the card; any key parts the curtain.

Fail-open

Missing tools soft-fail. The house stays dark, not broken.

Cue

Raise the curtain

Install the CLI, wire hooks, arm the session. Click any line to copy.

setup

$ npm install -g status-herald

#1 Install globally — bins: herald · status-herald

$ herald curtain install

#2 Wire Claude + Grok hooks (compat settings)

$ herald curtain arm

#3 Arm the current tmux session

$ herald curtain doctor

#4 Verify hooks, tmux, settle health

$ git clone https://github.com/muslewski/status-herald.git

#1 Clone the product repo

$ cd status-herald && npm install && npm link

#2 Link herald from source

$ herald curtain install && herald curtain arm

#3 Wire + arm

✓ Need Grok native hooks too? herald curtain install grok

When many panes work

Fleet stage — one supporting reel

Hero sells cover/reveal. Fleet plate below stays secondary cinema.

v06 · fleet stage · supporting

The curtain parts — the card speaks

Stage-black. Gold fringe. Red house curtains. Zero runtime deps.

View on GitHub →