CLI Overview
The CLI (sypho) is a cross-platform command-line tool for building,
deploying, and managing AI agents against your sypho control plane.
Features
- Authentication — login with a platform token against your control plane
- Project scaffolding — initialize a new agent project
- Docker building — build agent images, with manifest discovery for agent-sdk projects
- Deployment — register agents and images with the control plane
- Local dev — run agents locally against an auto-provisioned deployment
- Monitoring — stream logs and events for a run
Installation
The CLI binary is available for download from your control-plane deployment, or you can build it from source. See Installation.
Quick Start
# 1. Authenticate
sypho login
# 2. Create an agent
sypho init my-agent
cd my-agent
# 3. Build
sypho build --version 0.1.0
# 4. Deploy
sypho deploy --version 0.1.0
# 5. Run
sypho run my-agent:0.1.0 --input '{"message": "Hello!"}'
Commands
| Command | Description |
|---|---|
login | Authenticate with your control plane |
init | Create a new agent (or MCP sidecar) project |
build | Build an agent Docker image |
deploy | Register an agent version with the control plane |
commit | Build and deploy in one step |
dev | Run a local dev loop against an auto-provisioned deployment |
run | Trigger a run |
logs | Stream logs and events for a run |
list | List agents, runs, or deployments |
Configuration
The CLI stores configuration in ~/.sypho/config.toml, written by sypho login:
[auth]
endpoint = "https://your-control-plane.example.com"
token = "sypho_1a2b3c4d5e6f..."
[dev]
default_deployment_type = "dev"
There is no project-local config file — every command reads this file for the control-plane URL and token.
Global Flags
--help Show help
--version Show version