glitchtip-cli

glitchtip-cli

A command-line interface for the GlitchTip API — error tracking, uptime monitoring, logs, and releases. Built for both humans and AI agents.

Installation

For Humans

npm install -g glitchtip-cli

For LLM Agents

glitchtip-cli skill-install

This installs a SKILL.md + references/pitfalls.md into your agent's skill directory. Agents use it to discover commands, configure auth, and avoid common pitfalls.

Quick Start

1. Configure Authentication

glitchtip-cli config-set url https://errors.example.com
glitchtip-cli config-set org my-org
glitchtip-cli config-set token <api-token>          # Profile → Auth Tokens in GlitchTip UI
glitchtip-cli config-set project my-project          # optional default project slug

Config is stored in ~/.glitchtiprc. Verify with glitchtip-cli config-show.

2. Try It

glitchtip-cli monitor-list
glitchtip-cli issue-list --project my-project
glitchtip-cli --json project-list | jq '.[].slug'

Output Modes

Flag	Output	Use Case
(default)	Human-readable tables / formatted JSON	Terminal viewing
--json	Machine-readable JSON	Scripts, jq pipes, AI agent consumption
--raw	Raw data without formatting	Direct consumption by other tools

glitchtip-cli monitor-list                          # Table output
glitchtip-cli --json monitor-list                   # JSON output
glitchtip-cli --json monitor-list | jq '.[].name'   # Pipe to jq
glitchtip-cli --raw monitor-show 6                  # Raw data

Configuration

# Set values
glitchtip-cli config-set url https://errors.example.com
glitchtip-cli config-set org my-org
glitchtip-cli config-set token abc123
glitchtip-cli config-set project my-project

# Show current config (secrets masked)
glitchtip-cli config-show

# Show config file location
glitchtip-cli config-path

# Profile management (multiple GlitchTip instances)
glitchtip-cli config-new staging
glitchtip-cli -p staging config-set url https://staging.example.com
glitchtip-cli -p staging config-set org staging-org
glitchtip-cli -p staging config-set token xyz789
glitchtip-cli config-use staging
glitchtip-cli config-list

Priority: CLI flags > Environment variables > Config file

-u, --url       GLITCHTIP_URL
-o, --org       GLITCHTIP_ORG
--token         GLITCHTIP_TOKEN
--project       GLITCHTIP_PROJECT
-p, --profile   GLITCHTIP_PROFILE

Agent Skill

# Install skill for all detected agents
glitchtip-cli skill-install

# Install for a specific agent
glitchtip-cli skill-install --target opencode
glitchtip-cli skill-install --target claude
glitchtip-cli skill-install --target all

# Install to current directory instead of home
glitchtip-cli skill-install --local

# Remove installed skills
glitchtip-cli skill-uninstall

The skill installs a SKILL.md + references/pitfalls.md into each agent's skill directory (~/.agents/skills/, ~/.claude/skills/, etc.).

Commands

Uptime Monitors

glitchtip-cli monitor-list
glitchtip-cli monitor-show 6
glitchtip-cli monitor-create "my-site" --url https://example.com --type GET --expected-status 200 --expected-body '"ready":true' --project my-project
glitchtip-cli monitor-update 6 --interval 300        # merges with current values
glitchtip-cli monitor-delete 6
glitchtip-cli monitor-checks 6                        # all checks
glitchtip-cli monitor-checks 6 --changes              # only up/down transitions

Issues (Error Tracking)

glitchtip-cli issue-list --project my-project
glitchtip-cli issue-list --project my-project --query "is:unresolved"
glitchtip-cli issue-list --project my-project --sort -priority
glitchtip-cli issue-show 123
glitchtip-cli issue-resolve 123
glitchtip-cli issue-mute 123
glitchtip-cli issue-unresolve 123
glitchtip-cli issue-delete 123
glitchtip-cli issue-events 123                        # all events for an issue
glitchtip-cli issue-stats 123,456 --stats-period 24h

Events

glitchtip-cli event-list --project my-project         # latest project events
glitchtip-cli issue-events 123                        # events for a specific issue

Projects

glitchtip-cli project-list

Project Keys (DSN)

glitchtip-cli key-list --project my-project
glitchtip-cli key-create --project my-project --name "my-key"

Logs

glitchtip-cli log-list --level error --service api
glitchtip-cli log-list --level error,warning --query "connection refused"
glitchtip-cli log-list --start 2026-08-01T00:00:00Z --end 2026-08-17T00:00:00Z
glitchtip-cli log-resources                           # list services, hosts, etc.
glitchtip-cli log-stats                               # volume statistics
glitchtip-cli log-show <log-id>                       # single log entry

Releases & Deploys

glitchtip-cli release-list
glitchtip-cli release-list --project my-project
glitchtip-cli release-create 1.0.0 --project my-project
glitchtip-cli release-show 1.0.0
glitchtip-cli release-update 1.0.0 --ref abc123
glitchtip-cli release-delete 1.0.0

glitchtip-cli deploy-list 1.0.0
glitchtip-cli deploy-create 1.0.0 --environment production --url https://...

glitchtip-cli commit-list 1.0.0
glitchtip-cli commit-set 1.0.0 --ids abc123,def456

Global Options

--json              Output as JSON (default: human-readable)
--raw               Output raw result without formatting
--help [command]    Show help for a command or global
--version           Show version
-p, --profile       Use named config profile
-u, --url           GlitchTip server URL
-o, --org           Organization slug
--token             API token

Development

npm install
npm run build       # tsc + generate help.json → dist/
npm test            # Run 28 unit tests
npx tsc --noEmit    # Type check only

License

MIT