datadog-pup

: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

🔔 Monitoring & Alerting (8/10 implemented)