Skip to content
← All apps

An app by Flavio

Note Repo

A quiet daily notes app for macOS. It opens on today, you write nested lists, and your notes stay in one file on your Mac.

Buy Note Repo · $20

One-time purchase. Tax included.

macOS 14 or later · Apple silicon and Intel

Latest version 2.9.0, released November 20, 2026

Note Repo, a quiet, local-first daily notes app for macOS

You want somewhere to write down what happened today. A call, a link someone sent, the thing you promised to do by Friday. Most note apps start by asking where it goes: which folder, which notebook, what title.

So you end up with one giant note called “Notes”, or forty notes called “Untitled”. Two weeks later you can’t find the link, and you can’t remember which day you talked to the accountant.

Note Repo has one place for everything: today. Open it and the cursor is on a bullet under today’s date. Type. Earlier days sit above, but only the ones where you wrote something. There are no folders, no titles to invent and no empty pages to skip.

Here’s the app in a minute. The notes, the people and the sites in it are made up:

Who it’s for

  • Freelancers who bill by the hour. At the end of the month you need to know what you did for each client. If every day has a few lines, the invoice is a search for the client’s name away.
  • Managers with a day full of calls. You write two lines after each meeting, star the promise you made, and the next morning View starred shows everything still open across every day.
  • People who collect links. Articles, YouTube videos, Reddit threads, posts on X. Paste them and you get the title instead of a long URL, filed under the day you found them.
  • Anyone who wants notes without an account. No sign-in, no sync service, no AI. The notebook is one SQLite file in your Library folder, and you back it up by copying it.
  • Developers who work with coding agents. The noterepo command lets an agent add what it did to today’s notes, read yesterday’s, or search the whole notebook, and the open window updates as it writes.

A day with it

Here’s how a normal day looks.

  1. In the morning, open Note Repo. It’s on today, with a bullet ready. Type Call the bank about the card and press Return.
  2. Press Tab to nest the next line under it: Ask about the second fee. Shift-Tab brings you back to the top level.
  3. Someone sends you a link. Paste it on its own line. Note Repo fetches the page title and shows it next to the domain.
  4. You take a screenshot of an error, or of a receipt. Paste it, or drop the file into the day, then drag its corner to make it smaller.
  5. Something needs doing later in the week. Click its bullet to star it.
  6. On Thursday, click View starred to see the starred items from every day. Click a star to take it off the list once it’s done, then click Today to go back.
  7. Next month you need that link again. Press ⌘F, type a word from the title, and pick the day from the list.

Two days of notes in Note Repo with nested lists and a starred item, Book the weekend train

Note Repo saves as you type, so there’s no save button. ⌘D jumps back to today from wherever you scrolled, and Option-Up and Option-Down move a day at a time.

Every note is a list. Start a numbered list with 1. or a bulleted list with -. Option-Return adds a second line inside the same item, which is handy for an address or a short quote. ⌘B makes text bold.

Fig 1 · 1/3A daily note stays in a local file
Only days with notes appear in the history

When you paste a link, Note Repo shows the page title next to the domain. A YouTube link gets the video title, including Shorts and youtu.be links. A Reddit link gets the post title, and a link to a comment reads “Comment to” followed by the post title. An X post gets the first line of its text. Pasted text is cleaned of stray blank lines, trailing spaces and invisible characters.

Note Repo showing three days of notes, with starred items and titled links

Images can be PNG, JPEG, GIF, WebP or SVG, up to 15 MB each. You can resize them by dragging the right edge, the bottom edge or the corner, and cut, paste or delete them like any other item.

Press ⌘F or ⌘K and type. Search shows every day that has a match, newest first, with the line that matches:

Searching for quillberry lists every day that mentions it

Click a result and Note Repo scrolls to that day. Because every note sits under its date, you also see what else happened around it.

The noterepo command

Note Repo comes with noterepo, a native command-line tool inside the app. Link it into a folder on your PATH and you can add items, links and images, show a day, list days, search, edit and move items, and back up the notebook. Every command prints JSON:

noterepo add "Test the weekend prototype"
noterepo show yesterday
noterepo search weekend
noterepo backup

