Recap Marquee

Recap Marquee

v2.0 — Multi-session digest in tmux status-right or Claude Code statusLine. One-line situational awareness across every parallel Claude Code session.

Repo deep-dive: docs/recap.md.

What it does

When you run several Claude Code sessions across worktrees, you lose track of which session is doing what. The recap marquee gives you a single line — refreshed every 30 seconds — summarising every active session's latest action.

┌ tmux status-right ────────────────────────────────────────────────────────┐
│ [3 sessions] api: editing UserService.ts • web: gh pr merge • db: idle 2m │
└───────────────────────────────────────────────────────────────────────────┘

When something fires (a deploy-fix dispatched, a safety hook denied, a /ops:fires alert) it's flagged with 🔥 and bumped to the front.

Components

Path	Role
scripts/recap/daemon.sh	Long-lived loop. Reads session jsonl tails, builds digest.
scripts/recap/digest.sh	Synthesises the digest.
scripts/recap/marquee.sh	Formats one-line ANSI for tmux/statusLine.
hooks/recap-capture.sh	PostToolUse hook — captures Edit/Write/Bash payloads.
hooks/recap-tool-activity.sh	PostToolUse * heartbeat.
templates/com.claude-ops.recap-daemon.plist	macOS launchd unit.
skills/ops-recap/SKILL.md	/ops:recap skill.

Setup

/ops:setup step 2d installs the launchd plist and configures tmux/statusLine. Manual systemd alternative is documented in the repo deep-dive.

/ops:recap skill

Subcommand	Purpose
/ops:recap	Today's digest as a multi-line summary (richer than the marquee).
/ops:recap status	Daemon health, last digest age, active session count.
/ops:recap tail	Tail the daemon log.
/ops:recap configure	Open ~/.tmux.conf / settings.json.
/ops:recap restart	launchctl unload && load.

Configuration

Key	Type	Default	Purpose
recap_marquee_enabled	boolean	true	Master switch.
recap_marquee_auto_configure_tmux	boolean	true	Append marquee source to ~/.tmux.conf.

See also

• Auto-Fix Subsystem — surfaces deploy-fix activity as fires.
• Safety Hooks — denials surface as fires.
• Daemon Guide — the v1 ops-daemon (separate process).
• Configuration — all userConfig toggles.