The command-line interface for Sentry. Built for developers and AI agents.

Documentation |
Getting Started |
Commands

---

Installation

$3

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

$3

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

$3

`bash
npx sentry@latest
`

Quick Start

`bash


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

$3

- Bun v1.0+

$3

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

$3

`bash


Run CLI in development mode

bun run dev --help

With environment variables

bun run --env-file=.env.local src/bin.ts --help
`

$3

`bash
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