ox connects your AI coworkers to Team Context and records what they do — regardless of which coding agent you run. This page is the canonical list of supported agents, what each one can do, and how to install adapters for the rest.
How support works
Every agent is bridged by an adapter — a small binary (ox-adapter-<name>) that knows where the agent writes session files, how to install hooks, and how to detect it on your machine. Some adapters ship inside ox (bundled); others install on demand from a GitHub release.
Support depth is graded into three tiers. The tier reflects how deeply ox integrates with the agent, not how good the agent is.
| Tier | What it means |
|---|---|
| Gold | Full parity. Real-time session recording, hooks, whispers, anti-entropy recovery. Tested in CI. |
| Silver | Core features. Hooks fire, context primes correctly, incremental session recording. |
| Bronze | Context injection via AGENTS.md plus session capture. Limited or no native hooks. |
Tier and capability matrix
Bundled adapters ship with ox — no install step. Community adapters install from sageox/ox-adapters.
| Agent | Tier | Source | Session capture | Hooks | Notes |
|---|---|---|---|---|---|
| Claude Code | Gold | Bundled | Real-time | Yes | Reference implementation. Dedicated guide. |
| Gemini CLI | Silver | Bundled | Real-time | Yes | Rewrites its session file every turn; full re-read per turn. |
| OpenAI Codex CLI | Silver | Bundled | Real-time | Yes | JSONL sessions, append-only. |
| Aider | Silver | Bundled | Incremental | Yes | Reads markdown chat history. |
| Amp | Bronze | Bundled | Manual | — | Cloud-first sessions; AGENTS.md marker only. |
| Pi | Bronze | Bundled | Incremental | — | Reads AGENTS.md / CLAUDE.md natively; MCP server support. |
| OpenCode | Bronze | Bundled | Incremental | — | SQLite session storage. |
| Cursor | — | Community | Incremental | — | Install from sageox/ox-adapters. |
| Windsurf | — | Community | Incremental | — | Install from sageox/ox-adapters. |
| GitHub Copilot | — | Community | Read-only | — | Install from sageox/ox-adapters. |
| Cline | — | Community | Read-only | — | Install from sageox/ox-adapters. |
The highest-feature agents get their own page. Claude Code is the reference integration — see SageOx + Claude Code for hooks, whispers, and session capture in depth.
Bundled agents
These ship inside ox. Run ox doctor after ox init to verify hooks and context injection.
Claude Code (Gold)
The reference implementation. Real-time recording via fsnotify, lifecycle hooks, push whispers, and anti-entropy recovery all work out of the box. ox init wires everything; no extra setup. Full details on the Claude Code page.
Gemini CLI (Silver)
Sessions, hooks, and context priming work. Gemini rewrites its session file every turn, so the adapter re-reads the whole file and tracks an entry-count offset instead of a byte offset. Three hook events fire (PreToolUse, PostToolUse, Stop).
OpenAI Codex CLI (Silver)
JSONL sessions are tailed in real time, the same as Claude Code. Four hook events fire (SessionStart, PreToolUse, PostToolUse, Stop). Enable hook support in Codex with codex features enable codex_hooks after installing.
Aider (Silver)
Aider records from its markdown chat history, supports incremental recording, and detects automatically.
Amp, Pi, OpenCode (Bronze)
These get context injection plus session capture, with limited native hooks. Amp is cloud-first (sessions live on ampcode.com), so recording is export-based and context flows through an AGENTS.md marker. Pi reads AGENTS.md and CLAUDE.md natively and exposes an MCP server. OpenCode stores sessions in SQLite rather than files.
List, install, and inspect adapters
See what's installed and what's available:
Install a community adapter by name from the registry:
Install an unlisted adapter straight from a GitHub repo:
Inspect a single adapter's capabilities and binary path:
Installed adapters land in ~/.local/share/ox/adapters/. Bundled adapters live alongside the ox binary and can't be removed.
What's next
- SageOx + Claude Code — the Gold-tier reference integration
- Build a custom adapter — support an agent ox doesn't bundle yet
- CodeDB: smarter code navigation — give any agent a semantic map of your codebase
SageOx + Codex
Give OpenAI Codex your team's full context. ox bundles a Codex adapter that primes Team Context and captures sessions to the Ledger — the same prime-work-capture loop Claude Code gets.
Build a custom adapter
Add ox support for any AI coding agent by writing an adapter that speaks the ox protocol.