CLI reference

Last updated: 2026-05-04

The tavin CLI manages projects, deployments, and credentials from your terminal.

Install

brew install tavin   # coming soon
# or download from https://github.com/tavin/cli/releases

Authenticate

tavin login                         # email/password session
printf '%s' "$TAVIN_TOKEN" | tavin login --token-stdin
TAVIN_TOKEN=tvn_... tavin projects ls

Browser sign-in is for the dashboard. For headless agents and CI, use a short-lived Personal Access Token with the narrowest scopes needed.

Tokens

Personal access tokens (PATs) authenticate scripts, CI, and MCP clients.

tavin tokens new <name>      # create a PAT (printed once)
tavin tokens list            # list active tokens
tavin tokens revoke <id>     # revoke a token

Projects

tavin projects list
tavin projects new <name>

Deployments

tavin init
tavin deploy --project <id> [--service <name>] [--dockerfile Dockerfile]
tavin ps <project-id>
tavin stop <project-id> <deployment-id> [--service <name>]

On a fresh project, tavin deploy creates the first service automatically. A Dockerfile can still provide an EXPOSE port; otherwise pass the port your app listens on.

MCP

Tavin Cloud exposes the same operations to AI agents through the hosted MCP endpoint. See MCP setup.