> ## Documentation Index
> Fetch the complete documentation index at: https://docs.htmldrop.app/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI

> Deploy the current directory from your terminal.

```bash theme={null}
npx @htmldrop.app/cli login    # opens the browser, once
npx @htmldrop.app/cli deploy   # publishes the current directory
```

`deploy` uploads the working directory as a drop and prints the live URL.
Deploying again updates the same drop, keeping the URL and adding a version.

## Typical use

```bash theme={null}
npm run build
cd dist
npx @htmldrop.app/cli deploy
```

## Without a browser

Set an API token and skip `login` entirely:

```bash theme={null}
HTMLDROP_API_TOKEN=hsk_live_... npx @htmldrop.app/cli deploy
```

That is the same mechanism used in [CI](/agents/ci-and-headless).

<Warning>
  Install the **scoped** package. `@htmldrop.app/cli` is ours; the unscoped
  `htmldrop` package on npm belongs to an unrelated project.
</Warning>