CLI

dst is the unified Destesi command line. One binary, one login, one workspace — and a subcommand for each product: branch a database with dst snap, spin up a PR preview with dst preview, view AI code reviews with dst review, manage workspaces and members, mint API keys, and wire Destesi into your AI coding agent over MCP.

It is built for two places: your terminal (interactive, browser login) and your CI (a scoped token in an environment variable). The same commands work in both.

Fastest path to first value

Install, log in, and branch a Postgres database — copy-on-write, so the source is never touched.

1. Install.

   curl -fsSL https://get.destesi.io/install.sh | sh

   Installs dst for Linux or macOS (amd64 / arm64). See Install for other options.

2. Log in. This opens your browser to approve the session, then saves credentials to ~/.dst/config.yaml.

   dst login

   Confirm it worked:

   dst whoami
   # Logged in as you@example.com (Your Name)

3. Select a workspace. Every product is scoped to a workspace. Pick the one you’ll work in:

   dst workspace list
   dst workspace switch my-workspace
   # Switched to workspace "My Workspace" (my-workspace)

4. Branch a database. Point dst snap try at any Postgres URL — it registers the source, creates an isolated branch, waits for it to provision, and prints a ready-to-use DSN.

   dst snap try postgres://user:pass@host:5432/mydb
   # Registering remote…
   # Creating branch…
   # Waiting for branch to provision…
   #
   # Branch ready.
   #   branch: snap_abc (try-20260531-010900)
   #   dsn:    postgres://snap:snap@s-abc123.snap.destesi.io:30432/snap
   #
   # Try it:
   #   psql "postgres://snap:snap@s-abc123.snap.destesi.io:30432/snap"

   That DSN is a real Postgres endpoint with full read/write. Writes never reach the source.

That’s the first value. From here, drive a per-PR preview, run your test suite against the branch, or connect your AI agent.

Install

Install script

curl -fsSL https://get.destesi.io/install.sh | sh

Detects your OS and architecture, downloads the matching release, verifies its SHA-256 checksum, and drops the dst binary in /usr/local/bin (or ~/.local/bin when that isn’t writable). Supports Linux and macOS on amd64 and arm64.

Go install

go install github.com/destesi/cli/cmd/dst@latest

Keep dst current with the built-in self-updater:

dst upgrade            # check, then download + verify + replace in place
dst upgrade --check    # report whether a newer version exists, install nothing

What you can do

Branch databases — dst snapRegister Postgres or S3 remotes, clone and fork copy-on-write branches, pin fixtures, mask data with override rules.

PR previews — dst previewCreate, wait on, inspect, and tear down ephemeral preview environments — idempotent from GitHub Actions with dst preview upsert.

Code reviews — dst reviewList recent AI code reviews across your workspace's connected GitHub repos.

Connect your agent — dst mcpAdd the Destesi MCP server to Claude Code in one command, so your agent can branch and ship alongside you.

Next steps

Concepts — auth, workspaces, output formats

Command reference

Troubleshooting