Doco

/plugin marketplace add songofhawk/doco /plugin install doco@doco

The marketplace bundles the Doco MCP server and the safe read → version → protected-write operating protocol. Tokens remain in Claude Code's local configuration and are never included in the plugin repository.

- Rich text editing: headings, lists, blockquotes, task lists, code blocks (syntax highlighting), tables, images, links, text styling, and more
- /slash command: type/to open the command palette with fuzzy search — supports pinyin abbreviations for Chinese users
- Floating toolbar: auto-appears on text selection, all formatting actions within two centimeters of your cursor
- Block drag-and-drop: hover the left edge of any paragraph to reveal a drag handle — reorder content like building blocks
- Collapsible sections: fold away sections you're not working on; collapse state persists across sessions
- Auto heading numbering: one-click toggle — H1–H4 headings automatically maintain hierarchical numbering (1.1.11.1.1)
- Keyboard shortcuts:⌥↑/↓move blocks,⌘Dduplicate blocks,⌘⌥1/2/3/0switch heading levels

Write Mermaid or PlantUML source code directly in your document. Diagrams render in place. Double-click to edit, fullscreen view, pinch-to-zoom — no more export-import-replace cycles with draw.io.

- Mermaid: flowcharts, sequence diagrams, class diagrams, Gantt charts, state diagrams, and more
- PlantUML: sequence diagrams, class diagrams, use case diagrams, component diagrams, and more

A full spreadsheet engine embedded in your documents:

- Formula evaluation, cell formatting
- Freeze panes, sort & filter
- Cell merge / split
- CSV import / export

Use it inline as a content block, or pop it out as a standalone full-screen spreadsheet.

- Knowledge Base → Folders (nestable) → Documents — a three-level structure
- Drag-and-drop reordering, renaming, and moving in the sidebar
- Whole-KB ZIP export preserving folder hierarchy, with bundled images
- Lossless native.doco.ziptransfer for a document, folder, or whole knowledge base

- No save button — changes sync automatically
- Offline-first: browser IndexedDB is the primary store; the server holds a snapshot. Edit without a network, merge automatically when reconnected
- Seamless device switching: close your laptop, pick up your phone, keep writing

- REST API: OpenAPI 3.1 spec, Bearer Token auth, ETag versioning, cursor pagination, idempotency keys
- MCP server:doco mcp(ships insidedoco-agent-cli) — 29 tools plusdoco://resources
- doco CLI:login / whoami / docs / blocks / edit / mcp, global--json, writes internalize ETag/If-Match

Turn your docs into programmable assets — script your own backups, let an agent organize your knowledge base, pipe docs from your publishing workflow to your blog. Built-in API documentation page, ready to use out of the box.

# Install frontend dependencies pnpm install # Install backend dependencies cd backend && npm install && cd .. # Start the frontend dev server (Vite, default :5173) pnpm run dev # In another terminal, start the backend (Express + WebSocket, default :8000) cd backend npm run dev

Openhttp://localhost:5173— it will auto-connect to the backend WebSocket service.

The complete self-hosted package includes a Caddy frontend, Node.js collaboration backend, persistent SQLite storage, health checks, and a same-origin WebSocket proxy. The public images support bothlinux/amd64andlinux/arm64.

git clone https://github.com/songofhawk/doco.git cd doco cp .env.docker.example .env.docker # Review .env.docker first, then start with prebuilt Docker Hub images docker compose --env-file .env.docker up -d # Verify the deployment docker compose --env-file .env.docker ps curl --fail http://localhost:8080/healthz

To build the same images from source instead:

docker compose --env-file .env.docker up -d --build

# Frontend build pnpm run build # output → dist/ pnpm run deploy # deploy to Cloudflare Pages # Backend (production) cd backend npm start

