Skip to main content

Bluebox Documentation

Bluebox is an AI SRE agent that detects production issues, diagnoses root causes with evidence from your live telemetry, and proposes fixes in your GitHub repository.

New here? Read What is Bluebox?, then follow Getting Started — you'll run your first investigation in minutes.

Public Preview​

Bluebox is currently in public preview. Features and APIs may change as we work toward general availability.

What's New​

August 2026

  • Routines — new page: run an agent on a schedule, on a preset cadence or a custom cron expression, and read its run history.

July 2026

  • How to use Bluebox — new page: investigate findings, query production before you build, and create fixes with your coding agent.
  • Core Concepts — added the proactive use case: query production with bluebox ask before writing code to ground your work in live telemetry.
  • CLI Reference — bluebox ask answers now end with an Evidence section showing the production data it queried and any coverage gaps.
  • CLI Reference — new bluebox workspace list and bluebox workspace switch commands, plus a --workspace flag on ask and otlp-endpoint for users who belong to more than one workspace.

June 2026

  • Connections — AWS DevOps Agent and Kiro integrations are now documented.
  • CLI Reference — bluebox ask now answers questions about Bluebox itself (setup, concepts, privacy). New --device-label flag on bluebox auth login.
  • Getting Started — Added agent-driven setup option; paste the install command into your coding agent for a fully guided flow.

Contents​

  • What is Bluebox? — what it does, how it works, and where it fits in your workflow.
  • Getting Started — install the CLI, connect GitHub, instrument your services, and run your first investigation.
  • Core Concepts — findings, investigations, chat, routines, and the Bluebox CLI.
  • Routines — run an agent on a schedule and read its run history.
  • CLI Reference — every bluebox command, flag, and environment variable.
  • Connections — AWS DevOps Agent and Kiro integrations.
  • How to use Bluebox — investigate findings, query production proactively, and create fixes with your coding agent.
  • Security and Privacy — what Bluebox reads, stores, and will never do.
  • FAQ — common questions and quick fixes.