Installation

Install Script (Recommended)

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

Homebrew

brew install getsentry/tools/sentry

Package Managers

npm install -g sentry
pnpm add -g sentry
bun add -g sentry

Run Without Installing

npx sentry@latest

Quick Start

# Authenticate with Sentry
sentry auth login

# List issues (auto-detects project from your codebase)
sentry issue list

# Get AI-powered root cause analysis
sentry issue explain PROJ-ABC

# Generate a fix plan
sentry issue plan PROJ-ABC

Features

• DSN Auto-Detection - Automatically detects your project from .env files or source code. No flags needed.
• Seer AI Integration - Get root cause analysis and fix plans directly in your terminal.
• Monorepo Support - Works with multiple projects, generates short aliases for easy navigation.
• JSON Output - All commands support --json for scripting and pipelines.
• Open in Browser - Use -w flag to open any resource in your browser.

Commands

| Command | Description | |---------|-------------| | sentry auth | Login, logout, check authentication status | | sentry org | List and view organizations | | sentry project | List and view projects | | sentry issue | List, view, explain, and plan issues | | sentry event | View event details | | sentry api | Make direct API requests |

For detailed documentation, visit cli.sentry.dev.

Configuration

Credentials are stored in ~/.sentry/ with restricted permissions (mode 600).

Development

Prerequisites

• Bun v1.0+

Setup

git clone https://github.com/getsentry/cli.git
cd cli
bun install

Running Locally

# Run CLI in development mode
bun run dev --help

# With environment variables
bun run --env-file=.env.local src/bin.ts --help

Scripts

bun run build        # Build for current platform
bun run typecheck    # Type checking
bun run lint         # Check for issues
bun run lint:fix     # Auto-fix issues
bun test             # Run tests

See DEVELOPMENT.md for detailed setup and CONTRIBUTING.md for contribution guidelines.

License

FSL-1.1-Apache-2.0