doco/ ├── src/ │ ├── main.tsx # App entry point │ ├── App.tsx # Root component, routing, import/export │ ├── components/ │ │ └── Sidebar.tsx # KB sidebar (document tree) │ └── editor/ # Editor module │ ├── index.ts # Entry, exports DocoEditor component │ ├── DocoEditor.tsx # Editor core (Yjs/Hocuspocus init, extension registration) │ ├── types.ts # DocoEditor Props/Ref type definitions │ └── components/ │ ├── BubbleMenu.tsx # Selection floating toolbar │ ├── BlockHandle.tsx # Block drag handle │ ├── SlashCommand.ts # / command palette │ ├── CommandList.tsx # Command palette UI │ ├── suggestions.ts # Command menu data │ ├── CollapseExtension.ts # Block collapse extension │ ├── DocSettings.tsx # Document settings (heading numbering, background) │ ├── MermaidBlock.ts # Mermaid node definition │ ├── MermaidComponent.tsx # Mermaid renderer │ ├── PlantUMLBlock.ts # PlantUML node definition │ ├── PlantUMLComponent.tsx # PlantUML renderer │ ├── CalloutBlock.ts # Callout block definition │ ├── CalloutComponent.tsx # Callout renderer │ ├── SpreadsheetBlock.ts # Spreadsheet node definition │ ├── SpreadsheetComponent.tsx # Spreadsheet renderer │ ├── spreadsheetEngine.ts # Spreadsheet calculation engine │ ├── WeChatExportDialog.tsx # WeChat Official Account export │ ├── KeyboardShortcuts.ts # Keyboard shortcuts │ ├── TableOfContents.tsx # Table of contents │ ├── CodeBlockComponent.tsx # Code block (highlight + copy) │ └── ImageComponent.tsx # Image renderer ├── backend/ │ ├── server.js # Entry: Express + Hocuspocus + export routes │ ├── database.js # better-sqlite3 init & schema │ ├── api.js # KB / folder / document REST API │ ├── auth.js # Auth (OAuth + Email + API Token) │ ├── markdown.js # YDoc → Markdown server-side export │ ├── permissions.js # Permission management │ ├── quota.js # Quota management │ ├── openapi.js # OpenAPI spec definition │ └── tests/ # Backend tests └── docs/ # Design docs & proposals

import { useRef } from 'react' import { DocoTextEditor, type DocoTextEditorRef, } from 'doco-text-editor' import 'doco-text-editor/style.css' const editorRef = useRef<DocoTextEditorRef>(null) <DocoTextEditor ref={editorRef} defaultValue="# Browser-only draft" format="markdown" onChange={({ steps }) => { // Only the ProseMirror steps changed by this transaction. queueIncrementalChanges(steps) }} /> // Read the complete document only when needed. const json = editorRef.current?.getContent('tiptap-json') const markdown = editorRef.current?.getContent('markdown') const html = editorRef.current?.getContent('html') const text = editorRef.current?.getContent('text')

import { DocoEditor } from './editor' import type { DocoEditorRef } from './editor/types' const editorRef = useRef<DocoEditorRef>(null) <DocoEditor ref={editorRef} docId="doc-001" userId="user-001" collaboration={{ websocketUrl: 'ws://localhost:8000', }} onTitleChange={(docId, title) => console.log('Title changed:', title)} placeholder="Start writing…" /> {/ Call export methods via ref /} <button onClick={() => editorRef.current?.exportMarkdown()}>Export MD</button>

Browser IndexedDB (y-indexeddb) ← local primary store ↕ Browser Y.Doc ← @hocuspocus/provider (WebSocket) ↕ Yjs binary delta messages Server @hocuspocus/server → SQLite ydoc_state (one merged snapshot per doc)

- The browser IndexedDB is the primary store; the server snapshot is auxiliary. If the server snapshot is lost, simply open the document in the browser to repopulate it.
- Offline editing works seamlessly; changes sync automatically when the network returns.
- Collaborative cursors: supported by the framework, not enabled by default.

Both single documents and KB bundles support Markdown export, generated on-the-fly from YDoc on the server:

# Single document export curl http://localhost:8000/api/docs/{id}/export.md # KB ZIP bundle curl http://localhost:8000/api/kb/{id}/export.zip

Custom nodes (Mermaid, PlantUML, Callout, etc.) have corresponding serialization rules inbackend/markdown.js. When adding new custom nodes, update the server-side serializer accordingly.

UseExport Doco Filein a document, folder, or knowledge-base menu. The resulting.doco.zipcontains the original Yjs state, hierarchy, document settings, standalone spreadsheets, and attachments. Importing always creates a copy with fresh resource and attachment IDs, so it can safely move between independent Doco deployments without colliding with existing data.

Use the upload button beside the knowledge-base heading to import a whole knowledge base. To import a document or folder package, chooseImport Doco Filefrom the destination knowledge base or folder menu.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Rememberizer MCP Server for Common Knowledge

Access personal and team knowledge repositories, including documents and Slack discussions.

Create and read feature flags, review experiments, generate flag types, search docs, and interact with GrowthBook's feature flagging and experimentation platform.

Search Apple's Developer Documentation with smart search and wildcard support.

Search, compare, and get docs for 210+ APIs ranked by CLI and agent relevance

Query Rust crates from crates.io and docs.rs. Search for crates, get info, versions, dependencies, and documentation.

Apple Documentation MCP Server - Search Apple docs, Swift Evolution, and sample code

Optimize any site for AI search: get DeepRank methodology, optimization steps, and suggestions (llms.txt, JSON-LD, audit checklist) so your AI assistant can implement AI visibility in the repo.

Search the Modellix knowledge base to quickly find relevant technical information, code examples, and API references. Retrieve implementation details and official guides to solve development queries efficiently. Access direct links to documentation for deeper context on specific features and tools.

Team knowledge base for code snippets, API calls and docs. Agents search and file items over MCP; humans review what becomes canon.