Jot

A thought strikes. Type it. Enter. Back to work.

A minimal overlay with one text field. Whatever you type is appended as a timestamped - [ ] line to ~/notes/inbox.md, and the overlay is gone. Capturing and organizing are separate moments: Jot owns the capture; you own the rest.

Installation

Jot needs Omarchy 4 or newer.

omarchy plugin add https://github.com/yordanbuilds/jot.git --enable

On first load:

• Jot appears in the Omarchy menu, under Trigger — Jot down and Open inbox
• ~/.config/jot/config.json is created with the defaults
• the jot command lands on your PATH — jot, jot inbox, jot uninstall
• Jot asks about the SUPER+N shortcut — decline, and Add SUPER+N shortcut waits in the menu (or jot bind-key)

Prefer another key? Write it yourself in ~/.config/hypr/bindings.lua:

o.bind("SUPER + SHIFT + N", "Jot", "omarchy-shell shell toggle yordanbuilds.jot '{}'")

Everything Jot adds is marked and yours.

Usage

Key	What happens
SUPER+N	Open the overlay, once you add it
type	Compose the thought
Shift+Enter	New line — the thought stays one item
Enter	Append to the inbox and close
Esc / empty Enter	Close without saving
click outside the card	Close without saving

From a terminal: jot opens the same overlay, jot inbox opens your inbox.

Multi-line thoughts land as one markdown todo with indented continuation lines:

- [ ] 2026-08-16 14:32 does logout clear the refresh token?
  check SessionGuard, and the mobile client too

Configuration

~/.config/jot/config.json:

{
  "file": "~/notes/inbox.md",
  "template": "- [ ] %Y-%m-%d %H:%M {text}"
}

file is where captures land (created on first capture).

template is the line format: {text} is your thought; everything else goes through date(1), so any strftime code works — or delete the codes for no timestamp at all.

Uninstall

jot uninstall

It confirms, asks about ~/.config/jot (--purge skips that question), then removes the plugin itself. Your notes file is never touched.

License

Jot is open-source software licensed under the MIT license.