OAR
Open Agent Runtime is a provider-independent TypeScript programming interface for driving coding-agent runtimes such as Claude Code, Codex, Cursor and others.
At a Glance
About OAR
OAR (Open Agent Runtime) is an Apache-2.0 licensed TypeScript library and CLI from the botiverse organization. It gives applications one programming interface for many coding-agent runtimes, so developers building agent workspaces can drop per-harness logic. The latest listed release is v0.104.0.
What It Is
OAR is a provider-independent interface layer over coding-agent runtimes. The README lists Antigravity, Claude Code, Codex, CodeBuddy Code, Cursor, Grok Build, Kimi Code, OpenCode, Pi, Qwen Code, Qoder and DeepSeek Harness as supported runtimes. Pi Durable can also run through a host-owned Harness, including in a browser.
How a Session Works
A developer picks a runtime from defaultRuntimes, checks its installation, and opens a session with a working directory and optional model. Swapping runtimes leaves the code unchanged. An option a runtime cannot honor is refused before anything opens rather than silently dropped.
Sessions emit attributed events carrying a sequence number and an agent path, and raw native payloads can be kept verbatim. Control calls such as prompt, steer, queue, withdraw and abort return accepted or rejected with a typed code. Runtimes with native compaction also offer compact. Sessions can be resumed later, even from another process.
Beyond Sessions
OAR can also answer setup and dashboard questions without a session: what is installed, install and update through the vendor's own tools, login through the runtime's own flow without handling tokens, account usage and quota windows, available models, configured skills, commands and MCP servers, and settings as data a UI can render. Host tools can be attached to any runtime via serveMcpTools, and work can be handed to other runtimes through the agents entry point. An observe module folds records into views for a UI, and a testing module provides a scripted runtime that needs no binary or login.
Setup Path
The package is ESM-only. The Node entry requires Node.js 24+, and the browser entry needs a modern browser with Web Crypto. A CLI published as @botiverse/oar-cli offers commands such as list and run, with optional recording to a JSONL file.
Community Discussions
Be the first to start a conversation about OAR
Share your experience with OAR, ask questions, or help others learn from your insights.
Pricing
Open Source (Apache-2.0)
OAR core library and CLI released under the Apache License 2.0, free to use, modify and distribute.
- Provider-independent programming interface for coding-agent runtimes
- Supports Claude Code, Codex, Cursor, Grok Build, OpenCode, Pi, Qwen Code and other runtimes
- CLI published as @botiverse/oar-cli
- Node.js 24+ required; ESM-only
- Underlying agent runtimes' own accounts or subscriptions are external costs
Capabilities
Key Features
- One API across many coding-agent runtimes
- Attributed event stream with raw native payload retention
- Typed prompt, steer, queue, withdraw and abort controls
- Session resume across processes
- Host tool serving via MCP
- Subagent handoff to other runtimes
- Install, update and login through vendor tooling
- Account usage and quota reporting
- Model, skill, command and MCP inventories
- Setup forms as data for UIs
- Scripted testing runtime
- Observe module for UI views, including browser
- CLI for listing and running runtimes
