Tsuki

つき・月

a cozy journal that keeps your secrets on your computer, always ☽

about ABOUT.TXT

elysia@pink: ~/.tsuki · zsh

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

a dreamy personal 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.
your editor, your scripts & your backups are all welcome.

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 & drop folders, filter from the sidebar.

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

✧pinningthe entries that matter float to the top.

∞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.

♡dreamy night skytwinkling stars drawn live behind your words.

✎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 a handful of 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"
}