# Obversa

> Public documentation for the Obversa packages

- [Obversa](https://docs.obversa.ai/index.md): A process runtime for software teams.
- [Installation](https://docs.obversa.ai/get-started/installation.md): Install and build the Obversa workspace from a local checkout.
- [First run](https://docs.obversa.ai/get-started/first-run.md): Run one offline process from a local checkout, then one programmatic job.
- [What Obversa is](https://docs.obversa.ai/concepts/index.md): Build your own workflows around the tools you use and the agents you run.
- [Orders](https://docs.obversa.ai/concepts/orders.md): An Order is the change you want, with the context and evidence needed to finish it.
- [Workflows](https://docs.obversa.ai/concepts/workflows.md): A workflow takes an Order through the steps that make and check the result.
- [Callback gates](https://docs.obversa.ai/concepts/callback-gates.md): A callback gate asks for one structured result from a person, an agent, or a service.
- [Surfaces](https://docs.obversa.ai/concepts/surfaces.md): A surface is a small local user interface for one decision.
- [The runtime](https://docs.obversa.ai/concepts/runtime.md): The runtime runs graphs, records events, and stores the outputs and decisions your workflow needs.
- [Memory port](https://docs.obversa.ai/memory/index.md): Use one small command contract for runtime memory.
- [Memory adapters](https://docs.obversa.ai/memory/adapters.md): Select in-process memory or memory stored in private Git references.
- [Memory mechanics](https://docs.obversa.ai/memory/mechanics.md): Ground, curate, and consolidate memory through caller-supplied functions.
- [Workspace contract](https://docs.obversa.ai/workspace/contract.md): Capture, verify, and fork one Git workspace through the public contract.
- [Workspace example](https://docs.obversa.ai/workspace/example.md): Capture, verify, lease, and fork a temporary Git repository.
- [Outside graph types](https://docs.obversa.ai/graphs/contract.md): Define, validate, and inspect a pure graph type.
- [Built-in pipeline](https://docs.obversa.ai/graphs/pipeline.md): Run ordered stages through the durable graph executor.
- [Plan admission](https://docs.obversa.ai/graphs/plan-admission.md): Bind a graph description to a host admission record.
- [Graph executor](https://docs.obversa.ai/graphs/executor.md): Run outside graph types through durable decisions and node attempts.
- [Review loop](https://docs.obversa.ai/graphs/review-loop.md): Record a bounded generation, review, and repair cycle.
- [Callback gate](https://docs.obversa.ai/graphs/callback-gate.md): Pause for one structured answer through a replaceable router.
- [Proof-bound acceptance and approval](https://docs.obversa.ai/proof/acceptance.md): Reuse a result or decision only while every covered byte still matches.
- [Events and artifacts](https://docs.obversa.ai/storage/events-and-artifacts.md): Store small events and large content, then reopen and fold the same state.
- [Safe node attempts](https://docs.obversa.ai/runtime/node-attempts.md): Run one bounded engine turn with explicit identity, results, usage, and handled-exit cleanup.
- [Supervised local runs](https://docs.obversa.ai/runtime/runner.md): Run a graph in a worker process, inspect its progress, and recover safely after a worker crash.
- [Workflow bank](https://docs.obversa.ai/production-lines/index.md): Copy complete runtime programs that use only public package exports.
- [Offline review and revision](https://docs.obversa.ai/production-lines/offline-review.md): Run a bounded process that acts on review feedback before it passes.
- [Obversa in cmux](https://docs.obversa.ai/hosts/cmux.md): Host glue for cmux: the correct editor opens on the correct worktrees, and local web surfaces open in splits beside the terminal.
- [Review a diff in a host pane](https://docs.obversa.ai/hosts/review.md): obversa-review opens a git diff for inline review in a browser pane beside the terminal and returns the annotations to the caller.
- [@obversa/runtime](https://docs.obversa.ai/packages/runtime.md): Compile graph definitions and record node outcomes.
- [@obversa/runner](https://docs.obversa.ai/packages/runner.md): Supervise local graph workers and recover safely after a worker crash.
- [@obversa/engine](https://docs.obversa.ai/packages/engine.md): The provider-neutral contract for one bounded engine attempt.
- [@obversa/memory](https://docs.obversa.ai/packages/memory.md): The storage-neutral memory port and three memory mechanics.
- [The Surfacer](https://docs.obversa.ai/packages/surfacer.md): @obversa/surfacer runs one secure local surface session and returns one opaque result to its caller.
- [Claude CLI Engine](https://docs.obversa.ai/packages/engine-claude-cli.md): @obversa/engine-claude-cli runs engine requests through a fresh Claude CLI process.
- [Codex Engine](https://docs.obversa.ai/packages/engine-codex.md): @obversa/engine-codex runs engine requests through a fresh Codex CLI process.
- [Grok CLI Engine](https://docs.obversa.ai/packages/engine-grok-cli.md): @obversa/engine-grok-cli runs isolated engine attempts through a fresh Grok CLI process.
- [OpenCode CLI Engine](https://docs.obversa.ai/packages/engine-opencode-cli.md): @obversa/engine-opencode-cli runs isolated engine attempts through a fresh OpenCode CLI process.
- [Anthropic API Engine](https://docs.obversa.ai/packages/engine-anthropic-api.md): @obversa/engine-anthropic-api runs engine requests directly through the Anthropic Messages API.
- [Agent SDK Engine](https://docs.obversa.ai/packages/engine-agent-sdk.md): @obversa/engine-agent-sdk runs engine requests through the Claude Agent SDK.
- [Git Memory](https://docs.obversa.ai/packages/memory-git.md): @obversa/memory-git stores scoped run memory in private Git references without touching branches.
- [Simple Memory](https://docs.obversa.ai/packages/memory-simple.md): @obversa/memory-simple provides an in-memory storage adapter for tests and ephemeral runs.