clawd

Publish HTML pages to clawd.html from your terminal or an AI agent.

Install

npm install -g @avr00/clawd-html

The installed command is clawd. Requires Node.js 20+.

Authenticate

Create a token in Settings → API tokens in the web app, then:

clawd login clawd_live_xxxxxxxx
# or, non-interactively:
export CLAWD_TOKEN=clawd_live_xxxxxxxx

Usage

# Publish a file
clawd publish index.html --title "Pitch deck" --visibility unlisted

# Publish from stdin (great for agents / pipelines)
cat report.html | clawd publish --title "Q3 report"
some-llm | clawd publish -t "Generated UI" -v public

# List your pages
clawd list

# Print a page's HTML back out
clawd get aj3p2k9q > saved.html

# Delete
clawd rm aj3p2k9q

# Who am I
clawd whoami

Options

publish:

| Flag | Description | Default | |------|-------------|---------| | -t, --title <title> | Page title | <title> tag → filename → "Untitled" | | -v, --visibility <vis> | private | workspace | unlisted | public | unlisted | | -w, --workspace <slug> | Publish into a workspace | — | | -e, --expires <dur> | never, 12h, 7d, … | never | | --json | Emit the full result as JSON | — |

Global:

| Flag / env | Description | |------------|-------------| | --token / CLAWD_TOKEN | API token | | --api-url / CLAWD_API_URL | Override API base URL |

Agent-friendly behavior

• Human messages go to stderr; the shareable URL (or --json payload) goes to stdout, so URL=$(clawd publish page.html) works.
• --json on every read command for structured parsing.
• Non-zero exit code on any error, with the message on stderr.

HTTP API

The CLI is a thin wrapper over a REST API. Any agent can call it directly:

curl -X POST https://dynamic-falcon-5.convex.site/api/v1/pages \
  -H "Authorization: Bearer clawd_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"title":"Hello","content":"<h1>hi</h1>","visibility":"unlisted"}'

Endpoints: GET /api/v1/me, GET|POST /api/v1/pages, GET|DELETE /api/v1/pages/:slug.