Skip to content
Docs0.9GitHubInstall

Using itTasks

Tasks and Personal Hub

The web client's tasks, grouped by project

Tasks come from one plugin that serves the tasks service. The chooser, apps, Telegram and Discord Master messages, and the HUD show them while it runs. Vendetta ships personal-hub as that plugin; another task source, such as a to-do service, can take its place by serving the same contract.

Personal Hub, a separate optional project, keeps personal tasks in an Obsidian vault. The personal-hub plugin watches the vault, and the Master receives reminders and clarification requests.

[plugins.personal-hub]
executable = "/absolute/path/to/personal-hub/bin/personal-hub"
vault = "/absolute/path/to/personal-hub/vault"
poll_seconds = 3

Requirements:

  • Configure [master] and [master.start] first.
  • Set the vault’s Hub.yaml timezone, and enable reminders_enabled.
  • Start the scheduler, which runs the reminders.

How it works:

  • Checkbox captures in Inbox.md, like “call X tomorrow at noon”, become linked task notes.
  • Checking a box completes its task.
  • Unclear captures go to the Master to clarify.
  • Every poll_seconds the plugin checks the vault, the hub’s state, the Master, and its schedules, and asks the hub again only when one changed, or a minute has passed. A reminder already scheduled runs at its time; one the clock alone makes due, such as a missed reminder caught up, may wait up to that minute.
  • Every Master message on Telegram lists your active tasks under To-dos.
  • In the chooser, p opens your tasks and C their calendar; project headers show how many are open. See Tasks in the chooser.
  • The HUD’s to-do section keeps them on screen.
  • Only the Master can use vendetta service call personal-hub snapshot, mutate, and resolve: the worker checks that the Master runs the command.
  • Reminders and captures are the plugin’s schedules. The schedules screen shows them; they can be paused, run now, or deleted, never edited.
  • A task’s text never authorizes calls, messages, or doing the task.

p opens a list of open tasks, personal first and then by project, with overdue ones on top. C opens the week calendar directly, and Tab switches between the two. The calendar shows each day’s whole-day tasks above an hourly timeline, with the current hour marked; narrow terminals show a day strip and one day. Left/Right move a day, PageUp/PageDown a week, and Home returns to today. Overdue tasks and passed starts show on today.

Enter lists every action; the common ones have letters: d done (o reopens it), e edit, s snooze, p priority, u status, c cancel, n new task. Dates take today, tomorrow, fri, +3d, +2w, 2026-11-02, or 11-02, with an optional 14:30, in the hub’s time zone.

Changes go through the same guarded edit as the app: each names the task’s current version, so an edit made elsewhere conflicts instead of being overwritten, and a failed or uncertain change is never retried. Tasks appear only when the chooser runs on the worker’s tmux server.