New combined runtimes: agentuity+opencode and agentuity+claude-code

[rblalock]

Request

Create public runtimes that combine the Agentuity CLI with popular AI coding tools:

1. opencode:latest — Agentuity CLI + OpenCode
2. claude-code:latest — Agentuity CLI + Claude Code

Problem

Currently, agentuity:latest has the CLI but not OpenCode, and opencode:latest has OpenCode but not the CLI. Combining them via snapshots requires installing one tool's npm dependencies into the other's /home/agentuity/ directory, which adds thousands of files to the snapshot layer (~13K for the CLI, ~5 packages for OpenCode).

Runtimes bake everything into the Docker image layer, so the snapshot file count stays near zero. This is how agentuity:latest and opencode:latest already work individually — the tools are invisible to snapshots because they live in /var/agentuity/.

Why

• Agentuity Coder needs both OpenCode (the coding agent) and the Agentuity CLI (for agentuity dev, agentuity deploy, etc.) in the same sandbox
• Claude Code has the same need — users want to run Claude Code alongside agentuity commands
• Snapshot-based workarounds are fragile (bun-as-node symlinks, PATH hacks, thousands of npm files)
• Combined runtimes would give clean, zero-overhead snapshots with both tools available out of the box

Expected Result

// OpenCode + Agentuity CLI
const sandbox = await ctx.sandbox.create({
  runtime: 'opencode:latest', // now includes agentuity CLI
});

// Claude Code + Agentuity CLI  
const sandbox = await ctx.sandbox.create({
  runtime: 'claude-code:latest', // now includes agentuity CLI
});

Both opencode (or claude) and agentuity are available on PATH without any snapshot customization.

Related

• Snapshot build: support npm/bun dependencies in declarative YAML #964 — Snapshot build: support npm/bun dependencies in declarative YAML (workaround for this same problem)

[linear]

AGENT-1387