Web UI
The server serves the web UI at /. It needs nothing else: no build step,
nothing loaded from other sites. Sign in with account and password; the
session is a cookie. The interface is in German; this page gives the German
labels in quotes.
Layout
Three columns: the sidebar on the left, the list in the middle, the inspector of the selected task on the right. Below 800 px width they stack, and the task replaces the list ("‹ Liste" goes back).
Top bar
- Search (
/): free text and chips, see Search language. - Voice note ("● Sprachnotiz",
r): records audio; pressing again files an inbox task “Sprachnotiz date time” with the recording attached; Escape discards. - Capture ("+ Erfassen",
n): the quick capture window. While you type, the server’s preview shows as chips and warnings; inside#…and@…it suggests known projects and tags (↑ ↓, Tab or Enter takes one). Enter creates the task; Tab creates it and opens it in the inspector.Cand a key captures with a template. - Scope picker: the scope of this browser. A scope with a colour tints the line between sidebar and list while it is chosen.
Sidebar
The account menu (theme: system, light, dark; pairing a phone, “Handy koppeln”; sign out), the views (Inbox, “Alle Projekte”, “Heute”, Forecast, “Kalender”, “Markiert”, Stuck, Review, “Bericht”), your perspectives, then folders and projects with the number of available tasks.
[ cycles the sidebar through full, narrow (icons, and tiles with two
initials or the emoji of a folder or project) and hidden; the choice is
kept in the browser. Folders and projects can be created, renamed, moved
and folded here, and tasks can be dragged onto a project or the inbox.
List
- A switch for available / remaining / all (“Verfügbar”, “Verbleibend”, “Alle”).
- Arrange (“Anordnen”): group by project, folder, tag, state, priority, date or nothing; sort by own order, due, planned, defer, title, created, modified, estimate or priority, with a second key; kept per view in this browser.
- Each row shows the state as a badge before the title, the due date in colour and words, flags, priority, a note mark and, optionally, a second line with dates (“Details”). A blocker shows 🚧.
- Board (“Liste | Board”): the same tasks as cards in columns. The
columns are the states of a workflow or an ordered list of tags, plus
“Ohne” and “Erledigt” (the last 7 days), each with an optional
work-in-progress limit. Dragging a card sets the state, swaps the tag,
completes or reopens.
zshows the board full screen.
Inspector
For the selected task: place, title, id (with a copy button), priority,
availability with every reason, state, complete / drop / reopen, flag,
project, dates, repetition, reminders, tags, note (rendered as Org or
Markdown; a pencil or double click edits it, checkboxes are clickable,
samu: links open the task), properties, links, blockers, attachments,
comments, time, habit streak, logbook. A scope’s layout can fold parts of
it away.
] (or ⤢) shows the task across the middle and right columns, the text in
readable width.
Comments are rendered like the note and show their author, marked “Agent” when an agent wrote them. You can edit and delete what a session of your kind wrote. Below them a field takes text and files: paste, drop, choose, or record audio with “● Aufnehmen”.
Selecting many
Ctrl- or ⌘-click adds a row, Shift-click a range, Space the current row. A bar then offers complete, reopen, drop, flag, move, tag on/off, state, date (due/planned/defer: today, tomorrow, a day, clear) and delete. The selection can be dragged onto a project or the inbox in the sidebar.
Status line
Account and device, the running clock with its task and time (click stops
it), and whether live updates (/events) are connected.
Views
| View | |
|---|---|
| Forecast | overdue, today, flagged, the next days and later, with appointments; settings decide how many days and what shows |
| “Kalender” | day or week; ‹ Heute › pages; a grid from 7 o’clock with a line for now and a band for all-day items. Appointments in their calendar’s colour (tentative ones hatched); tasks with a planned time dashed, as long as their planned duration, else their estimate, else 30 minutes |
| Stuck | active projects without an available task |
| Review | projects due for review; R marks the project reviewed |
| “Bericht” | three tabs, “Erledigt” (done), “Bearbeitet” (worked on) and “Zeit” (time), over a span (today, yesterday, this or last week, this month, 30 days, free), grouped by task, project, folder, tag or day, with a filter in the search language |
Settings
“Einstellungen” (g s) has these sections: Scopes, “Projekte und Ordner”
(icons, “Nur im Scope”), Tags (workflows, states, keys), Forecast, “Kalender”
(sources, colours, the default calendar for new appointments), Properties
(link templates per key), “Vorlagen” (templates and their keys) and
“Tastatur” (key bindings).
Keys
? shows the bindings. The defaults:
| Key | |
|---|---|
j k, ↓ ↑ | next / previous task |
| Enter | open |
| Space | select the task |
x | complete / reopen |
s | next state (round) |
t + key | pick a state by its key |
f | flag |
c | start / stop the clock on the task |
e | edit with marks (@tag #project !A d:fri …) |
m | move (refile): fuzzy search over inbox, projects and action groups; Enter moves, Tab makes it a child |
> < | indent / outdent |
| Shift+↑ Shift+↓ | move one place up / down |
N | new child task |
n | capture |
C + key | capture with a template |
r | voice note |
/ | search |
R | mark the project reviewed |
| Delete | delete … |
| Shift+F10, right click | the task’s menu |
| Alt+← Alt+→ | on the board: move the card a column |
z | board full screen |
[ | sidebar: full, narrow, hidden |
] | task across the full width |
g i, g f, g m, g p, g r, g z, g k, g s | go to inbox, forecast, flagged, projects, review, report, calendar, settings |
| Escape | back |
With a selection, x, f, m, s, t and Delete act on all selected
tasks. Every binding can be changed under “Tastatur” (stored in the
account, so every browser gets it; samu settings set keys on the command
line).
Links from outside
/o/<id> opens an object. On a computer with the command line installed,
samu: links in other programs open here too (see CLI).
Live
The page follows /events while the tab is visible: what changes on
another device appears without reloading.