Skip to main content
Guides: Deploy, Operate, Versions.

Ship

--writable mounts persistent storage at /workspace. --writable-path PATH implies --writable.

Coding agents and approvals

Use these flags to deploy a coding agent, such as OpenCode, as a deployed agent on your cluster.

Preview a deploy

--dry-run resolves the version exactly as a real deploy does, including the version prompt, then prints the plan: agent name, whether the agent already exists, its current and new version, the image reference, whether that version was already pushed, the port, and the environment variable keys. Nothing is built, pushed, registered, deployed, or written to disk.

Run

ps —watch

-w, --watch redraws the agent list every 2 seconds until you press Ctrl-C. It can’t be combined with --json.

Filter logs

Secrets

Omit --agent for vault-wide secrets. Agent secrets are write-only: secrets get --agent fails with a message to use secrets ls --agent to see the names, or secrets set --agent to overwrite a value.