Skip to content

Feature · Share and export

Share a link.
Or export a file.

Share puts the current revision in a secret gist on your own GitHub, behind a bluedoc.ai link that opens view-only in any browser. Export saves it as one HTML file, a PDF or Markdown.

claude plugin marketplace add andreiverdes/bluedocclaude plugin install bluedoc@bluedoc

Inside a session the same commands are /plugin marketplace add andreiverdes/bluedoc and /plugin install bluedoc@bluedoc. Start a new session to load the skill.

Share a read-only link. Share puts the doc in a secret gist on your own GitHub and copies its bluedoc.ai link. When the agent writes a new revision the key reads Update, and one press updates the same link.

Export

One file, from any page.

Every page exports the revision you’re viewing. Decks and listings have their own key, Export to…; a design’s icon sheet saves every PNG size.

  • Export to HTML, PDF or Markdown

    ⋮ → Export saves the revision you’re viewing as one HTML file that works offline, a PDF, or Markdown.

  • Export the fastlane ZIP

    Export to… writes the fastlane ZIP, the same files in plain folders, a PDF or an HTML file. The key counts the files as it renders each PNG at its store size.

  • Export the PNG icon sets

    Export PNG sets renders every PNG size with Contents.json and the adaptive-icon XML, and saves them beside the doc.

From the terminal

Your agent can share and export too.

serve.py share puts the doc in its gist and prints the link; run again, it updates the same gist. A colleague’s agent copies it with serve.py import, and build.py -o writes the offline HTML file.

python3 <skill>/scripts/serve.py share docs/plans/saved-carts.bluedoc.json --answers picks,ticks,comments
python3 <skill>/scripts/serve.py import https://bluedoc.ai/g/<id>
python3 <skill>/scripts/build.py docs/plans/saved-carts.bluedoc.json -o saved-carts.html

A secret gist is unlisted and not searchable, but anyone with the link can read it: check the doc for secrets first. serve.py unshare deletes the gist.

Answer your agent
on a page.

Pick your agent. Each one installs the same skill from the GitHub repository.

claude plugin marketplace add andreiverdes/bluedocclaude plugin install bluedoc@bluedoc

Inside a session the same commands are /plugin marketplace add andreiverdes/bluedoc and /plugin install bluedoc@bluedoc. Start a new session to load the skill.

  • Python 3.9 or later on PATH
  • git, for code reviews
  • gh, only for GitHub review threads and Share