Agent Platforms
CoDev installs into a repository through a per-platform adapter. --agent-platform
accepts opencode, junie, antigravity, claude, or all (the default) — pass it more
than once, or a comma-separated list, to select several platforms at once instead of
all.
codev init --target . --agent-platform opencode,claudeOpenCode and Claude Code get the full workflow described in
Concepts; Junie and Antigravity get a single narrower assistant
agent for bounded, surgical edits instead — see
ADR-0031
for why.
OpenCode
Section titled “OpenCode”The full workflow. AGENTS.md and .opencode/opencode.json are
integrations rather than copied files — CoDev owns one marked block in AGENTS.md and
selected missing values in OpenCode configuration, preserving all project-owned content.
Claude Code
Section titled “Claude Code”The full workflow, using its official .claude/agents/ location. Unlike
Antigravity, Claude Code has no configurable skills path, so the shared skills are
mirrored into .claude/skills/ at install time instead of referenced in place. Claude
Code additionally ships a .claude/settings.json and three guardrail hooks — a category
no other adapter has. require_plan.py defaults new sessions into Plan Mode and pauses
for confirmation before the first source edit, or the first repository-mutating git
command, when no design or plan document exists yet for the active branch.
require_wave_shape.py asks (never denies) when a wave plan’s “Later waves” section
already holds a populated task table, checked on saving the document and on codev git issue-create — reinforcing rolling-wave planning’s rule to detail only the current wave
and keep later waves coarse. require_small_change.py asks when a task’s diff exceeds
its review.max_lines/review.max_files budget, checked on codev git open-pr. All
three fail open on any internal error and log every ask/allow decision to a local,
gitignored gate-decision log surfaced by codev status’s gate_decisions field.
Single narrow-tier assistant agent for bounded, surgical edits, as an ordinary managed
Markdown file under .junie/agents/.
Antigravity
Section titled “Antigravity”Single narrow-tier assistant agent, using its official .agents/agents/ location
alongside CoDev’s .agents/skills/ directory.
Managing installed adapters
Section titled “Managing installed adapters”| Command | Purpose |
|---|---|
codev adapter list |
Show which platform adapters are installed |
codev adapter add <platform> |
Add one adapter to an existing installation |
codev adapter remove <platform> |
Remove one adapter (still works for a platform an older CoDev version installed, even after the current version drops it) |
codev adapter verify <platform> |
Check one adapter’s structural conformance: lifecycle wiring present, no unrestricted shell access, no retired review-scale patterns |