: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 325+ commands across 57 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
Pup implements 54 of 85+ available Datadog APIs (63% coverage) with 325+ subcommands across 58 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.
📊 Core Observability (5/9 implemented)
| 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 |