Svantic CLI

Command-line interface for the Svantic AI agent platform.

Installation

Quick install (recommended)

curl -fsSL https://install.svantic.com | bash

npm

npm install -g @svantic/cli

Homebrew (macOS)

brew install svantic/tap/svantic

Usage

# Sign in via the browser (one-time setup)
svantic login

# Interactive chat with the mesh
svantic

# Headless mode (for scripts/CI)
svantic --headless "Deploy the staging environment"

# Generate an agent from an OpenAPI spec
svantic forge openapi ./api-spec.yaml --output ./agents/my-agent

# Check platform status
svantic status

# Show who you're signed in as
svantic whoami

# Sign out (removes ~/.svantic/config.json)
svantic logout

Commands

| Command | Description | |---------|-------------| | svantic login | Browser-based sign in — stores credentials at ~/.svantic/config.json | | svantic logout | Forget stored credentials | | svantic whoami | Show the currently signed-in user + tenant | | svantic | Interactive AI chat (default) | | svantic chat | Explicit chat command | | svantic forge | Generate agents from specs | | svantic status | Platform health check | | svantic config | CLI configuration | | svantic agents | Agent management | | svantic sessions | Session management | | svantic tenants | Tenant management |

Authentication

Interactive (recommended)

svantic login

Opens your browser, takes you through the usual dashboard sign-in (email + password or Google), asks which tenant to authorise, and stores a long-lived credential at ~/.svantic/config.json (mode 0600). The CLI transparently refreshes its JWT from that credential on every subsequent command — you should rarely need to login again unless you revoke the credential from Settings → API Keys.

Headless (CI / agents)

For non-interactive environments, provide credentials via environment variables:

export SVANTIC_CLIENT_ID="your-client-id"
export SVANTIC_CLIENT_SECRET="your-client-secret"

Or pass them as flags:

svantic --client-id <id> --client-secret <secret>

Environment variables always take precedence over stored credentials, so CI systems keep working even when a user has previously run svantic login on the same machine.

License

Proprietary - Svantic Inc.