One Thing

One pinned sentence in the Omarchy bar. Click it to edit. That's the whole app.

Not a note, not a todo list — a 12-pixel goal that is simply there, all day.

Interactions

A vertical bar has no room for a sentence, so the widget collapses to a pin icon that opens the same editor and carries the text in its tooltip.

The file is the API

The sentence lives in one line of plain text. The contract is one line, first 4 KB:

$XDG_STATE_HOME/omarchy/one-thing        # ~/.local/state/omarchy/one-thing

The bar watches that file, so anything that can write a line can set the goal and the bar follows it live:

echo "Ship the PR" > ~/.local/state/omarchy/one-thing

The bundled CLI is the same idea with the quoting made optional:

one-thing                      # print the current one thing
one-thing Ship the PR          # pin a new one
one-thing --clear              # clear it
one-thing --edit               # open the editor on the focused screen

Put it on PATH with:

ln -sf ~/.config/omarchy/plugins/io.github.parnoldx.one-thing/bin/one-thing ~/.local/bin/one-thing

Install

omarchy plugin add https://github.com/parnoldx/omarchy-one-thing.git --enable --yes

Drag it anywhere along the bar afterwards; the bar remembers.

Keybinding (optional)

~/.config/hypr/bindings.lua:

o.bind("SUPER CTRL", "O", "one-thing --edit", "Edit your one thing")

Remove

omarchy plugin remove <id>          # or: omarchy plugin disable <id>
rm -f ~/.local/bin/one-thing        # if you symlinked the CLI
rm -f ~/.local/state/omarchy/one-thing

Nothing else is written anywhere: the plugin ships no service, no hook, no autostart. The only processes it spawns are mkdir -p for its state directory and a 4 KB head -c read of that file — the widget never loads more than the first 4 KB, and never rewrites the file on its own.

Settings

Per-widget keys in the widget's bar.layout entry in ~/.config/omarchy/shell.json:

{ "id": "io.github.parnoldx.one-thing", "maxWidth": 420, "placeholder": "…" }