It writes to the same file as the app. The app notices the change within a second and updates the open window. If you’re typing in the same day at that moment, your edits and the tool’s are merged instead of one replacing the other. noterepo capabilities --json describes the commands for a coding agent.

Your notes stay on your Mac

Your notes stay on your Mac, in a single SQLite file. The app has no sign-in or AI features. It goes online to read the title of a link you paste. For an X post, that title is the first line. Once a day it checks updates.flaviocopes.com for a newer app version. None of these requests contain your notes.

The notes and the requests for link titles take different paths:

Where Note Repo saves notes and fetches titlesTyped notes are saved in local SQLite. A pasted link also triggers an online title lookup, whose result appears in the note.Type a noteLocal SQLite filePaste a linkOnline title lookupTitle shown in thenote

The file lives at ~/Library/Application Support/NoteRepo/notes.sqlite3, with your images inside it. noterepo backup makes a complete copy and prints where it put it. noterepo restore puts a backup back, and saves the current notebook first.

Why not use Apple Notes

Apple Notes is free and already on your Mac, and you can keep a journal in it. Make a folder, press ⌘N each morning, type the date as the first line, and sort the folder by date created so edits don’t shuffle the days. That works fine.

The friction is small but it’s every day. You type the date yourself. Each day is a separate note, so reading last week means opening seven notes. Finding an old link means searching and then opening each result. A pasted link stays a long URL.

Apple NotesNote Repo
Starting today’s noteNew note, type the dateOpen the app, start typing
Reading last weekOpen each day’s noteScroll up through one page
Things still to doPinned notes or a checklist per noteStar a line, View starred shows all
Pasted linksThe URLPage title and domain
Where notes liveiCloud or On My MacOne SQLite file on your Mac
From the terminalNonoterepo with JSON output

If you already keep a journal in Notes and it works for you, keep it. Note Repo is for when you’d rather the app handled the dates for you.

What it doesn’t do

  • It doesn’t sync. There’s no iPhone app and no cloud. Your notes are on one Mac. To move them, copy the file or use noterepo backup and restore.
  • It doesn’t have folders, tags or titles. Everything is organized by day. Search and stars are how you find things.
  • It doesn’t have future days. You can’t write a note for next Tuesday. Star the item today instead.
  • It doesn’t do rich formatting. Lists, bold, links and images. No tables, headings or colors.
  • It has no AI features. Nothing reads or summarizes your notes.

Questions

Does anything get uploaded?

No. Notes and images stay in the file on your Mac. The app goes online only to read the title of a link you paste and to check for updates once a day, and neither request includes your notes.

Does it work offline?

Yes. Writing, search and the command-line tool all work without a connection. Only the link titles need the internet.

How do I back up my notes?

Run noterepo backup, or copy the NoteRepo folder in ~/Library/Application Support in the Finder. Keep a copy off the Mac if you want protection against a disk failure.

Does it work on Intel Macs?

Yes. Note Repo runs on Apple silicon and Intel Macs with macOS 14 or later.

Is it a native app?

Yes. Note Repo is written in Swift. SwiftUI draws the window, and each day is an AppKit text view. The whole download is about 1.6 MB.

The first versions ran the AHA stack (Astro, HTMX, and Alpine.js) inside Electron. Note Repo 2.0 replaced that with the Swift app, which looks the same, opens the same notes, and uses about a third of the memory.

I’d also like an iPhone app for Note Repo, and I wrote about how to sync a Mac app with its iPhone app while planning it.

The documentation covers every shortcut and the full command-line tool, and the tutorial on keeping a daily work log shows how stars and search fit together.

What you get

The $20 one-time purchase includes the signed Mac app, the noterepo command and automatic updates.

Downloading the app and updates

After buying, download the app zip from your purchase page, unzip it, and drag Note Repo to your Applications folder. It runs on Apple silicon and Intel Macs with macOS 14 or later.

Note Repo is signed with my Apple Developer ID and notarized by Apple, so it opens like any other app you download.

Note Repo checks for updates once a day. Choose Note Repo → Check for Updates… to check now and Install and Relaunch to install.

Note Repo screenshot at full size