Skip to content

Command line interface (CLI)

The SweatStack CLI manages your SweatStack resources from the terminal. Use it to:

  • Create private applications for development
  • Deploy static sites to SweatStack Pages

SweatStack Skills

Install SweatStack Skills in your AI coding agent, and it knows how to use the CLI.

Installation

curl -LsSf sweatstack.no/install-cli | sh
powershell -ExecutionPolicy ByPass -c "irm sweatstack.no/install-cli-windows | iex"

The installer uses uvx.sh.

Verify the installation:

sweatstack --version
Alternative: install from PyPI

If you prefer, install it from PyPI with uv:

uv pip install sweatstack-cli

Authentication

Before you use the CLI, sign in with your SweatStack account:

sweatstack login

This opens your browser for the OAuth2 sign-in. When it completes, the CLI stores your credentials locally.

If your account has a passkey, your browser also asks for it. If a command later says that it needs your passkey, run sweatstack login and then the command again. See Protect your developer account. This needs CLI 0.14.0 or later.

Other auth commands:

Command Description
sweatstack logout End the sign-in on SweatStack and remove stored credentials
sweatstack status Show the signed-in user, the authentication status and the CLI version

Commands

app create, app link and page init write the application, and its Page if it has one, to a sweatstack.toml file in the current directory. page serve and page deploy read their defaults from it.

Start a Pages app

Create an application, its Page and a working app in one command:

sweatstack page init "My App"

This creates a private application with a Page at my-app.pages.sweatstack.dev, and writes public/index.html: an app that signs in with SweatStack and plots the user's latest activity. If sweatstack.toml already names an application, page init uses that application. To use another application you have, add --client-id. If index.html exists, page init stops; add --force to overwrite it.

Preview a page locally

sweatstack page serve

This serves the directory from sweatstack.toml on a free port and prints the URL, for example http://localhost:8000. Open that URL, not 127.0.0.1: the application's redirect URIs allow localhost.

Deploy static sites

Deploy a static site to SweatStack Pages:

sweatstack page deploy

This uploads every file in the directory from sweatstack.toml to the Page from sweatstack.toml. Without a sweatstack.toml, give the Page slug and the directory:

sweatstack page deploy myapp --dir dist

This uploads every file in the dist directory to your Page at myapp.pages.sweatstack.dev.

Create pages first

Create the page on your app's Pages tab (open the app from Settings → API) before you deploy to it.

Create applications

Create an application:

sweatstack app create "My App"

Common options:

# Link the app to a SweatStack Page (sets the redirect URI for you)
sweatstack app create "My App" --page myapp

# Create a client secret, for confidential clients
sweatstack app create "My App" --secret

# Write the credentials to a .env file
sweatstack app create "My App" --secret --env

# Print JSON, for scripting
sweatstack app create "My App" --json
Full example with all options
sweatstack app create "My Streamlit App" \
    --page my-streamlit-app \
    --secret \
    --env-file .env.local

This creates an application with:

  • Name: "My Streamlit App"
  • Redirect URIs: http://localhost and https://my-streamlit-app.pages.sweatstack.dev. Each one also allows its sub-paths, such as /callback.
  • A client secret
  • Credentials written to .env.local

Info

This command creates a private application that only you can use, and prints a link to the app's Overview tab as the next step. To make an app public, fill in its Consent screen tab. See Going live.

sweatstack app link

This lists your applications and writes the one you select to sweatstack.toml. Add --force to replace an existing sweatstack.toml.

Build a tool on SweatStack Tools

Command Description
sweatstack tool create Create a private tool, write sweatstack.toml, and put a working tool in public/
sweatstack tool serve Serve the tool on your computer under the same network policy and sign-in as SweatStack Tools
sweatstack tool check List everything the tool would load from other sites, which SweatStack Tools blocks
sweatstack tool deploy Check the tool, upload what changed, and make it live
sweatstack tool deploys List the versions SweatStack keeps
sweatstack tool rollback Serve an earlier version again

See SweatStack Tools. These commands need CLI 0.17.0 or later.

Getting help

Every command supports --help:

sweatstack --help
sweatstack app --help
sweatstack app create --help