kctl-glitchtip

Kodemeio CLI for managing GlitchTip error tracking — projects, issues, teams, uptime monitors, alerts, and platform health.

Installation

# Install from PyPI
uv tool install kctl-glitchtip

# Or add to workspace (monorepo)
uv add kctl-glitchtip

Quick Start

# Initialize config
kctl-glitchtip config init

# List all projects
kctl-glitchtip projects list

# List unresolved issues in an org
kctl-glitchtip issues list --org kodemeio --status unresolved

# Show platform dashboard
kctl-glitchtip health dashboard

# List uptime monitors
kctl-glitchtip uptime list --org kodemeio

Command Groups

Global Options

Configuration

Config lives in ~/.config/kodemeio/config.yaml under the glitchtip key.

# Initialize a profile interactively
kctl-glitchtip config init

# Add a named profile
kctl-glitchtip config add --profile prod \
  --url https://glitchtip.kodeme.io \
  --token YOUR_API_TOKEN

# Switch active profile
kctl-glitchtip config use prod

# Show current profile (token masked)
kctl-glitchtip config show

Example ~/.config/kodemeio/config.yaml:

glitchtip:
  default_profile: prod
  profiles:
    prod:
      url: https://glitchtip.kodeme.io
      token: ${GLITCHTIP_TOKEN}

Environment variables expand automatically — set GLITCHTIP_TOKEN in your shell or .env.

Development

# Install dev dependencies
cd packages/kctl-glitchtip
uv sync --all-extras

# Run tests
uv run pytest tests/ -v

# Lint
uv run ruff check src/

# Type check
uv run mypy src/

# Run CLI locally
uv run kctl-glitchtip --help