Skip to content

Command Line Interface (CLI)

The SweatStack CLI allows you to manage your SweatStack resources directly from the terminal. It's ideal for:

  • Quickly creating private applications for development purposes
  • Deploying static sites to SweatStack Pages

Tip: SweatStack Skills

Install SweatStack Skills in your AI coding agent and it will directly know how to use this cli.

Installation

curl -LsSf sweatstack.no/install-cli | sh

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

(This uses uvx.sh under the hood)

Verify the installation:

sweatstack --version
Alternative: Install from PyPI

If you prefer, you can install directly from PyPI using uv:

uv pip install sweatstack-cli

Authentication

Before using the CLI, authenticate with your SweatStack account:

sweatstack login

This opens your browser for OAuth2 authentication. Once complete, your credentials are securely stored locally.

Other auth commands:

Command Description
sweatstack logout Remove stored credentials
sweatstack whoami Show current authenticated user
sweatstack status Show authentication status and token details

Commands

Deploy static sites

Deploy a static site to SweatStack Pages:

sweatstack page deploy myapp ./dist

This uploads all files from the ./dist directory to your page at myapp.sweatstack.pages.dev.

Create pages first

Pages must be created in the SweatStack dashboard before deploying.

Create applications

Create a new application:

sweatstack app create "My App"

Common options:

# Associate with a SweatStack Page (auto-configures redirect URI)
sweatstack app create "My App" --page myapp

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

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

# Output as JSON (useful 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 URI: https://my-streamlit-app.sweatstack.pages.dev/callback
  • A client secret
  • Credentials written to .env.local

Info

This command creates a private application that only you can use. For public apps, use the web interface at https://app.sweatstack.no/settings/api to add things like an image, privacy statement, etc.

Getting help

Every command supports --help:

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