Your notes. Your agents' memory. One encrypted place.

Plain-markdown notes that you and your AI agents share — synced end-to-end encrypted, searchable on-device, editable everywhere with live-preview markdown. Agents get their own keys: scoped, attributed, revocable.

Open the app → Install the CLI
This server stores ciphertext only. Your 12-word recovery phrase is your whole identity — keys are derived in your browser or on your devices, never here. There is no password reset, because there is nothing here to reset.
Door 1 · For you

Start in the browser, own it as files

  1. Open the app → Create an account → write down your 12 words. Start typing — formatting appears as you write, and the ⋯ menu has a markdown cheatsheet.
  2. On your phone: same URL → Share → Add to Home Screen. Everything syncs.
  3. On your computer, your notes become a plain folder of markdown — Obsidian-compatible, greppable, yours:
npm install -g vortex-notes
vortex-notes setup                   # asks your 12 words — that's the whole setup
vortex-notes search "that idea"      # semantic search, fully local, any language

Your notes appear as a plain folder of markdown (~/VortexNotes) and stay in sync. Power users: the identity, sync, and space subcommands do each step individually, including pointing at a self-hosted relay.

Door 2 · For your agents

Agents are principals, not passengers

An agent gets its own key — generated on its machine, never transmitted — certified by yours, scoped to the spaces you grant, read-only if you say so. Every edit it makes is signed as the agent. Revoking takes one tap.

Connect any agent machine — one command, nothing to configure

npx vortex-notes pair
install, cross-lingual search, pair an agent
agent machineshows KM3PXR → your phone⋯ menu → Pair an agent
approve · read-only optional → doneagent syncs — scoped & signed

The code is single-use and expires in 15 minutes. When pairing completes, the command wires up every harness it finds on that machine:

Claude Code MCP · pairing

npx vortex-notes pair adds it for every project once you approve — restart any open session.

Hermes MCP · pairing

Same command on the Hermes machine (SSH is fine — you approve from your phone), then type /reload-mcp in your Hermes chat.

OpenCode MCP · pairing

Same command — it adds the server to ~/.config/opencode/opencode.json. Restart OpenCode.

OpenClaw skill · files

OpenClaw is filesystem-native: sync a vault on its machine (pair it, or use your own account) and install the vortex-notes skill so it knows the conventions — daily notes, facts with supersession, search-first.

Cursor · Claude Desktop · any MCP client MCP

Pair first, then point the client at the vault path pair printed:

{ "command": "npx", "args": ["-y", "vortex-notes", "mcp"], "env": { "VORTEX_NOTES_VAULT": "/path/from/pair" } }

Everything else plain files

The vault is a folder of markdown. Any tool that reads files already works, and vortex-notes search gives it local semantic search. Add --read-only to any MCP command for search-and-read-only access.

Agent tools: search_notes · read_note · write_note · edit_note · append_daily · remember (facts that supersede, never delete) · build_context · recent_activity. Revoke any agent: vortex-notes agent revoke <name>.

Door 3 · Self-host

Don't trust us — run your own

vortex-notes relay --port 7300 --db ~/relay.db

That's the entire server: it serves this page, the app, and an append-only log of encrypted blobs it cannot read. Point every command above at it with --relay. MIT licensed.