agent-pager

Detects which coding-agent CLI sessions are waiting for human input across projects.

Updated Jul 28, 2026
One-click install
npx skills add https://github.com/vinzenz/workflows --skill agent-pager-vinzenz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-pager
Source: https://github.com/vinzenz/workflows/tree/main/.agents/skills/agent-pager
Command: npx skills add https://github.com/vinzenz/workflows --skill agent-pager-vinzenz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When running multiple coding-agent sessions (Copilot CLI, Claude Code, Codex, opencode) across terminal tabs and projects, it is hard to know which session is blocked waiting on you. This Skill answers that question in one command instead of manually cycling through tabs. ## Core Features & Use Cases - Cross-agent status overview: Lists every live or recent session with its agent, project, and inferred state (waiting, working, idle, done, unknown), waiting sessions first. - Filtered waiting view: The waiting command shows only sessions blocked on a human, with a definitive empty state when none exist. - Peek without switching tabs: show <session> prints the last recorded event of a session so you can respond without changing windows. - Blocking wait loop: wait polls in the foreground until a session needs attention, honoring --timeout and --interval, and exits cleanly on expiry or Ctrl+C. - Use Case: You have four agent sessions running across three repositories; run agent-pager waiting to instantly see which one finished its turn and is waiting for your reply. ## Quick Start Ask the agent to run agent-pager and tell you which coding-agent sessions are currently waiting for your input.

Frequently Asked Questions about agent-pager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check which Claude Code or Codex sessions are waiting for me?▼

Run agent-pager with no arguments to list every live session with its state, or use agent-pager waiting to show only sessions blocked on human input. Filter by agent with --agent claude, codex, copilot, or opencode.

How to get notified when a coding agent finishes its turn?▼

Use agent-pager wait, which blocks in the foreground until a session needs attention, then prints it and exits. It honors --timeout (default 1800s) and --interval, and exits 0 with a clear message if nothing needs you before expiry.

Does agent-pager modify or lock my agent session data?▼

No, agent-pager opens every session store read-only and never writes, locks, or migrates data. A locked or corrupt store degrades to unavailable for that source while the rest of the view still renders.

How does agent-pager decide a session is waiting?▼

It infers state from two signals: who spoke last (assistant message or completed tool result versus user message or in-flight tool call) and how long the store has been silent. Sessions silent over 24 hours are excluded entirely.

What are the limitations of agent-pager's waiting detection?▼

The heuristic can be wrong when a session is mirrored in two panes, when a killed process leaves a store looking waiting forever, or under clock skew. Unrecognized store formats are reported as unknown rather than guessed.

Can agent-pager show past session history or transcripts?▼

No, agent-pager only reads the last 24 hours of activity and never persists anything. For history, full transcripts, and search across past sessions, use the agent-log tool instead.