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.