Skip to content
benfoos-codePublic

About

Keyboard-first Markdown notes for the Omarchy desktop

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

jot

jot: a note list beside a Markdown editor

Quick notes that stay out of the way. One window, one job: write a note and find it again. Built for Omarchy with C++ and Qt Quick.

  • Notes are plain Markdown files in ~/.local/share/jot/notes, one per note. The first non-empty line is the title, so there is no separate title to keep in sync.
  • Saving is atomic: the file is written beside the old one and renamed into place, and typing is autosaved a moment after you stop.
  • Deleting asks first and moves the file to ~/.local/share/jot/trash, so a note is never really gone.
  • The window follows the Omarchy accent and Hyprland's window rounding live, and follows the language picked under Setup > Language (English, Danish, and German ship in the binary).

Shortcuts

Key Action
Ctrl+N New note
Ctrl+S Save now
Ctrl+F Search notes
Ctrl+R Reload from disk
Ctrl+Q Quit
↑ ↓ Move through notes
Space Open the note and start writing
Delete Delete the note (asks first)
Ctrl+Z Undo while writing
Ctrl+Shift+Z Redo while writing
F1 Show every shortcut
Esc Close the overlay, or clear the search

Bare q and ? also work while the note list has the keyboard, and never while typing a note.

Build, test, install

Everything it needs is part of Omarchy:

bin/build     # qmake6 + make into build/jot
bin/test      # Qt Test binary, offscreen
bin/install   # makepkg -fsi: binary, .desktop entry, and icon

bin/install needs sudo to hand the package to pacman. Without it, the app still runs from build/jot.

Command line

The window is jot or jot open. Everything else works without a display, so an agent can drive it:

jot list --json
jot search <query> --json
jot show <id> --json
jot new --title "Groceries" --json
jot new --body $'# Groceries\nmilk\n' --json
jot skill install

Commands exit 0 or 1, with errors on stderr. jot skill install writes a short agent skill to ~/.agents/skills/jot/SKILL.md.

License

MIT. The Theme and Translator classes follow Omacut and Monologue (MIT, David Heinemeier Hansson).

About

Keyboard-first Markdown notes for the Omarchy desktop

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages