v0.2.3 · Linux desktop · runs offline

The AI-first personal notes app.

Notion-style blocks, Obsidian-style links, and a research agent that reads your own notes — on your Linux desktop, out of one JSON file you own. It never phones home: no account, no sync service, no signup wall.

x86_64 · free to use, pass along unmodified · omarchy pkg add slap-notes-bin

AI RESEARCH — RECORDED IN-APP
0
Accounts required
0
Sync services
1
Plain-JSON vault file
0.2.3
Version
The Cluster Brain

Type [[ and the graph writes itself.

Every wiki link you drop becomes an edge. Nothing to tag, curate, or maintain — the structure is a side effect of writing the way you already write. The thing drifting below is that graph, built from this app's own feature notes.

CLUSTER BRAIN — LIVE
14 notes · 22 links hover a node
  • Links are cheap. Two brackets and a note name. If the note doesn't exist yet, it will when you need it.
  • Backlinks come free. Every edge points both ways, so a note always knows who's citing it.
  • Clusters are the point. The shape of what you've been thinking about shows up before you've noticed it yourself.
  • Tags and search cut across the graph when you'd rather query than wander.
  • Daily notes give every day a node, so the graph has a spine to hang off.
  • Links survive export. [[wiki links]] stay intact in the Markdown you take with you.
Key feature · Research agent

An AI that reads your graph, on your key.

Optional, and off until you turn it on. It reads your link graph, answers questions about what you've written, and drafts notes back into the vault.

  • Bring your own API key. Anthropic, OpenAI, Google, Groq or OpenRouter — pasted into Settings, stored on your device.
  • Off by default. No key, no agent — the rest of the app doesn't care.
  • It drafts, you decide. Notes it writes are notes you can edit, keep, or bin.
  • No account with us. There is no us to have an account with.
  • No subscription for the AI. You pay your AI provider for what you use, directly.
  • Nothing leaves without the key. Turn the agent off and the app has nowhere to send anything.
What's in it

Blocks that behave.

A slash menu and markdown shortcuts as you type. Everything below ships in 0.2.3 today — no preview tier, no paid unlock.

Editor

Every block you'd reach for

Text, headings, lists, to-dos, quotes, callouts, code, tables, images, video. Type / for the menu or just write markdown and let it convert.

Linking

Wiki links

Type [[ to link a note. Each one becomes an edge in the Cluster Brain, and stays a real link when you export.

Navigation

Tags, search, outline

Tag notes, search the vault, and jump around a long note by its heading outline. Find & replace when it's a chore, not a hunt.

Routine

Daily notes & templates

One node per day, and templates for the notes you write the same way every time. Meeting, review, log — pick and go.

Chrome

A top bar that gets out of the way

Reach for the top edge and it slides in; move away and the window is all page. The native menu bar hides too — press Alt if you want it back.

Safety net

Trash, backups, rollback

Deleted notes go to trash, not the void. The vault keeps a workspace.prev.json rollback copy whenever it shrinks.

Your data

Plain JSON, plain Markdown, plain exit.

Notes live on your device and mirror to a readable JSON file. Nothing is encoded in a format only this app can open, and leaving takes one click from the toolbar.

Where it lives

PathWhat
~/.config/slap-notes/App data — your notes live here
workspace.jsonPlain-JSON copy of the whole vault
workspace.prev.jsonRollback copy, written when the vault shrinks

How you leave

ExportUse it for
This note (.md)One file
Vault (.zip)One .md per note with links intact, plus attachments and an all-notes.html — unzip straight into Obsidian, or paste into OneNote
Print / PDFArchiving and printouts
Backup (.json)Everything including media, restorable in-app
Install

On Omarchy, it's one command.

Slap Notes is in the official Omarchy package repo. Everywhere else on Linux x86_64 it's a portable tarball — extract it and run it, no installer, no daemon, no root. Free to use and to pass along unmodified — altered copies and resale aren't allowed; see the licence.

Omarchy — official package repo
$ omarchy pkg add slap-notes-bin
# updates arrive with omarchy update
Any Linux distro — tarball, 104 MB
$ tar --zstd -xf slap-notes-0.2.3-linux-x64.tar.zst
$ ./slap-notes-0.2.3/app/slap-notes
Verify before you run it
$ sha256sum -c SHA256SUMS
slap-notes-0.2.3-linux-x64.tar.zst: OK

sha256  56cb7606f41051ba10d088ed8e1ae85a17b20692f4b45c0c6a6e6cec6669a5e2
slap-notes-0.2.3-linux-x64.tar.zst

x86_64 · needs gtk3 nss alsa-lib libxss libnotify — which your desktop almost certainly already has. The Omarchy package pulls them in for you.