Docs/Obel CLIActive

Capture the failure. Replay the fix.

Obel CLI is a local-first developer tool that captures broken software projects into replayable failure capsules — preserving the exact context of a command, build, or crash so it can be replayed, inspected, explained, and eventually fixed.

Updated 2026/6 Sections/Repository
Obel CLI running a project scan in a macOS terminal window.

01What Obel does

What Obel does

Obel wraps a command, watches it run, and captures the failure when it exits unsuccessfully. The result is a local folder called a failure capsule.

A capsule is designed to preserve the evidence around a broken command: what ran, what printed, how it exited, which project it came from, and what environment it happened inside.

The first principle is simple: debugging context should not disappear when the terminal scrolls away.

02Command surface

Command surface

The CLI should stay small enough to remember. These commands define the current product shape:

  • obel scan
  • obel capture <command...>
  • obel replay <capsule-path>
  • obel explain <capsule-path>

03Failure capsules

Failure capsules

A failure capsule is the core Obel object. It is local-first, inspectable, and structured so humans and tools can both read it.

Known capsule structure:

  • .obel/capsules/<slug>/
  • capsule.json
  • stdout.log
  • stderr.log
  • report.md

04Captured context

Captured context

Obel captures enough context to explain and replay a failure without turning the user’s machine into a surveillance surface.

  • command
  • stdout
  • stderr
  • exit code
  • duration
  • project metadata
  • package manager
  • git state
  • runtime versions
  • platform info
  • secret-redacted environment keys
  • generated report

05Privacy model

Privacy model

Obel is local-first by default. Capsules are stored on the developer’s machine, and environment data should be secret-redacted before it becomes part of a report.

The tool should prefer explicit user action over background collection. No account, hosted service, or surprise upload should be required for the CLI workflow.

06Roadmap

Roadmap

Obel should not remain just a CLI. The long-term direction is a local-first failure intelligence system: Sentry-style debugging, but self-hosted, capsule-based, and without surprise billing.

The strongest next step is an Obel Dashboard where failures can be viewed, searched, replayed, assigned, explained, and fixed.

  • self-hosted Obel dashboard
  • capsule viewer
  • team triage dashboard
  • AI-assisted explanation
  • AI-assisted project fixing
  • custom LLM repair workflows
  • replay comparison
  • smarter reports
  • stronger project detection
  • CI integration & GitHub Action
  • open failure capsule standard