npm i -g thing-artifacts
thing login --server https://your-thing-server.example.com
thing push report.html --json
thing push chart.png --json          # images and PDFs too

Commands

Command	What it does
`thing login [--server url]`	Device-code login; stores a token (does not pin a team)
`thing logout` / `thing whoami`	Clear / show the current identity and where pushes land
`thing default [team] [--clear]`	Show or set your server-side default push target (used when no `--team` is given, from any machine)
`thing use <team> [project]`	Set a local active team/project override for this machine
`thing push <file.html\|.pdf\|.png\|.jpg\|.gif\|.webp> [--name x] [--team t] [--project p] [--visibility v]`	Push a new immutable version (HTML page or image/PDF), print the served URL
`thing list`	List artifacts you can see
`thing versions <name>`	Version history for an artifact
`thing rollback <name> <n>`	Point latest back to version n
`thing open <name>`	Open the artifact in a browser

Every command accepts --json for machine-readable output.

Visibility values: private, team, anyone-with-link (prints a tokened share URL), public.

Context resolution

Which team a push lands in is decided in order: --team flag → .thing.json in the working directory → a local thing use override → your server-side default (thing default) → your personal space. Login no longer pins a team, so with none of the overrides set the server picks your default (e.g. the Unravel org for Unravel members).

Requires Node >= 18 or Bun. No runtime dependencies.