Skip to content
Projects

melo-libs/melo has 35 GitHub stars and 0 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 16:57 UTC. Last push 2026-11-13.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

A local-first Markdown workspace with an AI companion. Write, clip, search, and organize files you own.

Productivity

README.md

Original

Melo

Turn information into knowledge of your own.

Melo is a personal knowledge workspace built around CODE: Collect, Organize, Distill, and Express. Your notes are plain .md files in a folder you choose, edited in a true WYSIWYG editor. No account, no lock-in — point it at an existing notes folder and everything just works. (Search runs on a small rebuildable index in .melo/; your notes never live inside it.)

Get Melo

Download a macOS build for your Mac (Apple silicon or Intel) from GitHub Releases. Choose a folder as your workspace, or open an individual Markdown file; Melo keeps your notes in their original location.

The latest published release may be older than the features described here. Check the release notes for the version you download. Unsigned macOS builds may require approval in Privacy & Security before opening; they can check for updates, but new versions must be installed manually from GitHub Releases.

What it does

Write

  • WYSIWYG Markdown editing (Tiptap/ProseMirror) — headings, lists, task lists, quotes, tables
  • Syntax-highlighted code blocks with a language picker, line numbers and smart indentation
  • LaTeX math (inline $…$ and block $$…$$, rendered with KaTeX) with a guided equation editor
  • Slash commands (/), block drag handles, find & replace (⌘F / ⌥⌘F)
  • Wikilinks ([[…]]) with backlinks, unlinked mentions and a local graph

Collect

  • Web clipping: paste a URL into the search palette (⌘K) and the article is extracted, converted to Markdown and saved — images downloaded into the workspace so clips read offline
  • Paste or drag images straight into notes (stored under .assets/, relative paths)
  • Files of any kind live alongside notes: PDF reading, image / video / audio viewing built in

Find

  • ⌘K palette: title + full-text search with filters (#tag, kind:pdf, path:inbox) and a live preview pane
  • Smart folders: saved rule-based views over the whole workspace (source, kind, dates, tags…)

Own

  • Everything is a file on your disk; edits made outside Melo are picked up live
  • Export any note as Markdown, standalone HTML (a single self-contained file) or PDF
  • English and Simplified Chinese interface; light / dark / system theme

Development

Use Node.js 24 and the pnpm version pinned in package.json.

pnpm install
pnpm run dev                 # start the app in dev mode
pnpm run lint                # read-only ESLint and Prettier checks
pnpm run lint:fix            # apply ESLint fixes
pnpm run typecheck           # main/preload and renderer typechecks
pnpm test                    # unit tests
pnpm run release:check       # lint, typechecks, tests, production build
pnpm run build:mac:unsigned  # local unsigned macOS package

Development builds use a persistent Melo Dev profile in the system app-data directory, separate from the installed app. Select your workspace on the first development launch. Set MELO_USER_DATA to use a different profile for tests.

CI validates macOS arm64 and x64 builds; publishing a release is a separate manual step. Built with Electron 31, React 18, TypeScript, Tiptap, and Jotai. See AGENTS.md for architecture notes.

License

MIT © 2026 Melo Labs