Skip to main content

CLI Overview

The Sypho CLI (sypho) is a cross-platform command-line tool for building, deploying, and managing AI agents.

Features​

  • 🔐 Authentication - Secure login with platform tokens
  • 🎯 Project Scaffolding - Initialize agents with proper structure
  • 🏗️ Auto-Discovery - Generate manifests from code decorators
  • 🐳 Docker Building - Build agent images with dependencies
  • 🚀 Deployment - Register agents with control plane
  • 🏃 Local Dev - Run agents locally with auto-provisioned deployments
  • 📊 Monitoring - View logs and execution status

Installation​

macOS / Linux​

curl -sSL https://install.sypho.dev | sh

Manual Installation​

Download from GitHub Releases:

  • macOS: sypho-darwin-amd64 or sypho-darwin-arm64
  • Linux: sypho-linux-amd64
  • Windows: sypho-windows-amd64.exe
# Make executable
chmod +x sypho
mv sypho /usr/local/bin/

Quick Start​

# 1. Authenticate
sypho login

# 2. Create agent
sypho init my-agent
cd my-agent

# 3. Build
sypho build --version 0.1.0

# 4. Deploy to sypho
sypho deploy --version 0.1.0

# 5. Run on sypho
sypho run my-agent:0.1.0 --input '{"message": "Hello!"}'

Commands​

CommandDescription
loginAuthenticate with sypho
initCreate new agent project
buildBuild agent Docker image
deployDeploy agent to sypho
runExecute agent on sypho
logsView run logs

Configuration​

The CLI stores configuration in ~/.sypho/config.json:

{
  "auth": {
    "endpoint": "http://localhost:3000",
    "token": "sypho_13aaa1f4..."
  },
  "dev": {
    "default_deployment_type": "dev"
  }
}

Global Flags​

--help     Show help
--version  Show version

Next Steps​