Reference
Command reference
Every `si` command with its arguments and flags. Generated from the command line's source.
Run si help <command> for the same text in your terminal. Options that work with every command (--json, --org, --project, --yes, --cwd, --no-color) are listed under Command line.
si login
Sign in with your browser.
si login [options]| Flag | Notes |
|---|---|
--no-browser | Print the link instead of opening the browser |
si logout
Sign out on this machine and remove its git keys.
si logoutsi whoami
Show who you're signed in as.
si whoamisi orgs
List your organizations.
si orgssi switch
Change the current organization.
si switch <org>| Argument | Notes |
|---|---|
org | Organization slug |
si init
Create a project and repository from this folder, push and deploy.
si init [name] [options]| Argument | Notes |
|---|---|
name | Project name (default: the folder's name) Optional. |
| Flag | Notes |
|---|---|
-t, --template <nextjs|static> | Start from a template (the folder must be empty) |
--framework <nextjs|static|node> | Framework preset (default: detected) |
--root <dir> | Root directory of the app inside the repository |
--no-wait | Don't wait for the first deployment |
si link
Link this folder to an existing project.
si link [project]| Argument | Notes |
|---|---|
project | Project slug (asks when omitted) Optional. |
si unlink
Remove this folder's project link.
si unlinksi clone
Clone a project's repository and link it.
si clone <project> [dir]| Argument | Notes |
|---|---|
project | Project slug |
dir | Directory (default: the repository's name) Optional. |
si deploy
Deploy the current branch, or upload the working tree.
In a clean checkout of the project's repository, pushes the current branch and follows its build.
Otherwise (no repository, uncommitted changes, or --upload) uploads the working tree as an archive.
Pushing the production branch deploys production; uploads are previews unless --prod.
si deploy [options]| Flag | Notes |
|---|---|
--prod | Deploy to production |
--upload | Upload the working tree even in a clean checkout |
--force | Build again even if this commit (or these uploaded files) was already deployed |
--no-wait | Print the deployment and return without following the build |
si deployments
List the project's deployments.
si deployments [options]Also: si ls.
| Flag | Notes |
|---|---|
--target <production|preview> | Only production or preview deployments |
--branch <value> | Only this branch |
-n, --limit <n> | How many (default 20, at most 100) |
si promote
Make a ready deployment production, without rebuilding.
si promote <deployment>| Argument | Notes |
|---|---|
deployment | Deployment id, its last 8 characters, or its URL |
si rollback
Point production back at an earlier deployment.
si rollback [deployment]| Argument | Notes |
|---|---|
deployment | Deployment (default: the production deployment before the current one) Optional. |
si redeploy
Build a deployment's source again.
si redeploy <deployment> [options]| Argument | Notes |
|---|---|
deployment | Deployment id, its last 8 characters, or its URL |
| Flag | Notes |
|---|---|
--no-wait | Don't follow the build |
si logs
Show runtime logs (or build logs) of a deployment.
si logs [deployment] [options]| Argument | Notes |
|---|---|
deployment | Deployment (default: production) Optional. |
| Flag | Notes |
|---|---|
-f, --follow | Keep printing new lines |
-q, --query <text> | Only lines containing this text (case-insensitive) |
--level <error|warn|info|debug> | Only lines at this level or above |
--since <duration> | Start this long ago, e.g. 30s, 10m, 1h (at most 1h) |
--build | Show the build output instead |
si env ls
List variables.
si env ls [options]Also: si env list.
| Flag | Notes |
|---|---|
-e, --environment <production|preview|development> | Only variables for this environment |
si env add
Add or replace a variable (the value is read from stdin when omitted).
si env add <key> [value] [options]Also: si env set.
| Argument | Notes |
|---|---|
key | Variable name |
value | Value Optional. |
| Flag | Notes |
|---|---|
-e, --environment <production|preview|development> | Environments (repeatable; default: all three) Repeatable. |
--plain | Not sensitive: the value can be read back (and pulled) |
--dev-readable | A development-only secret developers can read back (env pull, dev); implies -e development |
si env rm
Remove a variable.
si env rm <key>Also: si env remove.
| Argument | Notes |
|---|---|
key | Variable name |
si env pull
Write variables to a .env file (sensitive values are left out, except development secrets readable by developers).
si env pull [file] [options]| Argument | Notes |
|---|---|
file | File (default: .env.local) Optional. |
| Flag | Notes |
|---|---|
-e, --environment <production|preview|development> | Environment (default: development) |
si env push
Add every variable in a .env file.
si env push [file] [options]| Argument | Notes |
|---|---|
file | File (default: .env) Optional. |
| Flag | Notes |
|---|---|
-e, --environment <production|preview|development> | Environments (repeatable; default: all three) Repeatable. |
--plain | Not sensitive: values can be read back |
si domains ls
List the project's domains and their DNS records.
si domains lsAlso: si domains list.
si domains add
Add a domain to the project.
si domains add <hostname> [options]| Argument | Notes |
|---|---|
hostname | e.g. www.example.com |
| Flag | Notes |
|---|---|
--move | It already serves a site: get the certificate first (one extra DNS record), then switch DNS without downtime |
si domains verify
Check DNS and the certificate.
si domains verify <hostname>| Argument | Notes |
|---|---|
hostname | The domain |
si domains cloudflare
Create the DNS records with the organization's Cloudflare connection.
si domains cloudflare <hostname>| Argument | Notes |
|---|---|
hostname | The domain |
si domains rm
Remove a domain.
si domains rm <hostname>Also: si domains remove.
| Argument | Notes |
|---|---|
hostname | The domain |
si open
Open the production URL (or a deployment) in the browser.
si open [deployment] [options]| Argument | Notes |
|---|---|
deployment | Deployment to open instead Optional. |
| Flag | Notes |
|---|---|
--cloud | Open the project in Cloud instead |
si dev
Run the dev server with the project's environment variables.
Runs the package.json dev script (or the command after --) with the project's variables in its environment.
Nothing is written to disk. Sensitive variables are left out, except development secrets readable by developers.
si dev [-- <command>...] [options]| Flag | Notes |
|---|---|
-e, --environment <production|preview|development> | Environment to take variables from (default: production) |
si mcp
Print the MCP server configuration for AI clients.
si mcpsi git setup
Use this CLI as git's credential helper for the git host.
si git setup [options]| Flag | Notes |
|---|---|
--remove | Remove the helper again |
si upgrade
Update to the latest version.
si upgrade [options]| Flag | Notes |
|---|---|
--check | Only check |
si completion
Print a shell completion script.
bash: si completion bash >> ~/.bashrc
zsh: si completion zsh > "${fpath[1]}/_si"
fish: si completion fish > ~/.config/fish/completions/si.fish
PowerShell: si completion powershell >> $PROFILE
si completion <shell>| Argument | Notes |
|---|---|
shell | bash, zsh, fish, powershell (bash, zsh, fish, powershell) |
si version
Show the version.
si versionsi help
Show help for a command.
si help [command...]| Argument | Notes |
|---|---|
command | Command Optional. |