HTML Upload

Upload

npx postplan upload <plan.html>                # new draft
npx postplan upload <plan.html> --draft <id>   # new version of an existing draft

Where <plan.html> is the path to the HTML file you want to upload. The command returns a URL — display it to the user.

Reach for --draft whenever the document already has a link the user has seen: revising a plan, publishing the next revision of a write-up, correcting anything already circulating. The bare form mints a separate draft every time, which leaves the link they are holding on stale content and both versions live — the CLI has no delete command, so the duplicate cannot be retired afterwards.

The draft id is the link's subdomain, so whatever the user pasted is enough to target it — https://qi37drbp71nr.postplan.dev or https://postplan.dev/d/qi37drbp71nr/raw both give --draft qi37drbp71nr.

Read a Postplan URL

When a user supplies a postplan.dev URL, fetch the uploaded HTML immediately with the shell. Do not use web search or a browser to retrieve it.