Skip to main content
Plannotator OSS sharing is asynchronous. Send a review link, let another person annotate it, then import the link they return into your local session.
  1. Open the header menu and select Copy Share Link, or open Export and choose Share.
  2. Copy the generated URL.
  3. Send the exact URL to the reviewer.
For a typical Markdown review, Plannotator compresses the document and annotations into the URL fragment. The review payload is decoded in the recipient’s browser and is not uploaded to the paste service.
Anyone with the complete URL can read the review. Treat the link as the credential and send it only through an appropriate channel.

​
Import returned annotations

Ask the reviewer to add annotations and copy their updated share link. In your original Plannotator session:
  1. Open the header menu.
  2. Select Import Review.
  3. Paste the returned URL.
Plannotator adds the imported annotations to the current review. Check them, add your own feedback if needed, then send the combined result to the agent.

​
Large sessions and HTML

Long URLs can be truncated by messaging tools. When a Markdown link exceeds about 2 KB, Export > Share offers Create short link. Rendered HTML always requires this short-link path. Short links work as follows:
  1. Plannotator compresses the review payload.
  2. Your browser encrypts it with AES-256-GCM.
  3. The paste service stores only ciphertext.
  4. The decryption key stays in the URL fragment and is not sent to the service.
The default Plannotator paste service deletes entries after seven days. A self-run paste service can set its own retention period. Creating a short link is explicit. Plannotator does not upload the review until you select Create short link.

​
Use your own share services

Set PLANNOTATOR_SHARE_URL to the base URL of a compatible share portal. Set PLANNOTATOR_PASTE_URL to the base URL of a compatible paste API for encrypted short links and rendered HTML.
The Plannotator repository includes the share portal and paste service. Release assets include paste-service binaries for macOS, Linux, and Windows. See the repository’s apps/portal/SELF-HOSTING.md for the current portal deployment contract.

​
Disable sharing

Set the environment variable:
Or add this to ~/.plannotator/config.json:
The environment variable takes precedence. When sharing is disabled, Plannotator hides share and import actions. Last verified against Plannotator OSS v0.23.1 on July 18, 2026. Maintained by the Plannotator project.
Last modified on July 19, 2026