v0.3 — git sync + themes + Telescope  ·  What's new →

Notes that live
on your disk,
not our cloud.

devnote is the open-source, local-first Markdown notebook for developers. GFM editor, instant offline search, keyboard-first — with no subscription, ever.

~1–3ms search over 5k notes 100% offline-capable $0 — MIT licensed 165+ tests green
$ git clone https://github.com/shubhscode/devnote.git
DevNote
All Notes
Notebooks+
Engineering42
RFCs9
Personal31
Statuses
No status12
Active18
On hold4
Completed64
Dropped2
Tags
#rust21
#gtd8
#design5
Synced⟳
Preferences
Trash3
Search all notes…
All Notes · 128 notes · global
Sync engine design
per-file granularity, newer updatedAt wins…
Active#rust#sync
Telescope fuzzy ranking
score title ×3, tags ×2, recency boost…
#devnote
Ship checklist v0.3
- [x] themes · - [ ] notarization…
Completed#gtd
Engineering / RFCs
Sync engine design
Active ⌄#rust ×#sync ×+ tag
1
2
3
4
5
6
7
Each note is one `.md` file
with frontmatter in `~/devnote`.

## Conflict rule

Newer `updatedAt` wins;
loser → `.conflict-md`.
> themeesc
Commands
Toggle theme
↵ run↑↓ navigateesc back
● Why devnote

Everything you need.
Nothing phoning home.

Built for developers who live in Markdown and the keyboard. Local-first by construction — sync is an adapter, not a requirement.

⚡

Instant search, offline

Qualifier grammar (book: tag: status: title: body:, phrases, -exclusions) over 5k notes in ~1–3ms. Search reference →

🔭

Telescope fuzzy finder

⌘K jumps to commands, notebooks, tags, headings, themes. Prefixes > b t # h.

📝

Code-first GFM editor

CodeMirror 6 + sanitized preview, syntax highlight, copy-code buttons, slash menu, table assist, side-by-side & distraction-free.

🌿

Git sync — optional, yours

~/devnote is plain Markdown with frontmatter. Point at a private repo and sync: export → commit → pull → push. Newer updatedAt wins; losers preserved as .conflict-<device>.md. Airplane-mode fully usable. Setup in 3 steps →

~/devnote/engineering/sync-engine-a1b2c3d4.md
~/devnote/personal/reading-list-9f8e7d6c.md
~/devnote/.attachments/diagram.png
🕘

Revisions & templates

Auto-snapshots on idle + note-switch with undoable restore. 6 built-in templates with date/UUID placeholders on ⌘T.

🎨

7 themes, light + dark

Nord, Dracula, Solarized, Catppuccin + system-follow. Code colors ride the same variables in editor and preview.

⌨️

Keyboard-first

Every action is a core:* command with a remappable shortcut. Full map on the shortcuts page →

🔒

Private by default

No account, no telemetry, zero required network calls. SQLite is an index — Markdown files are the truth.

● Search

Find anything in milliseconds.

One query language across the whole library. Terms combine with AND; rank is title ×3, tags ×2, body ×1.

typescript tag:Work status:Completed
book:Engineering "conflict drill" -draft
title:deploy body:TODO tag:rust
Ranking

Pinned notes first, then score, then most recently updated. Matching lines shown as snippets; list renders 200 rows, virtualized beyond.

"exact phrase" matches verbatim. -term excludes. One honest limitation: no partial-match stemming — trin won't find string. Full grammar →

● Themes

Seven themes. Zero eye-strain.

Switch from Telescope (⌘K then h) or Preferences → Appearance. Light + dark from day one.

Darkdefault
Lightdefault
Norddark
Draculadark
Solarizeddark
Catppuccinmocha
● Compare

Cancel the subscription.

devnote exists so a ~$5/mo hosted-sync fee isn't the price of a good Markdown notebook.

devnoteInkdropNotionObsidian
Price$0 · MIT~$5/mofreemiumfreemium
Works fully offline✓✓limited✓
Notes as plain Markdown✓ ~/devnoteDB + exportblocks✓
Git sync, no vendor cloud✓hosted—paid/add-on
Qualifier search✓✓filtersplugins
Open source✓ MITproprietary——
● Get started

Running in under a minute.

macOS app
1
Download the .dmg from Releases, drag DevNote into /Applications.
2
First launch: right-click → Open (unsigned build), or xattr -cr /Applications/DevNote.app.
3
Notes land in ~/devnote. Optional: add a private repo in Preferences → Git sync. Full guide →
From source
git clone https://github.com/shubhscode/devnote.git
cd devnote
pnpm install
pnpm dev        # web on :5173
pnpm lint && pnpm test && pnpm build

Own your notes. Star the repo.

MIT-licensed, no telemetry, no lock-in. If local-first software should win, give it a ★.

GitHub stars GitHub forks MIT license latest release