Task Hub

中文说明 / Chinese README

Task Hub is a sidebar task plugin for TriliumNext.

It provides a clean task overview on the right panel, helping you collect todos scattered across different notes, including due dates, priorities, recurring tasks, and quick navigation.

Preview

Features

• Today: see tasks due today, with optional overdue tasks
• Upcoming: see future dated tasks
• Inbox: automatically collect undated tasks from configured note scopes
• Follow-up Later: mark tasks that are worth keeping but not ready to schedule
• Recurring tasks: supports #every n day/week/month
• Recurring task preview: shows the next possible recurring occurrence in Upcoming
• Quick navigation: click a task to open and locate it in the source note
• Quick completion: complete tasks directly from the panel

Installation

Download the latest .zip package from Releases.

In TriliumNext:

1. Hover over the root note.
2. Right-click and choose Import into note.
3. Select the .zip package.
4. Make sure Safe import is unchecked.

After import, refresh TriliumNext. The right panel should show Task Hub.

Basic Usage

1. Normal Tasks

Add tags directly after a todo item, for example:

- [ ] Organize materials #2026-03-29 #P2

Supported markers:

• #YYYY-MM-DD: task date
• #P1 ~ #P4: priority
• #Follow-up: mark as follow-up later

2. Recurring Tasks

Recurring task syntax:

- [ ] Write daily report #2026-03-29 #every 1 day
- [ ] Weekly review #2026-03-30 #every 2 week
- [ ] Monthly cleanup #2026-03-31 #every 1 month

Notes:

• Use #every n day/week/month
• When completed inside Task Hub, the next occurrence will be generated automatically
• Completed history is stored as child tasks
• You can limit recurring history in settings

3. Upcoming Recurring Preview

If you have a recurring task today, for example:

- [ ] Write daily report #2026-03-29 #every 1 day

Then:

• the real 2026-03-29 task appears in Today
• a gray, loop-marked 2026-03-30 preview item appears in Upcoming

This preview means:

• it is the next possible occurrence
• it is not yet a real stored task in the note
• clicking it jumps back to the current real task

Inbox

Inbox is used to collect tasks that do not have a date yet.

In settings, configure:

• Inbox Capture Scope IDs

Rules:

• supports one or multiple note IDs
• separate multiple IDs with spaces
• tasks are collected recursively from those notes and all descendants
• only undated tasks enter Inbox
• for nested tasks, only the parent task is collected by default

Inbox has two views:

• Captured: newly collected unscheduled tasks
• Follow-up Later: tasks you manually marked for later review

Settings

• Language: switch between Chinese and English
• Theme: follow Trilium / light / dark
• Auto-refresh interval: default 5 seconds
• Recurring history limit: 0 means keep all history
• Inbox Capture Scope IDs: separate multiple IDs with spaces
• Show overdue unfinished tasks in Today: controls whether overdue tasks appear in Today

File Structure

• MainTaskHub.js: widget lifecycle, events, tab logic
• TaskHubCore.js: settings, i18n, sorting, shared helpers
• TaskHubBackend.js: backend task scanning, completion, recurring generation
• TaskHubStyles.js: styles
• TaskHubView.js: UI rendering

Who Is It For

This project is a good fit if you manage tasks in TriliumNext like this:

• tasks live inside daily notes, project notes, and capture notes instead of a single page
• you want a lightweight sidebar overview
• you want to keep Trilium's note-based workflow
• you need simple recurring tasks and an inbox flow

Notes

• This is a script-note solution, not an npm package or one-click installer
• Recurring task generation currently happens when tasks are completed inside Task Hub
• Gray loop-marked items in Upcoming are preview items, not real stored tasks
• If you update the source files, sync them back into the corresponding Trilium notes

License

This project is licensed under the MIT License.