---
name: oncall
description: Show who is currently on-call across PagerDuty schedules. Use when the user asks who is on-call, who is paged, or needs to find the current responder for a service or schedule.
user_invocable: true
---

# /oncall — Current On-Call Lookup

Show who is currently on-call across all PagerDuty schedules, or for a specific schedule.

## Steps

### 1. Fetch On-Call Data
```bash
bash "${CLAUDE_PLUGIN_ROOT}/scripts/pagerduty/get_oncall.sh"
```

To filter by a specific schedule:
```bash
bash "${CLAUDE_PLUGIN_ROOT}/scripts/pagerduty/get_oncall.sh" SCHEDULE_ID
```

### 2. Format Results

Parse the JSON output and present as a table:

| Responder | Schedule | Escalation Policy | Level | Shift Start | Shift End |
|-----------|----------|-------------------|-------|-------------|-----------|
| Jane Doe  | Primary  | Platform SRE      | 1     | 2024-01-15T08:00Z | 2024-01-16T08:00Z |

### 3. Highlight Key Information
- Flag if no one is on-call for any escalation policy (coverage gap)
- Note escalation levels (Level 1 = primary, Level 2 = secondary, etc.)
- If the user is on-call, highlight that entry

## Notes
- This is a read-only operation and does not require confirmation
- If PagerDuty auth fails, suggest running `/pd-setup`