Skip to main content

sypho deploy

Register a built agent version with the control plane.

Usage​

sypho deploy [OPTIONS]

Options​

FlagDescription
--version <VERSION>Version to deploy — must match a prior sypho build --version (default 0.1.0)
--deployment-type <TYPE>Deployment type to target, e.g. dev, staging, prod
--deployments <LIST>Comma-separated specific deployment names to assign

Example​

sypho deploy --version 0.1.0

Output:

✓ Manifest loaded for 'my-agent'
📤 Registering with control plane...
✓ Agent version: my-agent:0.1.0

With Deployment Assignment​

sypho deploy --version 0.1.0 --deployments staging,prod

Assigns this agent version to the named deployments, so runs targeting them can claim it.

What It Does​

  1. Reads the sypho.manifest.json produced by sypho build.
  2. Resolves the image reference — a brokered registry URI for a remote control plane, or a bare local tag for a local one.
  3. Registers the manifest and image with the control plane.
  4. Optionally assigns the version to specific deployments.

Next Steps​