Riffle

Local-first notes for people who write.

Note

Riffle is Celados' independent Octane/Electron continuation of starc007/markd. Electron is the only desktop runtime and release path.

Riffle is a fast notes app for macOS, built for people who care about speed, privacy, and ownership.

No accounts. No cloud. No sync (for now).

Your notes live on your disk as plain .md files. Riffle simply makes writing and finding them fast.

---

Installing on macOS

Download the latest .dmg from the Celados Riffle releases and drag Riffle to Applications.

Riffle releases are Developer ID signed and notarized by Apple before distribution.

---

Features

• Rendered Markdown and source editing: read a focused CommonMark/GFM view, then edit the same file directly in CodeMirror
• Folders and subfolders: organize notes in real, file-manager-visible folders
• Todos: a standalone task list with tags and filtering
• Bookmarks: save links with an auto-fetched title, image, and favicon
• Command palette: press Ctrl/Cmd+K to jump to any note, folder, or page instantly
• Instant search: title and content, ranked in milliseconds
• Monochrome UI: light, dark, or system theme with no color noise
• Portable vault: plain files, no IDs, no required metadata, no lock-in

---

Vault model

Pick any folder on disk as your vault:

<vault>/
├── Note.md         plain .md files, filename is the title
├── projects/       real folders containing more notes
└── .markd/         app data: todos, bookmarks, tags, pasted images

Notes are addressed by path, never by ID. Deletes go to the OS trash. Edit notes externally with vim, VS Code, or another editor. Riffle picks up changes through its live Vault Index.

---

Getting started

Requirements: pnpm and macOS.

First render the private @celados registry authentication described in NOTARIZATION.md; a clean checkout cannot install without it.

pnpm install
pnpm run dev

Build, inspect, and smoke-test an unsigned local Electron package:

pnpm run package:test

Maintainers can follow NOTARIZATION.md to configure Developer ID signing and Apple notarization for releases.

See AGENTS.md for architecture details, or CONTRIBUTING.md to send a PR.

---

Data & Privacy

• Notes are stored locally as user-owned files
• No analytics, tracking, accounts, or note-content uploads
• Packaged builds check the Celados GitHub Releases channel for application updates
• Saving a bookmark fetches that page's title, preview image, and favicon
• Export your notes anytime because they are already just files

---

Status

This fork is under active development. Its Octane/Electron application passes type, logic, production-build, system-Chrome journey, Electron, and packaged native-payload gates.

Sync, encryption, and publishing may be added later without compromising local-first performance.

License

MIT

---

Riffle Write at the speed of thought.