← Documents

Publish once. Keep the conversation.

Publish a local Markdown plan, share its link, and ask your agent to retrieve the feedback. Every update keeps the same URL.

Agent setup

The repository includes a dependency-free CLI at scripts/documents/cli.mjs, a stdio MCP server at scripts/documents/mcp.mjs, and a skill at skills/document-review/SKILL.md. Set MARKSIDE_URL to your deployment.

node scripts/documents/cli.mjs login
node scripts/documents/cli.mjs publish PLAN.md
node scripts/documents/cli.mjs feedback PLAN.md
node scripts/documents/cli.mjs pull PLAN.md
node scripts/documents/cli.mjs update PLAN.md
node scripts/documents/cli.mjs share PLAN.md

login is optional. It prints a link and a code; open the link, check the code and approve, and from then on the agent's documents are saved to your account: private until you or the agent share them, with no expiry. Without it, a published document can be read by anyone with its link and is kept for 30 days after its last edit. logout removes the sign-in from that computer.

Privacy and permissions

These online documents use a different privacy model from encrypted Hosted Snapshots: the service can read document text and comments. Do not publish material you cannot share with the service. Anyone holding a document link can read it. Commenting in the browser is being redesigned and is switched off for now; the API, CLI and MCP still store and return comments. Links are unlisted, not invite-only.

Only the publisher can edit: the browser that published a document, and the agent that holds its management key, keep that key privately. Everyone else can read it, or duplicate it into a copy of their own. Keep the management key private; lost anonymous keys cannot be recovered.

Your documents

The Documents page lists what you have written or shared from this browser; each row can be opened, copied as a link, or deleted. Deleting a shared document ends its link for everyone. Once a document is shared, every edit you make in the browser is saved automatically and shows up for anyone with the link. A new document is marked Local and stays only on your device until you press Share. Shared documents are kept for 30 days after your last edit, so editing renews them. Comments do not. Opening a document on another device lets you read but not edit; sign-in to carry documents across devices is planned.

Versions and feedback

Updates are saved immediately; the browser editor saves by itself, and consecutive autosaves are merged into one history entry. History shows changes and lets managers restore earlier text as a new version. Comments keep their original quote and version, even when that passage changes. Managers can reply, mark addressed, resolve, or reopen feedback. Reviewer names are self-reported.

Limits and safe content

Documents support up to 200,000 characters, 500 versions within a 5 MB document history budget, and 1,000 comments. Requests are limited to 120 writes per hour per source IP. Markdown, sanitized HTML, code, math and supported diagrams render using the existing viewer. Arbitrary scripts and interactive HTML uploads are not supported. External embeds are not executed.

Reconciliation

The repository remains your working source. Online edits do not silently change your file. Pull into an unchanged local file, or review the downloaded remote copy when both sides changed. Saving requires the exact version your work was based on; stale writes fail rather than overwrite someone else.