CLI & agents

Publish HTML from your terminal, CI, or an AI agent.

  1. Create an API key

    Keys are shown once, expire after 90 days, and can only manage your own sites.

    Checking your session…

  2. Install the CLI

    Requires Node.js 20 or newer. The installer builds the CLI from source and installs it globally:

    curl -fsSL https://smoll-host.vercel.app/install.sh | bash

    Prefer to inspect it first? Read the script or build from source.

  3. Connect the CLI

    Paste the key you created above. It is stored with owner-only permissions in your config directory:

    smoll auth set-token "smoll_..."

    For agents and CI, prefer the environment: export SMOLL_HOST_TOKEN="smoll_..."

  4. Deploy your first page

    smoll deploy ./index.html --site my-docs

    Your page goes live at https://my-docs.pritish.in. Add --json for stable, machine-readable output.

Hand it to your agent

A prompt that works

Paste this into your coding agent (Claude Code, Cursor, etc.) after setting SMOLL_HOST_TOKEN in its environment.

agent prompt

You can publish self-contained HTML pages to smoll.host with the `smoll` CLI. My API key is in the SMOLL_HOST_TOKEN environment variable.

Deploy:
- Run: smoll deploy <file.html> --site <subdomain> --json
- The file must be one self-contained .html document (all CSS and JS inline), max 16 MB.
- Subdomains are 3-30 characters: lowercase letters, numbers, and hyphens. If the name is taken, pick another one and retry.
- Always pass --json, parse stdout as JSON, and check the exit code: 0 means success, 3 means authentication failed (tell me if the token is missing or rejected).

Careful:
- Re-deploying the same --site overwrites the live page. Check what exists first with `smoll sites list --json` and ask me before overwriting.
- Only run `smoll sites delete` when I explicitly ask.

When a deploy succeeds, reply with the site.url from the JSON output.

Full reference: CLI.md · API contract (openapi.json)