Click a hotkey to see what it does.
Folders hold your markdown tasks, and each folder opens in its own tab. Inside a folder, every task is in one of three places:
u undoes it for fifteen seconds) and Move current page shape them.A task is a markdown file. Its first line is the title; everything under it is yours to write. There are no other fields.
i — insert a new task in the cell the cursor is on. Type a title and press Enter. If the cell is taken, the task there moves aside to make room; on a full page, the last task goes to the Inbox.Enter — read the task, rendered. j and k step to the next and previous one; Esc closes it.⌘Enter — edit the task in Derno’s own simple editor, on the whole sheet. ⌘Enter again saves.e — open the task in your own editor: VS Code, vi, Zed, whatever editor names in your settings. Derno reads it again when you save.s — star it. Its title turns yellow.space — postpone it (see Postponed).d — delete it. A toast offers u to undo for fifteen seconds.y — copy the whole task to the clipboard.x — mark the task. With several marked, d, s, space and m act on all of them; Esc clears the marks.Write @word anywhere in a task: it’s plain text you can search for. @ offers the words the folder already uses, ↑ ↓ choose one and Tab takes it.
m starts moving the task you’re on. Then:
h j k l / arrows — swap it with its neighbour.1–9 — send it to that page’s first free cell.⌥J / ⌥K — send it to the next or previous page, which is how it reaches a tenth.f — send it to another folder.Esc — stop moving.Two commands in the palette, Compact current page and Compact all pages of current folder, close the gaps a page collects over time. Tasks slide up within their own column and never cross into another, so nothing leaves the place you look for it.
Not now? Press space, then how long: h an hour, d a day, w a week, m a month, y a year. A number in front multiplies it, so 3w is three weeks. Or type a date, like 7-4 for the 4th of July, and press Enter. Enter alone repeats the span you used last.
The task leaves the page and waits. When its time comes it’s back in the Inbox; anything postponed by a day or more arrives at 08:00 your time. Nothing postponed is lost: everything has a date.
The Inbox is the tab on the right. It holds everything waiting on you: tasks whose day has come, tasks a full page pushed out, and tasks captured from your phone or written into the repo by a script or an LLM.
Enter reads a task there. m then 1–9 puts it back on a page of its folder, star and all. The inbox has a section per folder, plus Captured first; 1–9 go to a section.
Derno tells you when a task comes due or a capture arrives, in any folder, whether or not you’re looking at it. The Dock badge counts everything waiting.
⌘F searches the whole folder, titles and everything you wrote under them. There are no tags: write the word in the task and search for it. ⇧⌘F searches every folder. j and k walk the results and ⇧Tab goes back to the search box. Enter reads a result; on a result from another folder, it takes you there.
Each tab is one folder.
Cmd-T — open a folder in a new tab; Cmd-W — close it.1–9 — go to that page; p — Postponed; ⌥J / ⌥K — next / previous page, which is how you reach a tenth.⌥H / ⌥L — previous / next tab.⌥I / ⌥O — move the tab left / right.Cmd-1 … 9 — go to that tab.Derno commits two seconds after you stop making changes, then pulls, rebases and pushes. It syncs again every 30 seconds and when you come back to the window. Sync repo now in the palette (⌘K, sy) syncs now.
The footer says when something needs you: waiting to sync while changes wait to go out, this computer only when the repo has no remote (then sy says how to add one), needs attention when the same page changed in two places.
? — every hotkey for where you are.Esc — back out one level.Cmd-K — the command palette, for everything that has no key of its own.Cmd-+ / Cmd-- / Cmd-0 — zoom, like a browser.Set hardcore = true in your configuration and the mouse is off. A click does nothing but tell you the key that does the same — Hardcore mode is on: the mouse is off. Press s. — and the wheel turns no pages. You can still select text to copy it, and follow a link in a task. It takes effect when you come back to the window, and nothing on screen says it is on.
With nothing to open, Derno asks for a repo: make a new one, or pick a git repo you already have for your tasks. It must be a repo of its own, not a folder inside a code project.
Your settings live in ~/.config/derno/config.toml, and every field is optional:
repo = "~/repos/tasks" # the repo that holds your folders
editor = "code --wait" # must wait until you close the file
terminal = "ghostty" # gets the folder as its last argument
font_size = 15 # the text on the grid, in px
hardcore = true # the mouse is off; see Hardcore mode
Each folder also has its own .derno/config.toml, opened from the palette.
<repo>/
<folder>/
01AN4Z07BY79KA1307SR9X4MV3.md one task
assets/ pasted images
.derno/
page-1.toml, page-2.toml … where each task sits
postponed.toml what is waiting, and until when
A file at the top of the repo, in no folder, is a capture: it shows up in the Inbox until you file it.
This is the short version. The full manual, with the reasoning behind every choice, isdesktop/MANUAL.md in the repo.