Skip to main content
Obversa is a library you import: add the packages to a Node project, write a TypeScript file, and run it. There’s nothing to clone, no service to run and no account to sign into.

Prerequisites

You need:
  • Node.js 22.12 or later.
  • npm or pnpm.
  • A coding agent signed in, such as Claude Code or Codex, for a run that calls a model.
Every Obversa package is an ES module, so the project needs "type": "module" in its package.json, and tsx runs a TypeScript file directly:
Terminal

Install

Install the bundle:
The bundle installs every package except the Jev, Devin, Mastra and OpenAI Agents engines, which each install on their own. It has no API of its own, so import each tool from its own package. Plugins and tools lists what each engine needs on your machine.

Next steps

  • First run: have Claude write a function, run its tests, and ask Codex to review it.
  • Examples: complete teams you can copy, with what each run printed.
  • Contributing: working on Obversa itself needs a checkout, and the contributor guide covers it.