Skip to main content

Local-First Design

Contexta starts with a local .contexta/ workspace. That makes the evidence model useful in notebooks, CI jobs, offline review, and autonomous worktrees before any hosted service is involved.

Design Goals

  • keep the first run simple
  • make evidence inspectable on disk
  • avoid mandatory cloud accounts or collectors
  • support backup, restore, replay, and transfer workflows
  • let teams add adapters without making the core runtime vendor-specific

Workspace Shape

.contexta/
metadata/
records/
artifacts/
reports/
recovery/
cache/

Where Hosted Systems Fit

Hosted monitoring, experiment tracking, and tracing systems can still be useful. Contexta's local-first stance means the canonical evidence starts beside the project, then adapters can mirror selected records outward.