background-agent-pings · git:20260110.f8d7173 · 2026-01-10 · sha256 8551e562514fe7fa

background-agent-pings git:20260110.f8d7173A

Immutable. This exact content never changes and is served at /api/v1/blob/8551e562514fe7fa.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_3ajzcjnvrgmnr5hk/8551e562514fe7fac7dd18854d2a8116c86718494af8ec7be59d15160a58e215.json

Then /plugin install background-agent-pings@markdownregistry-3ajzcjnvrgmnr5hk in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.

---
name: background-agent-pings
description: Background Agent Pings
user-invocable: false
---

# Background Agent Pings

Trust system reminders as agent progress notifications. Don't poll.

## Pattern

When you launch a background agent, **continue working on other tasks**. The system will notify you via reminders when:
- Agent makes progress: `Agent <id> progress: X new tools used, Y new tokens`
- Agent writes output file (check the path you specified)

## DO

```
1. Task(run_in_background=true, prompt="... Output to: .claude/cache/agents/<type>/output.md")
2. Continue with next task immediately
3. When system reminder shows agent activity, check if output file exists
4. Read output file only when agent signals completion
```

## DON'T

```
# BAD: Polling wastes tokens and time
Task(run_in_background=true)
Bash("sleep 5 && ls ...")  # polling
Bash("tail /tmp/claude/.../tasks/<id>.output")  # polling
TaskOutput(task_id="...")  # floods context
```

## Why This Matters

- Polling burns tokens on repeated checks
- `TaskOutput` floods main context with full agent transcript
- System reminders are free - they're pushed to you automatically
- Continue productive work while waiting

## Source

- This session: Realized polling for agent output wasted time when system reminders already provide progress updates