Dossier CLI

Publish, read, compare, and manage versioned HTML documents from your terminal. Dossier organizes documents into workspace-owned trees, preserves published versions, and supports shared CSS and font assets.

Publish an HTML plan with shared saved values. Collaborators edit, save, and return to the same document.

Install

The CLI requires Node.js 22.12 or newer and also runs under Bun.

npm install --global @agent964/dossier
dossier --help

Sign in

dossier auth login
dossier whoami

auth login opens the Dossier sign-in page in your browser, then prompts you to paste an API key. By default, the CLI connects to dossier.agent964.com.

For another deployment, supply its origin when signing in.

dossier --api-url https://dossier.example auth login

For scripts, set DOSSIER_API_KEY in the environment or pipe a key into dossier auth set. Set DOSSIER_API_URL to choose another deployment. The CLI stores credentials under ~/.dossier by default, and DOSSIER_HOME overrides that directory.

Publish and read documents

Create a complete HTML file, then upload it.

dossier upload report.html --kind report
dossier list --tree

Uploading the same file path again updates its mapped document with a new version. Use --new to publish it as a separate document. The CLI validates HTML and CSS before uploading. The deployment's policy is authoritative.

Use the document ID or URL returned by the upload in these commands.

dossier fetch <id-or-url> -o saved-report.html
dossier tree <id-or-url>
dossier diff <id-or-url>
dossier diff <id-or-url> --from 1 --to 2 --text

diff compares the previous and latest versions by default. --text compares visible text instead of HTML source. A reference such as 7k2m9x1qz3ab@2 pins a particular version.

Publish a plan with saved values

Mark each control whose value should persist with data-state="name", then upload with --stateful.

dossier upload plan.html --kind plan --stateful
dossier share <id> --add [email protected] --edit-state
dossier state link create <id>
dossier state get <id> --json

dossier state get <id>
dossier state set <id> --data values.json --revision <n>
dossier state link create <id>
dossier state link get <id>
dossier state link revoke <id>

Everyone with access sees one shared set of values. Collaborators press Save in the browser, and the CLI reads and saves the same values. A signed-in collaborator saves after share --add <email> --edit-state. Anyone with the edit link saves without an account until you revoke it. Uploading the same document again keeps its values, grants, and link. Uploads without --stateful behave as before.

Share assets and organize documents

dossier assets push theme.css
dossier assets push font.woff2
dossier assets list
dossier trash

dossier move <id> --parent <parent-id>
dossier visibility <id> public
dossier share <id> --add [email protected]
dossier delete <id>
dossier restore <id>

delete archives a document. Deleting a subtree requires --force. Archived documents become eligible for permanent removal after the deployment's retention window, normally 30 days. A weekly job on the deployment removes eligible batches automatically, and an operator can remove them sooner with dossier admin purge --execute.

Use from scripts and agents

dossier upload report.html --kind report --json
dossier list --tree --json
dossier state get <id> --json
dossier whoami --json

--json writes one JSON value to stdout, and errors go to stderr. --quiet reduces normal output, and uploads print only the resulting URL.

The package includes an agent skill at skills/dossier/SKILL.md. See the packaged skill instructions for document policy, publishing guidance, and the saved-values workflow.

Update

dossier update --check
dossier update

For a global npm installation, you can also run npm directly.

npm install --global @agent964/dossier@latest

Documentation

• Complete CLI reference
• Repository and development guide
• Deployment runbook
• Report an issue

License

MIT.