Overplane
v0.0.7

Reference

Agent

Agents ship as install fragments in the embedded recipe registry. Each is installed into the sandbox image and driven headlessly through overplane agent run and the build codegen phase.

Supported Agents

The table below reflects the agents built into the current overplane release. Configure them under agent.container.agent_recipes in overplane.yaml.

Supported Agents

Agent Binary Auth env
OpenAI Codex codex CODEX_API_KEY / OPENAI_API_KEY
Anthropic Claude Code claude ANTHROPIC_API_KEY
Google Gemini CLI gemini GEMINI_API_KEY
OpenCode opencode OPENROUTER_API_KEY

Default OpenCode model: openrouter/z-ai/glm-5.2 (GLM-5.2 via OpenRouter). Gemini stays on the headless Gemini CLI; Antigravity is deferred (browser-OAuth, no headless mode as of 2026-06).

OpenAI Codex

OpenAI's open-source coding agent for the terminal. Installed globally from the official @openai/codex npm package, which distributes the native Rust CLI. Requires an OpenAI API key (or codex login with a ChatGPT plan) to authenticate. The headless codex exec path honors CODEX_API_KEY (its preferred, exec-only key) while OPENAI_API_KEY also works; both are passed through to the container so either reaches the agent.

Required

command

string default "codex"

Executable the install places on the container PATH.

install_fragment

string default "agent-codex"

Embedded install script baked into the image as its own layer.

supported_setup_recipes

array<string> default ["debian", "alpine"]

Setup recipes this agent installs on.

env_passthrough

array<string> default ["CODEX_API_KEY", "OPENAI_API_KEY"]

Host environment variables (API keys) passed through to the container so the agent can authenticate. Keep these exported on the host; values never appear in logs or process listings.

Optional

Anthropic Claude Code

Anthropic's agentic coding tool. Installed globally from the official @anthropic-ai/claude-code npm package, which delivers the same native binary as Anthropic's install script via per-platform optional dependencies (including musl builds for Alpine); npm is used for layer-friendly, system-wide, version-pinnable container installs. Requires an Anthropic API key (or claude login with a Claude subscription) to authenticate.

Required

command

string default "claude"

Executable the install places on the container PATH.

install_fragment

string default "agent-claude-code"

Embedded install script baked into the image as its own layer.

supported_setup_recipes

array<string> default ["debian", "alpine"]

Setup recipes this agent installs on.

env_passthrough

array<string> default ["ANTHROPIC_API_KEY"]

Host environment variables (API keys) passed through to the container so the agent can authenticate. Keep these exported on the host; values never appear in logs or process listings.

Optional

Google Gemini CLI

Google's open-source AI agent for the terminal. Installed globally from the official @google/gemini-cli npm package (stable channel by default; the preview and nightly dist-tags work through the same version field). Requires a Gemini API key (or Google account login) to authenticate. Gemini CLI is the supported headless, env-var path for containers: as of 2026-06 Google's newer Antigravity CLI (agy) is browser-OAuth-first and lacked a supported headless mode at launch, so it is deferred and not used here.

Required

command

string default "gemini"

Executable the install places on the container PATH.

install_fragment

string default "agent-gemini-cli"

Embedded install script baked into the image as its own layer.

supported_setup_recipes

array<string> default ["debian", "alpine"]

Setup recipes this agent installs on.

env_passthrough

array<string> default ["GEMINI_API_KEY"]

Host environment variables (API keys) passed through to the container so the agent can authenticate. Keep these exported on the host; values never appear in logs or process listings.

Optional

OpenCode

The open-source, provider-agnostic AI coding agent for the terminal. Installed globally from the official opencode-ai npm package. In Overplane it authenticates through OpenRouter via OPENROUTER_API_KEY (auto-detected) and is driven headlessly with opencode run, which reports per-run usage and cost directly from models.dev pricing. Default model is openrouter/z-ai/glm-5.2 (GLM-5.2 by Z.ai via OpenRouter; web-verified 2026-07).

Required

command

string default "opencode"

Executable the install places on the container PATH.

install_fragment

string default "agent-opencode"

Embedded install script baked into the image as its own layer.

supported_setup_recipes

array<string> default ["debian", "alpine"]

Setup recipes this agent installs on.

env_passthrough

array<string> default ["OPENROUTER_API_KEY"]

Host environment variables (API keys) passed through to the container so the agent can authenticate. Keep these exported on the host; values never appear in logs or process listings.

Optional