Skip to content
The English translation is still being built: some pages may lag behind the German ones.
Terminal menus

Terminal menus

tui/samu-tui puts fzf menus over the command line: the views, a task list with a preview, and keys for the common edits. Everything goes through samu.

Needs samu signed in, fzf 0.53 or later, jq and bash. make install links it into the bin directory. The editor for notes is $VISUAL, else $EDITOR, else vim.

samu-tui                       # the main menu: available, today, inbox,
                               # flagged, projects, by tag, search
samu-tui list --available      # the task list directly; options as for samu list
samu-tui list --inbox
samu-tui --help

Keys in the task list

Key
Enterthe menu of the task: comments, attachments, reminders, logbook, delete, …
Tabselect several
Ctrl-X / Alt-Xcomplete / drop (the selected tasks)
Ctrl-N / Ctrl-Snext state / pick a state
Ctrl-Fflag on/off
Ctrl-Tadd tags (a new one when none matches)
Ctrl-Etitle
Ctrl-Onote in the editor
Ctrl-Ddue date
Ctrl-Pmove to a project
Ctrl-Anew task with quick capture
Ctrl-Rreload
?preview on/off
Escapeback

Helper script

The lists and edits come from pult/samu-pult, a small shell script that prints tab-separated lists from samu and runs actions. It also serves a menu for pult, a keyboard overlay for Wayland that is a separate project; pult/samu.edn is that menu. Set SAMU_PULT if the script lives elsewhere.