AO
PluginsAgentsOpenCode

OpenCode

OpenCode terminal agent. Uses the OpenCode session API for resume and discovery.

Slot: agent · Name: opencode · Binary: opencode

OpenCode is an open-source terminal coding agent. It has a structured session API, which means AO can discover, resume, and track its sessions reliably.

macOSSupported
LinuxSupported
WindowsSupported

Install

npm install -g opencode-ai

Use

agent-orchestrator.yaml
agent: opencode

No plugin-level config.

How it works

  • Launch: opencode starts in the worktree with AO:<sessionId> as the session title — this is how AO finds it back later.
  • Session discovery: opencode session list --format json returns the list; AO matches on the title prefix.
  • Resume: opencode --session <id> rehydrates the state.
  • Activity tracking: Primary signal is the OpenCode session's updatedAt. AO falls back to its own activity JSONL if the session API doesn't answer.
  • PR + git tracking: PATH wrappers for gh / git.

Environment variables

VariableSet by AOPurpose
AO_SESSION_ID✓AO session id
AO_ISSUE_ID✓Issue identifier
PATH✓Prepends ~/.ao/bin
GH_PATH✓Absolute path to real gh

Troubleshooting

Edit on GitHub

Aider

Aider pair-programming CLI. No session resume; AO tracks activity via terminal classification.

Runtimes overview

Where the agent process runs — tmux on macOS/Linux, plain child process everywhere.

On this page

Install
Use
How it works
Environment variables
Troubleshooting