GlitchTip CLI

The GlitchTip CLI is a command-line tool for interacting with GlitchTip. It can upload source maps and debug symbols, manage releases, send test events, and more.

Installation

Install Script

The install script detects your OS and architecture, downloads the appropriate pre-built binary, and installs it to /usr/local/bin (or ~/.local/bin if /usr/local/bin is not writable):

curl -fsSL https://glitchtip.com/install.sh | sh

Pre-built Binaries

Or download a binary manually from the releases page.

From Source

If you have Rust installed:

cargo install glitchtip-cli

Authentication

Log in to your GlitchTip instance:

glitchtip-cli --url https://your-glitchtip.example.com login

By default this prompts you to paste an API token. Use --method oauth for browser-based OAuth authentication:

glitchtip-cli --url https://your-glitchtip.example.com login --method oauth

Credentials are saved to a local .sentryclirc file (or globally with --global to ~/.config/glitchtip-cli/config).

Configuration

The CLI uses a four-tier configuration system (highest priority first):

1. CLI flags — --url, --auth-token, --org, --project
2. Environment variables — SENTRY_URL, SENTRY_AUTH_TOKEN, SENTRY_DSN, etc.
3. Local config file — .glitchtip-cli.rc or .sentryclirc (searched upward from current directory, INI format)
4. Global config file — ~/.config/glitchtip-cli/config (INI format)

Key environment variables:

Example config file (INI format):

[auth]
token=your-api-token

[defaults]
url=https://your-glitchtip.example.com
org=my-org
project=my-project

Commands

Test Events

Send a test event to verify your setup:

glitchtip-cli send-event -m "Test event from CLI"

Releases

Create and manage releases:

# Create a new release
glitchtip-cli releases new 1.0.0 --org my-org --project my-project

# Finalize a release
glitchtip-cli releases finalize 1.0.0 --org my-org --project my-project

# Associate commits with a release (auto-discovers from git)
glitchtip-cli releases set-commits 1.0.0 --auto --org my-org --project my-project

# List releases
glitchtip-cli releases list --org my-org --project my-project

# Delete a release
glitchtip-cli releases delete 1.0.0 --org my-org --project my-project

Deploys

Record deployments for a release:

glitchtip-cli deploys new 1.0.0 --env production --org my-org --project my-project
glitchtip-cli deploys list 1.0.0 --org my-org --project my-project

Source Maps

Upload source maps for readable JavaScript stack traces:

# Inject debug IDs into source files
glitchtip-cli sourcemaps inject ./dist

# Upload source maps with debug IDs
glitchtip-cli sourcemaps upload ./dist --release 1.0.0 --org my-org --project my-project

Debug Files

Upload debug symbols for native applications (dSYM, PDB, ELF):

glitchtip-cli debug-files upload ./build --org my-org --project my-project

Uptime Monitors

Manage uptime monitors and send heartbeats:

# List monitors
glitchtip-cli monitors list --org my-org

# Run a command and send a heartbeat on success
glitchtip-cli monitors run <ENDPOINT_UUID> -- python manage.py scheduled_task

# Create a monitor
glitchtip-cli monitors create "My Monitor" --url https://example.com --org my-org --project my-project

# Delete a monitor
glitchtip-cli monitors delete <MONITOR_ID> --org my-org

Issues

Manage issues from the command line:

# List issues
glitchtip-cli issues list --org my-org --project my-project

# Resolve issues
glitchtip-cli issues resolve --id 123

# Mute issues
glitchtip-cli issues mute --id 456

# Unresolve issues
glitchtip-cli issues unresolve --id 789

Logs

Query logs from the command line:

glitchtip-cli logs list --org my-org

Info

Check your current configuration and authentication status:

glitchtip-cli info