Pup is a Go-based command-line interface (CLI) tool designed for seamless interaction with Datadog APIs. It targets engineers and AI agents needing programmatic access to Datadog services, offering a fast, cross-platform binary with intuitive commands and structured JSON output for automation.

How It Works

Pup leverages a native Go implementation for performance and cross-platform compatibility. It supports both modern OAuth2 authentication with browser-based login and PKCE protection, and traditional API key authentication. The CLI provides simple, direct commands for various Datadog API domains, outputting results in JSON format for easy parsing and integration into automated workflows.

Quick Start & Requirements

• Installation:
  • Go Install: go install github.com/DataDog/pup@latest
  • Manual Download: Pre-built binaries available from releases.
  • Homebrew: Coming soon.
• Authentication:
  • OAuth2 (Preferred): Requires Dynamic Client Registration (DCR) to be enabled on your Datadog site. Use pup auth login for browser-based authentication. Tokens are stored securely in the system's keychain or optionally as files (DD_TOKEN_STORAGE=file).
  • API Key: Fallback method using DD_API_KEY and DD_APP_KEY environment variables.
• Prerequisites: Go toolchain for building from source. OAuth2 requires DCR enabled on Datadog.
• Documentation: Detailed command reference in docs/COMMANDS.md, OAuth2 details in docs/OAUTH2.md.

Highlighted Details

• Implements 44.7% (38 of 85+) of Datadog APIs across various domains.
• Supports OAuth2 authentication with PKCE and automatic token refresh, alongside API key authentication.
• Provides structured JSON output for easy parsing and automation.
• Native Go implementation ensures fast, cross-platform binary execution.

Maintenance & Community

The project is currently in "Preview mode" with ongoing fine-tuning and bug fixing, encouraging users to file issues or submit pull requests. No specific community links (Discord, Slack) or notable contributors/sponsorships are mentioned in the README.

Licensing & Compatibility

Licensed under the Apache License 2.0. This license is permissive and generally compatible with commercial use and closed-source linking.

Limitations & Caveats

The tool is in preview, indicating potential instability and ongoing development. API coverage is incomplete, with significant portions of Datadog's API surface not yet implemented (e.g., Traces, Profiling, Session Replay, DORA Metrics, Key Management). OAuth2 authentication requires DCR to be enabled on the Datadog site, which may not be universally available.