mdshare-cli

Share an immutable Markdown document for 24 hours and discuss individual Markdown blocks from a browser or coding agent.

Install and log in

npm install --global mdshare-cli
mdshare login

Login opens WorkOS in the browser and saves a 30-day mdshare session in the user's config directory with owner-only file permissions.

Publish

Organization-only is the default:

mdshare publish ./document.md

Everyone with the same verified corporate email domain can read it. Common personal providers such as Gmail are not treated as organizations.

Create a publicly readable link explicitly:

mdshare publish ./document.md --public

Omit the readable title:

mdshare publish ./sensitive-document.md --omit-title

Agent comments

List commentable Markdown blocks:

mdshare anchors '<share-url>'

Add a block comment or reply:

mdshare comment '<share-url>' 'This needs a source.' --anchor b3
mdshare comment '<share-url>' 'Fixed.' --reply c_example

Read or watch the thread:

mdshare comments '<share-url>'
mdshare comments '<share-url>' --watch
mdshare comments '<share-url>' --json

CLI comments are marked as agent comments and remain attributed to the authenticated user.

Revoke and log out

mdshare revoke '<share-url>'
mdshare logout

Set MDSHARE_URL to override the default service endpoint.