Skip to content

Plan, document, design and more.
A visual reply to your verbose agent.

claude plugin marketplace add andreiverdes/bluedocclaude plugin install bluedoc@bluedoc
“Let shoppers save a cart and come back to it later.”

bluedoc turns what your agent writes into pages: plans, docs, reviews, designs and decks. You answer on the page; it reads every answer.

Inside your agent.

Ask for a doc the way you always do. Pick a type and see the page it opens.

“Map the Acme order path as a doc I can zoom into.”

Installs as a plugin in Claude Code, Codex, pi, omp, Copilot CLI, Antigravity CLI.

Install once.
Then answer on a page.

  1. Install once.

    One command adds the skill to your agent. It needs Python 3.9 or later and nothing to host.

  2. Ask in plain words.

    Ask for a plan, a review, a design or a deck, as you would anyway. It opens as a page on the local server.

  3. Answer on the page.

    Pin a comment on a part, pick an answer, approve. The agent reads every answer and revises.

Plan mode too. The plan-mode hook opens the plan as a page, and the agent waits for Approve before it writes code. Settings turns it off.

One JSON file per doc. The server renders the page from it on every request, so an edit and a reload is the whole build.

A chat asks you to reply in prose.

Agents answer in walls of text and wait for a reply in prose. A bluedoc page asks you the questions and keeps your answers.

  • A chat reply

    Prose in, prose out
    What you doIn a chat
    Point at one partQuote it back in prose
    Choose between optionsType “go with option 2”
    See what changedReread the whole reply
    Sign offSay “looks good”
    Keep your answersScrolled away in the transcript
    Pass it onPaste the reply into a message
  • A bluedoc page

    Point, pick, approve
    What you doOn a bluedoc page
    Point at one partPin a comment on it
    Choose between optionsPick an answer; the recommendation is starred
    See what changedCompare two revisions, word by word
    Sign offApprove the current revision
    Keep your answersKept in ~/.bluedoc/state.db
    Pass it onShare a view-only bluedoc.ai link
Doc types
8
Docs, plans, reviews, designs, decks, sites, store listings and more.
Agent plugins
6
Claude Code, Codex, pi, omp, Copilot CLI, Antigravity CLI. Any other through the skills CLI.
JSON file per doc
1
The server renders the page from it; no HTML to keep in sync.
Accounts
0
No bluedoc account and no hosted service: it runs on 127.0.0.1, MIT.

Counted from the lists on this site, so they stay true when a type or an agent is added. Agent plugins: Claude Code, Codex, pi, omp, Copilot CLI, Antigravity CLI; any other agent installs through the skills CLI.

Built for answering, not just reading.

Three things you do on every page, and two you never have to think about.

  • Comments that become conversations

    Pin a comment on an element, box a region, select a passage or draw with the pen, and attach a file when words aren’t enough. Each comment is a thread the agent replies in, its replies signed with its model’s name.

  • One answer card per question

    Each answer explains itself in a line, and More details opens the agent’s reasoning. Pick one, or several where a question allows, write your own under Other, or ask it to Tell me more. Each list’s Accept recommended takes every starred answer.

  • Revisions you can compare

    Every build is a revision. Changes from N, on each row of the Revisions panel, marks new, changed and removed parts in place, word by word.

    All about revisions
  • Local

    Your input stays on your machine

    Ticks, picks and comments live in a local SQLite file the server owns, never in the repo. Screens run sandboxed, with no network. A doc leaves only when you press Share.

    Address
    127.0.0.1
    Your answers
    state.db
    Leaves on
    Share
  • Approved · rev 1

    Approve, and the agent proceeds

    Plans, designs and websites wait for approval on the current revision. Approve and Request changes open one send dialog: what goes, a note, then the send key.

    Waits for
    Approve
    Sends back
    Request changes
    Each build
    a revision

See every feature

Questions, answered.

Yes. bluedoc is open source under the MIT licence. There is no account, no subscription and no hosted service.

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