Exports
Import from the package named in the row:
examples/teams/writer-reviewer-pair.ts (excerpt)
Tools
Each row says what the tool is, what you need installed, and where its home is.- Claude Code.
@obversa/engine-claude-cliruns each request in a fresh Claude Code process. You need Claude Code installed and signed in. Home: claude.com/code. - Codex CLI.
@obversa/engine-codex-cliruns each request in a fresh Codex CLI process. You need the Codex CLI installed and signed in. Home: github.com/openai/codex. - Devin CLI.
@obversa/engine-devin-cliruns each request in a fresh Devin process with your own sign-in and settings. You need the Devin CLI installed and signed in. See Devin CLI Engine. - OpenCode CLI.
@obversa/engine-opencode-cliruns each request in a fresh OpenCode process, with your own OpenCode login and settings. You need OpenCode 1.18.23 installed and signed in to your model’s provider. Home: opencode.ai. - Grok CLI.
@obversa/engine-grok-cliruns each request in a fresh Grok CLI process, with your own Grok login and settings. You need Grok CLI 1.0.44 installed and signed in. Home: docs.x.ai/build/cli/headless-scripting. - Anthropic API.
@obversa/engine-anthropic-apisends each request to the Anthropic API. You need an Anthropic API key. Home: console.anthropic.com. - Claude Agent SDK.
@obversa/engine-claude-agent-sdkruns each request through the Claude Agent SDK. You need Claude Code signed in on the same machine, because the SDK uses its sign-in. Home: github.com/anthropics/claude-agent-sdk. - Jev API.
@obversa/engine-jev-apianswers structured questions about a run’s recorded state. It never reads or edits files. You need a Jev endpoint and an API key. See Jev API Engine. - OpenAI Decisions.
@obversa/engine-openai-decisionsanswers the same kind of questions through OpenAI’s Decisions API, from the same document as Jev. It never reads or edits files. You need an OpenAI API key. See OpenAI Decisions Engine. - Mastra.
@obversa/engine-mastraruns an agent you built with Mastra, one call to the agent’s owngenerateper request. You need@mastra/coreand whatever your agent needs, such as its model provider’s key. See Mastra Engine. - OpenAI Agents SDK.
@obversa/engine-openai-agentsruns an agent you built with the OpenAI Agents SDK, one call to the SDK’s runner per request. You need@openai/agents,zodand whatever your agent needs, such as an OpenAI API key. See OpenAI Agents Engine. - In-process memory.
@obversa/memory-simplekeeps memory inside one process. You need nothing else. Home: Simple Memory. - Git-backed memory.
@obversa/memory-gitstores memory in private Git references, so nothing lands in the working tree, and can write a stage’s reasoning into the commit that carries its change. You need Git installed. Home: Git Memory. - Markdown search.
@obversa/memory-markdownselects ranked passages from a local folder of Markdown files and givesgroundthe selected files through a read-only memory view. You need nothing else. Home: Markdown Memory. - Webhook notifications.
@obversa/notify-webhookposts a run’s progress and its questions to your team’s channel, one message per moment. Slack and Mattermost incoming webhooks show it with no code of your own. You need an incoming webhook URL. Home: Webhook Notifications. - The review command.
@obversa/surface-diffshipsobversa-review, which opens a diff for inline review. You need Git. See Review a diff in a host pane. - The cmux host. The cmux glue opens surfaces as browser splits beside the terminal and one editor window with the two worktrees. You need cmux installed. Home: Obversa in cmux.
- Plannotator. Plannotator opens its review page in a split through the
PLANNOTATOR_BROWSERvariable the workspace launcher sets. You need Plannotator installed. Home: github.com/backnotprop/plannotator.
Packages
The api, core, runtime and runner packages share one version. The runtime
never imports an engine or a memory adapter: you pass the ones you want when
you run.
Pages
Packages. Obversa, Runtime, Runner, API, Core, Built-in Workflows, Surface, Surface Diff. Engines. Claude CLI, Codex CLI, Devin CLI, Grok CLI, OpenCode CLI, Claude Agent SDK, Anthropic API, Jev API, OpenAI Decisions, Mastra, OpenAI Agents. Coming soon: eve, LangGraph. Memory and notifications. Git Memory, Simple Memory, Markdown Memory, Webhook Notifications.Next steps
- Installation: set a project up and run the first file.
- Runtime: the package most files import from.
- Examples: complete teams that use these exports.