Skip to main content
Find the export you need, the package it comes from, and the page that shows it running. Every package needs Node.js 22.12 or later; the tool rows below say what else each one needs.

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-cli runs 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-cli runs 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-cli runs 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-cli runs 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-cli runs 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-api sends each request to the Anthropic API. You need an Anthropic API key. Home: console.anthropic.com.
  • Claude Agent SDK. @obversa/engine-claude-agent-sdk runs 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-api answers 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-decisions answers 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-mastra runs an agent you built with Mastra, one call to the agent’s own generate per request. You need @mastra/core and whatever your agent needs, such as its model provider’s key. See Mastra Engine.
  • OpenAI Agents SDK. @obversa/engine-openai-agents runs an agent you built with the OpenAI Agents SDK, one call to the SDK’s runner per request. You need @openai/agents, zod and whatever your agent needs, such as an OpenAI API key. See OpenAI Agents Engine.
  • In-process memory. @obversa/memory-simple keeps memory inside one process. You need nothing else. Home: Simple Memory.
  • Git-backed memory. @obversa/memory-git stores 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-markdown selects ranked passages from a local folder of Markdown files and gives ground the selected files through a read-only memory view. You need nothing else. Home: Markdown Memory.
  • Webhook notifications. @obversa/notify-webhook posts 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-diff ships obversa-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_BROWSER variable 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.