MARKDOWN WORKSPACE · DESKTOP & SELF-HOSTED

Manage your
knowledge.

Get started with Weave Explore the workspace

Notes, documentation
and the relationships between them.

Write Markdown, search across workspaces, render diagrams and track changes with Git. Use the native desktop app or host the same Rust engine for browser access from any device.

Local files · Open Knowledge Format · Built-in Git

Weave's real desktop interface: a Markdown article about a sales data mart, its typed relationship graph and a navigable workspace folder tree. — Actual Weave interface · Aurora Flow / Graphite · Bundled example knowledge base

PLAIN MARKDOWNTYPED RELATIONSHIPSRUST + SQLITEGIT BUILT INSELF-HOSTABLE

01 / WRITE, SEARCH AND EXPLORE

Document the detail.
Follow the dependencies.

Keep project notes, system documentation and
decisions together. Follow a link to see
what depends on what.

Typed relationships.

Label a link reads-from, depends-on or owned-by. Weave uses those relationships to build a directed graph around the article you’re reading.

The link remains standard Markdown. Read the same files in GitHub, VS Code or an AI agent’s context window.

Authoring format

AN ORDINARY LINK. A MEANINGFUL RELATIONSHIP.

Loads data into [Warehouse](./warehouse.md "writes-to").

PIPELINELoad pipeline

writes-to

DATA STOREData warehouse

Illustrative example · Relationships become directed, labelled graph edges.

Full-text search.

Find relevant passages across open workspaces with ranked search powered by embedded SQLite FTS5.

Multiple workspaces.

Keep personal notes, project docs and organisation knowledge open in one window, each in its own folder.

Mermaid rendering.

Write Mermaid code blocks and see diagrams rendered in place, with a live preview while editing. The Markdown file keeps the diagram source.

02 / SHARED RUST BACKEND

Desktop and browser.
The same Rust core.

High-performance indexing,
search, graph queries and Git.

The native desktop app and self-hosted server use the same Weave engine. Host a workspace once and work with the same set of notes from your laptop, phone or tablet.

You can also enable the desktop app’s built-in web server to access selected workspaces from other devices. Desktop and browser access then share the backend, database and file watcher.

Your Markdown foldersThe source of truth

SHARED ENGINEWeave Rust coreIndex · Search · Graph · Git

Native desktopWindows · Linux · ChromeOS via Linux

Self-hosted web interfaceLaptop · Phone · Tablet

Native desktop.

A Rust backend with the system WebView on Windows and Linux. Markdown stays in local folders you can use with other tools.

Desktop setup

Self-hosted server.

Run the dedicated headless server or Docker container. The browser interface reads and edits server-side notes, with built-in administrator authentication.

Self-hosting guide

Bounded interactive work.

Incremental indexing, pooled database readers and graph queries limited to the neighbourhood you’re viewing keep foreground operations focused.

Performance design & measurements

Browser access shares your hosted workspace. The current server uses one administrator identity; it does not provide separate per-user workspace permissions.

03 / VERSION CONTROL

Review changes.
Keep a history.

Manage your knowledge base as a Git repository, with source control built into the workspace.

Stage changes, inspect diffs and commit
Branch, stash and browse your history
Pull and push to multiple remotes
Resolve merge conflicts visually

Workspace & Git guide

⑂ mainarchitecture/decisions.md

# Warehouse refresh schedule − Refresh the warehouse every night.+ Refresh the warehouse every four hours.+ Owner: [Data platform](../teams/data.md) Runbook: ./warehouse-refresh.md

Update warehouse refresh scheduleIllustrative Git workflow

a31f8c2

Standard Markdown files in a normal Git repository.

04 / WEAVE LITE

An offline reader.
One HTML file.

Build Weave Lite from the same source as the desktop and server apps. The output, weave_lite.html, is a self-contained, read-only browser interface.

Open the file in a browser, choose a Markdown folder, then browse your notes with the reader, search and relationship graph. No Weave installation or running server is needed.

To share a snapshot instead, export a workspace from Weave as one HTML file with the articles included. Recipients can read and search it offline.

Lite & export guide

BUILD FROM THE WEAVE REPOSITORY · NODE.JS 24+

npm ci
npm run build

OUTPUTweave_lite.html

Open in browser → Choose Markdown folder

Read-only · No bundled articles · No server process

Build instructions

05 / APPEARANCE

Highly customizable UI.

Weave workspace with the Aurora Flow skin and Graphite colour scheme. — Aurora Flow · Graphite

06 / OPEN KNOWLEDGE FORMAT

The same notes.
For you and your agents.

Weave works with Open Knowledge Format (OKF), Google Cloud’s open, human- and agent-friendly knowledge specification: Markdown files in folders, with YAML frontmatter for structured metadata.

Types, descriptions and standard links give agents context they can read directly. Document systems, record decisions or maintain a reference library in the same files you browse and edit in Weave.

Existing Markdown folders work too; OKF frontmatter is optional in Weave.

Read Google Cloud’s OKF specification

GET STARTED

Open a workspace.

Use an existing Markdown folder or try the bundled example library.

ON YOUR COMPUTER

Desktop app.

Run the portable Windows app, or use the Linux packages on Linux and ChromeOS. Open a Markdown folder to begin.

Get Weave

Build and packaging instructions are included in the repository. For a read-only browser option, build Weave Lite.

ON YOUR INFRASTRUCTURE

Self-hosted access.

Clone the repository, then launch the server with Docker Compose.

docker compose up -d --build

Open localhost:8765 and create your administrator account. For remote access, follow the guide to configure HTTPS.