pd-auto-ack

pagerduty-oncall-ack installs the pd-auto-ack CLI, a small local tool that acknowledges PagerDuty incidents only when the configured user is currently on call.

Start Here

• Quick start
• Homebrew install and upgrades
• Configuration
• Command reference
• How it works
• Rollout, rate limits, and operations
• Local development
• Changelog

What It Does

• Checks whether the configured PagerDuty user is on call.
• Displays open incidents assigned to that user.
• Acknowledges only triggered incidents in live mode.
• Provides an optional terminal dashboard for interactive monitoring.
• Leaves all other incident fields alone.

Dry-run mode is the default. Live acknowledgement requires --apply or PD_APPLY=true.

Install

Homebrew on macOS or Linux:

brew install nithishduda-ai/tap/pagerduty-oncall-ack
pd-auto-ack --version

The Homebrew package includes the terminal dashboard. See the Homebrew guide for upgrades and uninstall instructions.

Using pipx instead:

pipx install pagerduty-oncall-ack
pd-auto-ack --version

New to pipx? Use the quick start for macOS and Linux setup steps.

Optional terminal dashboard:

pipx install "pagerduty-oncall-ack[tui]"
pd-auto-ack tui --env-file ~/.pd-auto-ack.env

Repository

• GitHub repository
• PyPI package
• PagerDuty API reference