Craft

Smooth writing is the baseline

Open and write; arrange as you think. The tool is fast enough to be forgotten, and only then does the thinking take the stage.

Weekly Meeting Notes.md

Pinyin abbreviations work too

Slash commands

A slash plus pinyin shorthand, /dzbg drops in a table

Block drag & collapse

Drag the handle to move a whole block; fold long passages into a corner

Floating toolbar

Appears when you select, disappears when you release

Multi-level numbering & TOC

Headings auto-number; the outline updates as you write

Mermaid · PlantUML

Turn fenced code into a diagram in one click

Code highlighting

Dozens of languages, code without leaving the editor

Spreadsheet

Insert a table and compute right in the document

Drag-and-drop images

Drop to upload, drag handles to resize

flow.md

flowchart LR
  Idea --> Write
  Write --> Publish
  Publish -.-> Idea

Live Knowledge Base

Changes sync in milliseconds

When an Agent edits a block, the page you have open changes instantly — no export, no re-indexing, no waiting.

PATCH /blocks/:id

An Agent changes a block

Yjs CRDT · Hocuspocus

Persisted and broadcast at the same time

Editor paragraph refreshes

Every open peer updates together

Millisecond-level

Ⅰ

Block-level updates

Only the block that changed is touched — no whole-document overwrites, no interrupting the sentence you're writing.

Ⅱ

Write and broadcast

Persisted and broadcast via CRDT at once; every open peer updates together.

Ⅲ

Always current

No export-and-reupload, no window spent waiting for the index to rebuild.

Co-editing

Two pens at once,
no one overwrites

You type the second half while the Agent finishes the paragraph above — one sheet of paper, and nobody overwrites anyone.

An Agent sends a PATCH → the paragraph updates live in the editor

Ⅰ

Local-first

Changes land locally first — keep writing offline, open and go.

Ⅱ

Incremental sync

Only Yjs deltas are exchanged once online — landing in tens of milliseconds.

Ⅲ

Automatic merge

CRDT resolves conflicts at the core; history is never lost.

Release Plan.md — Version History

POST /versions/:seq/rollback

You can let it rewrite freely, because you can always pull it back.

Also Inside

And more

Not covered above, but used every day.

01

Knowledge base management

Three tiers — knowledge bases, folders, documents — ready when you are

02

Full-text search

Finds documents, and pinpoints the exact block

03

WeChat article export

Generate inline styles in one click, paste into WeChat without losing formatting

Import

MarkdownDrag .md straight in
Word.docx keeps its layout
PDFExtract text into a draft

Export

MarkdownReal-time export of a single document
ZIPBundle a whole knowledge base or folder
HTMLInline styles, ready to paste

Open & Owned

Your library is yours,
and the key too

Local-first storage — the server is only for sync and backup
Export any document to Markdown, or the whole library as ZIP — take it with you anytime
Interfaces and formats are fully open — no walls, only doors

Technical details: protocol, channels & concurrency

Doco product interface: the knowledge base tree on the left, and on the right a document with a task list and a flow diagram from inspiration to publish — The real interface · documents, knowledge bases & open capabilities

Three-minute setup

Give your Agent
a key

No SDK and no integration project. Authorize in the browser, add one MCP command, then ask your Agent to show its work.

01

Authorize

Run the CLI. Doco opens a browser confirmation page; approve only the scopes this Agent needs.

npx -y --package doco-agent-cli doco login

02

Connect

Register the stdio MCP server. Claude Code discovers the tools and their safe-write contract immediately.

claude mcp add doco -- npx -y --package doco-agent-cli doco mcp

03

Verify

Start read-only: ask the Agent to list your knowledge bases, open one, and cite the exact block it read.

List my Doco knowledge bases, then open the one I choose.

Read the integration guide

Also works withCodex · Gemini CLI · VS Code Copilot

FAQ

Before you hand over
the second pen

The short answers, including the boundaries we do not hide.

01Can an Agent overwrite my work?

Protected writes require the version read by the Agent. If the document changed, Doco returns a 409 conflict and the Agent must re-read. This prevents silent overwrites; it does not pretend to resolve every semantic disagreement automatically.

02Can I bring an existing Markdown vault?

Yes. Import Markdown directly and export one document or a complete knowledge base as Markdown. Anchored Markdown round-trips preserve stable block identity where the format can represent it, and conversion warnings disclose lossy details.

03Which Agents can connect?

Claude Code and Cursor can use the bundled MCP server. Codex, Gemini CLI, VS Code Copilot, scripts, and custom applications can use the same stdio MCP package, CLI, or REST API.

04Hosted or self-hosted?

Both. The hosted beta is the fastest way to start. Doco is MIT licensed and the Node.js, Hocuspocus, and SQLite stack can be self-hosted; exports keep your knowledge portable.

05Is search semantic or RAG?

Doco currently provides structured full-text search with block evidence, source and index versions, and completeness signals. It does not market that as omniscient semantic search.

06What does the beta cost?

The hosted beta is free and does not require a credit card. Usage is quota-controlled while the product is being validated; paid plans will be introduced only after the usage model is proven.

One sheet of paper,two pens.