Tsuki

つき・月

a little purple journal where every entry is a file you can open ☽

about ABOUT.TXT

elysia@pink: ~/.tsuki · zsh

elysia@pink:~/.tsuki $ cat about.txt

a little purple journal for macOS.
entries live as plain JSON files in ~/.tsuki/entries/.
no database, no cloud, no one reading over your shoulder.

elysia@pink:~/.tsuki $ vim entries/550E8400.json

tsuki watches the folder while it runs. external edits
sync in gently, without clobbering what you're typing.
vim, jq, git & time machine all get a turn.

elysia@pink:~/.tsuki $

your journal is yours: readable in twenty years, greppable tonight.

what it does FEATURES.TXT

☽rich entriestitle, tags, moods, source links & linked entries.

✦folders & tagsdrag entries into folders, filter by tag from the sidebar.

⌕full-text searchinstant, with a highlighted snippet of where it matched.

✧pinningpinned entries stay at the top of the list.

∞entry linksconnect entries into little constellations.

⋆stats & streakscurrent & longest streak, 30-day dots, mood distribution.

☾file watchingedit in vim while tsuki is open, it notices & syncs.

♡night sky30 stars twinkling behind your words, redrawn 20 times a second.

✎local jsonone file per entry, on your own disk. no database.

✩open sourceMIT, on github. take it, learn from it.

swift + swiftui, zero dependencies: the whole app is eleven swift files.

an entry, on disk ENTRY.JSON

{
  "content": "## Today\n\nwrote a little,\n walked a little...",
  "createdAt": "2026-07-15T01:12:09Z",
  "folder": "Daily",
  "mood": "😌",
  "pinned": false,
  "tags": ["daily", "soft"],
  "title": "a quiet tuesday"
}