savine

The official CLI for savine.in — deploy AI agents and agentic systems in seconds.

savine is to AI agents what vercel is to websites and railway is to services. Point it at an agent directory, run savine deploy, and your agent is live on a fully-managed, auto-scaling runtime with logs, metrics, memory, and a visual dashboard.

$ savine deploy
▲ savine  deploying agent from config.yaml
  uploaded 4 files: config.yaml, agent.py, requirements.txt, README.md
✓ Agent deployed: my-researcher
  id       fdc63413-9be2-4d74-a9be-13de4e77dae1
  version  1
  status   READY
  url      https://savine.in/agents/my-researcher

Install

npm install -g savine-cli
savine --version

Also works with bun / pnpm / yarn / deno / npx:

bun install -g savine-cli         # or: bunx savine-cli
pnpm add -g savine-cli            # or: pnpm dlx savine-cli
yarn global add savine-cli        # or: yarn dlx savine-cli
deno install -Ag npm:savine-cli
npx savine-cli deploy             # zero-install, always latest

The npm package name is savine-cli; the command is savine. Requires Node.js 18+ (or Bun ≥ 1.0, or Deno ≥ 1.28).

Five-minute tour

savine login                                     # authenticate
savine init my-agent --template agent            # scaffold
cd my-agent && savine deploy                     # ship
savine run --input "hello" --follow              # invoke + stream
savine logs --follow                             # tail logs
savine open                                      # open in browser

Command groups

| Group | Purpose | |------|---------| | login / logout / whoami / register | auth | | init / link / unlink | project lifecycle | | deploy | ship an agent, system, workflow, or GitHub URL | | ls / status | list your resources; show platform + project health | | run / tasks … | invoke agents, inspect executions, cancel, stream | | agents … systems … workflows … | resource-specific CRUD, versions, rollback | | logs [id] --follow | unified logs — live or historical | | providers … env … | manage model API keys (BYOK) + list available models | | memory … | introspect and seed agent memory | | metrics … | usage, cost, tool-call stats, queue, system health | | marketplace … | search, publish, browse featured/trending listings | | config / open / dev | local configuration, open the dashboard, local dev tips |

Full command catalogue: savine --help or visit savine.in/documentation/cli-reference.

Global flags

--json           machine-readable JSON output (where supported — whoami, ls, info, tasks get)
--api-url <url>  override the API base URL
--debug          print full error stacks
-v, --version    print CLI version
-h, --help       help for any command

Environment variables

| Variable | Purpose | |----------|---------| | SAVINE_API_URL | override API base (default https://savine.in) | | SAVINE_API_KEY | authenticate in CI without running savine login | | SAVINE_TOKEN | JWT bearer alternative to SAVINE_API_KEY | | SAVINE_DEBUG=1 | always print stack traces on error | | SAVINE_DASHBOARD_URL | override dashboard URL used by savine open | | NO_COLOR=1 | disable ANSI colours |

Scripting

# pipe to jq
savine --json agents ls | jq -r '.[] | "\(.name) \(.id)"'

# wait for a task without --follow
savine --json tasks get "$TASK_ID" | jq -r .status

# deploy in CI with a pre-issued API key
SAVINE_API_KEY="$SAVINE_KEY" savine deploy ./agents/researcher

Links

• Documentation · savine.in/documentation
• CLI reference · savine.in/documentation/cli-reference
• CLI quickstart · savine.in/documentation/cli-quickstart
• CLI recipes · savine.in/documentation/cli-recipes
• Dashboard · savine.in

License

MIT © Savine