Local-first notes · CLI · MCP · sync

Your notes are files. Everything else is optional.

Nota is a fast Markdown notes app that leaves every note as a plain file in a folder you choose. Search, links and properties are an index you can delete and rebuild. Sync only when you want it, to a server you run.

macOS and Linux · the web app is invite-only while v1 is being built

The Nota desktop app: a folder tree on the left, a note with its properties in the middle.
The tree, the note, its properties — one window, no tabs.

Three ways in

One vault, reached three ways.

The app

A macOS and Linux app on the system webview: a few megabytes, no bundled browser, nothing running when you are not looking. The folder tree, the live-preview editor, the ⌘K palette and inbox triage are part of v1.

The terminal

Every feature exists as a command before it exists as a button, and every command takes --json.

nota add "Ringa Tele2" --tag hem
nota search "möte anna"
nota ls --where status=draft
nota sync --status

Your agents

nota mcp speaks Model Context Protocol over stdio; nota serve answers the same tools over HTTP. Claude Code, Hermes or a script get search, read, append and frontmatter edits against the same files you edit by hand.

What that buys you

Nothing is locked in, including the metadata.

Plain Markdown in real folders

Edit a note in vim, Obsidian, git or a hook. Nota notices, re-indexes it, and the app shows the change. Delete the index whenever you like.

Frontmatter is the metadata

Tags, status and your own fields live in YAML at the top of the file, Obsidian compatible. Unknown keys survive every edit, byte for byte.

---
tags: [nota, sync]
status: draft
created: 2026-11-18T10:12:00+01:00
---

Search that is only an index

SQLite with FTS5 gives full-text search, tag filters, property queries and backlinks. Ten thousand notes re-index in about a second; a search answers in under 20 ms.

Sync that merges instead of overwriting

File-level sync with a three-way merge. A pull by cursor, an SSE nudge, tombstones for deletes, and a conflict copy when both sides changed the same lines — never a silent loss.

A server small enough to understand

One Go binary, one SQLite database, content-addressed blobs in one directory. Health checks, predictable memory, no cgo.

No account until you sync

The app and the CLI work offline forever with no login. Sign in only to sync — with a passkey, never a password — and revoke any device from the list.

The interface

Quiet by design.

Inbox triage in Nota: unsorted notes with one-click move suggestions.
Inbox triage. Quick capture lands in one place; rules suggest where each note belongs.
The command palette over a note, searching notes and commands.
⌘K for everything. Search, create, move and run commands without leaving the keyboard.
Nota's settings: the vault, sync with a passkey account, and the device list.
Settings, not a control panel. The vault, sync with a passkey, and the devices you can revoke.

Install

Small app, small install.

macOS

A signed DMG for Apple silicon and Intel, opening on an empty note with no setup.

Linux

AppImage and .deb, on WebKitGTK. Same Go core, same vault format.

Today

Build both from the source you have. The CLI is one command:

go build ./cmd/nota
cd apps/desktop && bunx mygo build

Homebrew

The tap ships with v1. The formula installs the CLI and the app together.

brew install banjo/tap/nota

Downloads appear here when v1 is tagged. Until then the web app and the source tree are the way in.

Sync

A server you run, or none at all.

nota serve is a single Go binary with all its state in one directory: the SQLite database, the blobs, and a working copy of each vault that the web app reads. Put it behind any TLS proxy, point the apps at it, and sync.

  • Passkey accounts, invite-only by default; recovery codes, no passwords
  • Device tokens per app and CLI, revocable from Settings
  • HTTP MCP at /mcp so agents can work on a synced vault
  • Health checks, graceful shutdown, no cgo
docker build -t nota .

docker run -d --name nota \
  -p 8080:8080 \
  -v nota-data:/data \
  -e NOTA_SERVER_PUBLIC_URL=https://nota.example.com \
  -e NOTA_SERVER_WEB_ORIGIN=https://nota.example.com \
  -e NOTA_SERVER_RP_ID=nota.example.com \
  -e NOTA_SERVER_COOKIE_DOMAIN=example.com \
  nota

docker exec nota nota serve invite create

The invite prints a sign-up link for the web app; follow it to register a passkey.

Try it on your own notes.

The web app runs on the same vault your desktop app syncs. Sign up with a passkey, or ask for an invite.