Commands
Every command is the same on npx bitplan and bunx bitplan.
Publish a draft. bunx bitplan works the same.
Also send wallet BEEF through 1Sat; this may speed up the viewer.
Optional label, shown in list and My drafts.
Publish the next version for this wallet and the named reader.
Drafts this wallet holds.
Check the wallet and print its identity key.
Decrypt HTML to stdout.
Print the installed CLI version.
Flags
| Command | Flags |
|---|---|
| upload <file> | --draft <origin>, --new, --description <text>, --share-with <identity-key>, --private, --relay, -y, --allow-finding <id> |
| list | --json, -v/--verbose, --limit <n> |
| fetch <origin|url> | --meta, --version <n> |
| auth / whoami | --wallet-url <url>, --json on whoami |
| version | prints the installed CLI version |
--share-with is repeatable and additive, up to 128 readers. It publishes one encrypted document plus a small wallet-wrapped key per identity. --private makes only the new version wallet-only; older shared versions cannot be revoked. Shared drafts require CLI 0.0.6+ or the current website to read.
fetch --meta writes metadata to stderr, including whether the envelope is private or shared and the public reader list. HTML remains on stdout so it can be redirected to a file.
upload --relay sends the wallet-returned Atomic BEEF to 1Sat after publishing. 1Sat attempts to capture it for OrdFS and forwards the transaction to Arcade, which can make the viewer available sooner. Relay failure is a warning; it does not undo the wallet publish.
On-chain bytes are documented in the envelope spec.