⚡ 1–3 ms Cold Starts · Native Rust · Zero Runtime Overhead

High-Performance CLI for Bugsink

A native, standalone command-line client and autonomous agent interface for self-hosted Bugsink error tracking. Triage issues, examine stack traces, resolve regressions, and automate releases directly from your terminal.

cargo install --git https://github.com/SpaceCorps/Bugsink-Cli --locked

🚀 Native Speed

Compiled with Rust 2024, LTO, and zero async-runtime bloat. Executes in 1 to 3 milliseconds with minimal resident memory usage, ideal for CI pipelines and agent loops.

🛡️ Prompt Injection Shield

Built with agent security at the core. Treats all issue metadata, exception messages, and crash traces strictly as data—never instructions—preventing prompt injection attacks.

🔑 OS Keystore Security

Delegates API tokens directly to macOS Keychain, Windows DPAPI, or Linux Secret Service (libsecret). Secrets never touch plaintext configuration files without explicit opt-in.

🤖 Agentic Output Protocol

Outputs clean, human-readable YAML by default and structured JSON with --json. Guarantees non-empty outputs on deletes and provides structured error envelopes on stderr.

🏢 Multi-Account Isolation

Enforces deterministic account scoping via --account <name> (short -a) across multiple Bugsink servers, preventing accidental actions across production and staging.

📖 Self-Documenting Manual

Includes built-in bugsink agent-readme [--json] command, exposing rules, exit codes, and operational guides directly to LLM agents with zero network roundtrips.

Command Reference

Exhaustive coverage of Bugsink canonical API endpoints

Command Options & Arguments Description
bugsink login [name] [--endpoint <url>] [--api-token <token>] Interactive or headless authentication storing token in OS keystore.
bugsink accounts list [--check] List configured accounts and verify token validity against server.
bugsink accounts test <name> Verify connectivity and inspect server sample response.
bugsink accounts remove <name> [--yes] Remove an account and delete its token from local keystore.
bugsink issues list --project <p> [--status open|all|...] [--sort <s>] List issues for a project with client-side state filtering.
bugsink issues get <issue> Get single issue by UUID or friendly ID (e.g. MYPROJECT-7).
bugsink issues stacktrace <issue> Render the markdown stacktrace of the issue's most recent event.
bugsink issues resolve <issue> [--latest-release] [--next-release] Mark an issue resolved, optionally release-conditional.
bugsink issues reopen <issue> Mark a resolved issue unresolved again.
bugsink issues mute <issue> [--for <n> --period <p>] [--threshold <n>] Mute an issue permanently, for a duration, or until noisy.
bugsink issues unmute <issue> Unmute an issue.
bugsink issues comment <issue> (--text <t> | --stdin) Add a comment to an issue (stdin recommended for multi-line).
bugsink issues delete <issue> Permanently delete an issue and all of its events.
bugsink events list --issue <issue> [--order asc|desc] List stored events of an issue.
bugsink events get <event> [--no-data] Get event details; --no-data omits heavy SDK payload.
bugsink events stacktrace <event> Fetch and render raw markdown stacktrace for an event.
bugsink projects list [--team <team>] List projects with DSNs and event counts.
bugsink projects get <project> [--expand-team] Get project by numeric ID, slug, or name.
bugsink projects create --team <t> --name <n> [--visibility <v>] Create a project in a team with alert and retention options.
bugsink projects update <project> [--name <n>] [--retention <n>] Update project name, owning team, visibility, or alerts.
bugsink teams list [--all] [--limit <n>] List all teams across the organization.
bugsink teams create --name <n> [--visibility <v>] Create a new team.
bugsink releases list --project <project> List releases for a project.
bugsink releases create --project <p> --version <v> [--timestamp <t>] Register a release version for regression tracking.
bugsink agent-readme [--json] Output comprehensive agent manual and exit code mappings.