uphtml

uphtml CLI — one command to deploy static HTML.

Commands

npx uphtml index.html              # Run without installing
uphtml index.html                  # Deploy one HTML file
uphtml deploy index.html           # Explicit deploy alias
uphtml login <setup-code>          # Exchange a dashboard setup code for an API key
uphtml auth                        # Check authentication status
uphtml logout                      # Delete local credentials
uphtml health                      # Check API connectivity
uphtml share --slug demo           # Create a human share link
uphtml share --slug demo --kind agent
uphtml share --slug demo --link-type jwt
uphtml shares --slug demo          # List active shares
uphtml revoke <share-id> --slug demo

Usage

# Deploy one file through the configured API endpoint
uphtml index.html

# If you are not logged in yet, deploy prompts for a setup code first

# Or run the published CLI without installing it first
npx uphtml index.html

# Or use the explicit subcommand
uphtml deploy index.html

# Local development API
UPHTML_ENDPOINT=http://127.0.0.1:3000 UPHTML_API_KEY=sk_local uphtml deploy index.html

Global flags

| Flag | Description | |------|-------------| | --json | Output structured JSON instead of human-readable text | | --endpoint <url> | Override the default API endpoint | | --debug | Trace API requests |

Share options

| Flag | Description | Default | |------|-------------|---------| | --slug <slug> | Target site slug | required | | --kind <kind> | human or agent | human | | --link-type <type> | stored or jwt | stored | | --expiry <expiry> | ISO date, 1d, 7d, etc. | 1d | | --note <note> | Share note | - | | --single-use | Mark the share as single use | false |

JWT share links cannot be single use.

Auth

To authenticate the CLI, open https://app.upload-html.com/ and generate a CLI setup code from the dashboard. Then run npx uphtml login <setup-code>.

In an interactive terminal, deploy prompts for that setup code when no credentials are configured, saves the exchanged API key, then continues the upload.

The local API seeds sk_local for development. You can also run uphtml login ABCD-2345 against the local API to store a generated key in UPHTML_CONFIG_DIR. In an interactive terminal, deploy prompts for a setup code when no credentials are configured, saves the key, then continues the upload.