CLI deployment workflow

The Salambo CLI is the primary source-deployment interface.

Primary commands

salambo init <name>
salambo auth set --api-url <url>
salambo auth set --key <api-key>
salambo auth status
salambo auth whoami
salambo doctor
salambo manifest --path . --json
salambo deploy
salambo smoke "Say hello"

Workflow

Initialize

salambo init support-agent
cd support-agent

Authenticate

salambo auth set --api-url https://YOUR_SALAMBO_HOST
salambo auth set --key "$SALAMBO_API_KEY"
salambo auth whoami

Validate

salambo doctor
salambo manifest --path . --json

doctor is read-only. It checks project configuration, the managed runtime contract, compiled agent resources, managed packages, the selected profile, and required secret environment variables. It does not require Docker or Compose.

manifest compiles agent settings, instructions, skills, prompts, active tools and hosted extensions without uploading source.

Deploy

salambo deploy

The CLI packages the source, excludes generated dependency directories, uploads the compiled manifest, creates an immutable deployment record and verifies the source archive hash.

The hosted deployment worker prepares the managed runtime and activates the immutable deployment.

Smoke test

salambo smoke "Return the active tools and create a small workspace file."

Smoke testing calls the deployed Native Runs API. It does not simulate the hosted runtime locally.