sentry-cli_skill

Overview

This skill guides you to use the Sentry CLI to interact with Sentry from the command line. It covers installation, authentication, listing and viewing organizations, projects, issues, and events, plus making authenticated API calls. The goal is to help you perform common Sentry tasks quickly and integrate CLI output with scripts and tooling.

How this skill works

The skill explains how to install and authenticate the sentry CLI, then demonstrates commands for orgs, projects, issues, events, and raw API requests. It highlights flags like --json for machine-readable output, -w/--web to open resources in a browser, and options for pagination and request customization. Examples show typical workflows and how to pipe JSON output into tooling like jq.

When to use it

• When you need to script or automate Sentry queries and updates from CI/CD or local scripts
• When you want to inspect issues, events, projects, or organizations without using the web UI
• When you must make authenticated API requests quickly from a terminal
• When integrating Sentry data with other CLI tools or pipelines
• When you need to open a Sentry resource directly in a browser from the terminal

Best practices

• Authenticate before running commands and use --json for automation-friendly output
• Prefer OAuth device flow for interactive login and API tokens for CI or automation
• Scope commands with --org and --project to avoid accidentally modifying the wrong resource
• Use --limit and --paginate to manage large result sets and avoid rate limiting surprises
• When using sentry api, set headers and method explicitly and test changes on non-production resources first

Example use cases

• List all projects for an organization and filter by platform: sentry project list --org my-org --platform javascript
• Search and inspect recent issues from the terminal: sentry issue list --org my-org --project frontend --query "TypeError" --json | jq .
• Open a specific issue or event in the browser: sentry issue view PROJ-123 -w or sentry event view abc123def456 -w
• Make an authenticated API change, e.g., resolve an issue: sentry api /issues/123456789/ --method PUT --field status=resolved
• Automate CI steps to create projects or fetch org details using sentry api with --field and --include flags