Local-first.

你的笔记 = 普通 .md 文件夹

1/5

scroll

Why a swarm?

Think of your devices as a swarm of bees: each device is a bee, the workspace is the hive, and notes flow like nectar between them.

Devices = bees

Your laptop, phone, and desktop are members of the swarm

Workspace = hive

Shared territory across every device

Notes = nectar

Flowing peer-to-peer, never through a central server

Why SwarmNote

Local-first

Notes are plain .md files. Uninstall the app — your notes stay.

P2P sync

libp2p connects devices directly. No server. No subscription.

CRDT auto-merge

Cross-platform

Windows · macOS · Linux · Android · iOS

Same core. Two surfaces.

One Rust core, desktop and mobile

Tauri desktop and Expo mobile share the same swarmnote-core Rust crate — same business logic, same CRDT state, same P2P stack.

Desktop

Tauri 2 + React 19

invoke('cmd', args)

Core

swarmnote-core

Rust crate

· CRDT (yrs)
· libp2p networking
· yrs-blocknote bridge

Mobile

Expo + React Native

uniffi.call() (JSI)

@swarmnote/editor git submodule is imported on both sides — CodeMirror 6 editing experience is identical

Onboarding

Join with a 6-digit pairing code

Generate a 6-digit code on one device, type it on another. Works across networks. No cloud relay.

Open "Add device" on your primary
A 6-digit code appears
Type the code on the new device
The swarm grows; notes sync automatically

Devices on the same Wi-Fi are auto-discovered via mDNS (in development)

Local-first, file-truth

Your notes stay yours

A workspace is just a local folder. Open .md files in VS Code, Obsidian, or nvim. SwarmNote watches and merges your edits back into Yjs — no history loss, no conflicts.

Drop the workspace into Dropbox, OneDrive, or Git for additional backup

~/Documents/my-workspace

$ tree my-workspace --dirs-first -L 2

my-workspace/
.swarmnote/
workspace.db
ideas/
p2p-future.md markdown
swarm-economics.md markdown
journal/
2026-04-30.md markdown
README.md markdown

$ cat ideas/p2p-future.md

# P2P 的未来

笔记躺在我自己的硬盘里，
通过 libp2p 在我的设备之间直接同步——
没有服务器，没有账号，没有订阅。

VS Code Obsidian nvim Git Dropbox iCloud

Why SwarmNote, not the others

Why pick SwarmNote

Only SwarmNote ships local Markdown + built-in P2P + character-level CRDT merge + fully open source (MIT)

Dimension	Obsidian	Notion	Logseq	SwarmNote
Storage	Local Markdown	Cloud DB	Local Markdown	Local Markdown
Multi-device sync	Paid Sync	Built-in (cloud)	Git / 3rd-party cloud	Built-in P2P
Server dependency	Required for sync	Required	Required for sync	None
Offline collaboration merging	Not supported	Not supported	File-level conflicts	CRDT auto-merge
External tool support	Compatible	Incompatible	Compatible	Compatible (with auto reflow)
Open source	No	No	Yes	Yes (MIT)