Installation

Installation

Install Script

Install the Sentry CLI using the install script:

curl https://cli.sentry.dev/install -fsS | bash

Package Managers

Install globally with your preferred package manager:

npm pnpm yarn bun

Copied!

npm install -g sentry

Or run directly without installing:

npm pnpm yarn bun

Copied!

npx sentry --help

Authentication

OAuth Device Flow (Recommended)

The easiest way to authenticate is via OAuth device flow:

sentry auth login

You’ll be given a URL and a code to enter. Once you authorize the application in your browser, the CLI will automatically receive your token.

API Token

Alternatively, you can use an API token directly:

sentry auth login --token YOUR_SENTRY_API_TOKEN

You can create API tokens in your Sentry account settings.

Check Auth Status

Verify your authentication status:

sentry auth status

Logout

To remove stored credentials:

sentry auth logout

Configuration

Credentials are stored in ~/.sentry/config.json with restricted file permissions (mode 600) for security.

Next Steps

Once authenticated, you can start using the CLI:

• Organization commands - List and view organizations
• Project commands - Manage projects
• Issue commands - Track and manage issues
• Event commands - Inspect events
• API commands - Direct API access
• Agentic Usage - Enable AI coding agents to use the CLI