thing-artifacts

thing-artifacts

CLI for thing: push, version, and share HTML artifacts from coding agents.

npm i -g thing-artifacts
thing login --server https://your-thing-server.example.com
thing push report.html --json

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> [--name x] [--team t] [--project p] [--visibility v]	Push a new immutable version, 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.