Scrybe

MCP-native cross-platform Markdown editor.

The document is the conversation. Connect AI agents (Claude, Codex, Ollama, and more) as MCP peers. Scrybe is itself an MCP server, drivable by external agents.

Install

Python (PyPI)

pip install scrybe.ai          # full Python toolkit (library + CLI + MCP server + mermaid)

Or pick individual components:

pip install scrybe-py          # PyO3 library — exposes `import scrybe`
pip install scrybe-cli         # `scrybe` command-line tool
pip install scrybe-mcp-server  # standalone MCP server binary
pip install scrybe-mermaid     # PNG iTXt codec for embedded Mermaid sources

Rust (crates.io)

cargo install scrybe-cli scrybe-mcp-server

That gets you the same two binaries (scrybe, scrybe-mcp-server) the PyPI wheels carry. The supporting library crates — scrybe-core, scrybe-render, scrybe-mermaid, scrybe-rpc — are available for direct dependency in Rust projects:

[dependencies]
scrybe-core    = "0.1"
scrybe-render  = "0.1"
scrybe-mermaid = "0.1"

Crates.io has no metapackage equivalent of scrybe.ai; the bare name scrybe is held by an unrelated project. Install the binaries you want explicitly.

Desktop app

The desktop app (Tauri 2 — macOS / Windows / Linux) ships via GitHub Releases, not PyPI or crates.io.

macOS (coming soon): brew install scrybe — see issue #1
Windows (coming soon): choco install scrybe — see issue #2

Quick start

scrybe file.md          # open a file in the GUI
scrybe ./               # open a directory
scrybe                  # open the welcome screen

# Connect to Claude Code as an MCP server
claude mcp add scrybe -- scrybe-mcp-server stdio

MCP tools: open · read · section · edit · find · render · embed · extract · lint · logs · close_tab · quit

Development

git clone https://github.com/hartsock/scrybe
cd scrybe
just build          # all crates
just dev            # Tauri dev server (requires Node)
just install        # build + install to ~/Applications and ~/venv/bin
just check          # full lint + test suite

Architecture

Python on the outside, Rust on the inside.

Crate	Role
scrybe-core	AST, Document, ContentAddressable (BLAKE3+CBOR), Plugin trait, Workspace
scrybe-render	HTML pipeline, syntect syntax highlighting, KaTeX/Mermaid
scrybe-mcp-server	Inbound MCP — 12 tools for agent document editing
scrybe-mcp-client	Outbound MCP — registers external agent servers
scrybe-mermaid	Standalone PNG iTXt codec (Mermaid source in PNG metadata)
scrybe-rpc	JSON-RPC 2.0 wire protocol — CLI ↔ GUI over Unix socket
scrybe-vcs	git2 multi-remote VCS wrapper
scrybe-py	Python library — import scrybe for plugins and tooling
scrybe-cli	Headless CLI binary (maturin wheel)
scrybe-app	Tauri 2 desktop app (Rust + TypeScript + CodeMirror 6)

Published packages

PyPI

Package	Install	What
scrybe.ai	pip install scrybe.ai	Metapackage — pulls in the four wheels below
scrybe-py	pip install scrybe-py	PyO3 library — import scrybe
scrybe-cli	pip install scrybe-cli	scrybe CLI binary
scrybe-mcp-server	pip install scrybe-mcp-server	scrybe-mcp-server binary
scrybe-mermaid	pip install scrybe-mermaid	PNG iTXt codec

crates.io

Crate	Install / depend	What
scrybe-cli	cargo install scrybe-cli	scrybe CLI binary
scrybe-mcp-server	cargo install scrybe-mcp-server	scrybe-mcp-server binary
scrybe-core	dep	AST, Document, ContentAddressable, Plugin trait
scrybe-render	dep	Markdown→HTML pipeline (syntect / KaTeX / Mermaid)
scrybe-mermaid	dep	PNG iTXt codec
scrybe-rpc	dep	CLI ↔ GUI JSON-RPC 2.0 wire types

License

Apache-2.0. See LICENSE.

Free and open source — Apache-2.0 licensed. Use it, build on it, ship it.