shareable

CLI for Shareable — give AI-generated HTML artifacts a stable, updateable share URL.

Install

npm install -g shareable-cli

Then authorize the device once:

shareable login

Publish

shareable publish ./report.html \
  --assets ./assets \
  --title "Q2 forecast" \
  --description "Short context for the recipient"

The CLI prints the share URL on success.

Commands

| Command | What it does | | --- | --- | | shareable login | Opens a browser to authorize this device. Writes the token to ~/.shareable/env. | | shareable logout | Removes the saved token. | | shareable whoami | Prints the email this device is signed in as. | | shareable publish <file> | Uploads <file> (and optional assets) and prints the share URL. | | shareable --version | Prints the CLI version. |

Environment

The CLI reads ~/.shareable/env automatically (and falls back to the legacy ~/.annexo/env if present). Variables:

• SHAREABLE_BASE_URL — override the API host (default https://www.shareable.page).
• SHAREABLE_API_TOKEN — auth token (written by shareable login).
• SHAREABLE_SOURCE — reported upload source: cli, claude, or codex.

Legacy ANNEXO_* variables are still honored for backward compatibility.

Publishing this package

From packages/shareable-cli/:

npm publish --access public

License

MIT