Pup
Give your AI agent a Pup — a CLI companion with 200+ commands across 33+ Datadog products.
Install / Use
/learn @datadog-labs/PupREADME
:dog2: Give Your Agent a Puppy: Introducing Pup CLI
NOTICE: This is in Preview mode, we are fine tuning the interactions and bugs that arise. Please file issues or submit PRs. Thank you for your early interest!
Every AI agent needs a loyal companion. Meet Pup — the CLI that gives your agents full access to Datadog's observability platform (because even autonomous agents need good tooling, not just tricks).
What is Pup?
A comprehensive, AI-agent-ready CLI with 320+ commands across 56 Datadog product domains. We've unleashed the full power of Datadog's APIs so your agents can fetch metrics, sniff out errors, and track down issues without barking up the wrong API tree.
AI agents are the fastest-growing interface for infrastructure management. Companies like Vercel and AWS are racing to make their platforms agent-accessible, but we're leading the pack. Pup makes Datadog the alpha choice for AI-native workflows with 100% documented API coverage while competitors are still learning basic commands.
Why Your Agent Will Love It
- :paw_prints: Well-trained: Self-discoverable commands (no need to chase documentation)
- :guide_dog: Obedient: Structured JSON/YAML output for easy parsing
- :service_dog: On a leash: OAuth2 + PKCE for scoped access (no more long-lived keys running wild)
- :dog: Knows all the tricks: Monitors, logs, metrics, RUM, security and more!
Try It (Humans Welcome Too!)
# Give your agent credentials (house-training, basically)
pup auth login
# Now they can fetch data like a good pup
pup monitors list --tags="team:api-platform" # Fetch monitors
pup logs search --query="status:error" --from="1h" # Sniff out errors
pup metrics query --query="avg:system.cpu.user{*}" # Track the metrics tail
:dog: TL;DR: We built a comprehensive CLI so AI agents can use Datadog like a pro. Give your agent a pup. They're housetrained, loyal, and know way more tricks than you'd expect.
P.S. No actual puppies were harmed in the making of this CLI. Just a lot of Rust code and API endpoints.
API Coverage
<!-- Last updated: 2026-03-17 | API Client: datadog-api-client-rust v0.28 -->Pup implements 52 of 85+ available Datadog APIs (61% coverage) with 320+ subcommands across 56 command groups.
See docs/COMMANDS.md for detailed command reference.
💡 Tip: Use Ctrl/Cmd+F to search for specific APIs. Request features via GitHub Issues.
<details> <summary><b>📊 Core Observability (5/9 implemented)</b></summary>
| API Domain | Status | Pup Commands | Notes |
|------------|--------|--------------|-------|
| Metrics | ✅ | metrics search, metrics query, metrics list, metrics get | V1 and V2 APIs supported |
| Logs | ✅ | logs search, logs list, logs aggregate | V1 and V2 APIs supported |
| Events | ✅ | events list, events search, events get | Infrastructure event management |
| RUM | ✅ | rum apps, rum sessions, rum metrics, rum retention-filters, rum playlists, rum heatmaps | Apps, sessions, metrics, retention filters, replay playlists, heatmaps |
| APM Services | ✅ | apm services, apm entities, apm dependencies, apm flow-map | Services stats, operations, resources; entity queries; dependencies; flow visualization |
| Traces | ❌ | - | Not yet implemented |
| Profiling | ❌ | - | Not yet implemented |
| Session Replay | ❌ | - | Not yet implemented |
| Spans Metrics | ❌ | - | Not yet implemented |
| API Domain | Status | Pup Commands | Notes |
|------------|--------|--------------|-------|
| Monitors | ✅ | monitors list, monitors get, monitors delete, monitors search | Full CRUD support with advanced search |
| Dashboards | ✅ | dashboards list, dashboards get, dashboards delete, dashboards url | Full management capabilities |
| SLOs | ✅ | slos list, slos get, slos delete, slos status | Full CRUD plus V2 status query |
| Synthetics | ✅ | synthetics tests, synthetics locations, synthetics suites | Tests, locations, and V2 suites management |
| Downtimes | ✅ | downtime list, downtime get, downtime cancel | Full downtime management |
| Notebooks | ✅ | notebooks list, notebooks get, notebooks delete | Investigation notebooks supported |
| Status Pages | ✅ | status-pages pages, status-pages components, status-pages degradations | New — Pages, components, and degradation management |
| Dashboard Lists | ❌ | - | Not yet implemented |
| Powerpacks | ❌ | - | Not yet implemented |
| Workflow Automation | ✅ | workflows get, workflows create, workflows update, workflows delete, workflows run, workflows instances | Full CRUD plus run and instance management (list, get, cancel) |
| API Domain | Status | Pup Commands | Notes |
|------------|--------|--------------|-------|
| Security Monitoring | ✅ | security rules, security signals, security findings, security content-packs, security risk-scores | Rules, signals, findings, content packs, entity risk scores |
| Static Analysis | ✅ | static-analysis ast, static-analysis custom-rulesets, static-analysis sca, static-analysis coverage | Code security analysis |
| Audit Logs | ✅ | audit-logs list, audit-logs search | Full audit log search and listing |
| Data Governance | ✅ | data-governance scanner-rules list | Sensitive data scanner rules |
| Application Security | ❌ | - | Not yet implemented |
| CSM Threats | ❌ | - | Not yet implemented |
| Cloud Security (CSPM) | ❌ | - | Not yet implemented |
| Sensitive Data Scanner | ❌ | - | Not yet implemented |
| API Domain | Status | Pup Commands | Notes |
|------------|--------|--------------|-------|
| Infrastructure | ✅ | infrastructure hosts list, infrastructure hosts get | Host inventory management |
| Tags | ✅ | tags list, tags get, tags add, tags update, tags delete | Host tag operations |
| Network | ⏳ | network flows list, network devices list | Placeholder — API endpoints pending |
| Cloud (AWS) | ✅ | cloud aws list, cloud aws cloud-auth persona-mappings | AWS integration management with persona mapping CRUD |
| Cloud (GCP) | ✅ | cloud gcp list | GCP integration management |
| Cloud (Azure) | ✅ | cloud azure list | Azure integration management |
| Cloud (OCI) | ✅ | cloud oci | New — Oracle Cloud tenancy configs and products |
| Containers | ❌ | - | Not yet implemented |
| Processes | ❌ | - | Not yet implemented |
| API Domain | Status | Pup Commands | Notes |
|------------|--------|--------------|-------|
| Incidents | ✅ | incidents list, incidents get, incidents attachments, incidents settings, incidents handles, incidents postmortem-templates | Incident management with settings, handles, and postmortem templates |
| On-Call (Teams) | ✅ | on-call teams (CRUD, memberships with roles) | Full team management system with admin/member roles |
| Case Management | ✅ | cases (create, search, assign, archive, projects, jira, servicenow, move) | Complete case management with Jira/ServiceNow linking |
| Error Tracking | ✅ | error-tracking issues search, error-tracking issues get | Error issue search and details |
| Service Catalog | ✅ | service-catalog list, service-catalog get | Service registry management |
| Scorecards | ✅ | scorecards list, scorecards get | Service quality scores |
| Fleet Automation | ✅ | fleet agents, fleet deployments, fleet schedules | Agent management, deployments, schedules (Preview) |
| HAMR | ✅ | hamr connections get, hamr connections create | New — High Availability Multi-Region connections |
| Investigations | ✅ | investigations list, investigations get, investigations trigger | Bits AI SRE investigation management |
| Change Management | ✅ | change-management create, change-management get, change-management update, change-management create-branch, change-management decisions | Change request management with decisions and branching |
| Incident Services/Teams | ❌ | - | Not yet implemented |
| API Domain | Status | Pup Commands | Notes |
|------------|--------|--------------|-------|
| CI Visibility | ✅ | cicd pipelines list, cicd events list | CI/CD pipeline visibility and events |
| Test Optimization | ✅ | cicd tests, cicd flaky-tests | New — Test events and flaky test management |
| DORA Metrics | ✅ | cicd dora | New — DORA deployment patching |
| Code Coverage | ✅ | code-coverage branch-summary, code-coverage commit-summary | New — Branch and commit-level coverage summaries |
| API Domain | Status | Pup Commands | Notes |
|------------|--------|--------------|-------|
| Users | ✅ | users list, users get, users roles, users seats | User and role management with seat assignment |
| Organizations | ✅ | organizations get, organizations list | Organization settings management |
| API Keys | ✅ | api-keys list, api-keys get, api-keys create, api-keys delete | Full API key CRUD |
| App Keys | ✅ | app-keys list, app-keys get, app-keys create
