README file from
GithubGTD Tasks
Your tasks are scattered across hundreds of notes. This Obsidian plugin gathers them into one sidebar panel, sorted by when you'll actually do them: Today, This Week, Next Week, This Month, Someday (the Getting Things Done time horizons).
Your notes stay the source of truth. A bucket is just a tag on the task line, like #gtd/today.
Have the Tasks plugin? The two work together. This panel reads the fields Tasks writes on your task lines and puts them to use.
Features
- Time-horizon buckets — Today ⚡, This Week 📌, Next Week 🔭, This Month 📅, Someday / Maybe 💭. Rename them, swap the emoji, reorder them, or write your own date rules.
- To Review inbox 📥 — every task without a bucket lands here, so nothing slips through.
- Three ways to move a task — quick-move buttons on the row, drag-and-drop between buckets, or right-click.
- Subtask-aware — indented tasks track with their parent, with a count badge and a prompt to move them along.
- Overdue and misfiled flags —
❢once a due date has passed,⚑when a task sits in a bucket that will make you miss it. - Reads Tasks plugin fields — due dates, priority, recurrence and the rest show up as badges and on hover.
- Celebration animations — confetti, a pixel creature, both, or nothing.
- 13 languages, matching your Obsidian UI language.
Also: search, scoping to folders or files, Dataview-friendly inline fields, per-bucket status bar counts, and a compact view. See Configuration.
Works with the Tasks plugin
Run both, since they solve different problems.
The Tasks plugin adds structure to a task: a due date, a priority, a repeat rule. It also searches your vault and lists the matching tasks inside a note.
This plugin is for one view you keep open all day. Drag tasks between buckets, or reorder them inside one, and your plan for the day changes in seconds.
How they work together
A task with a 📅 YYYY-MM-DD due date lands in the bucket whose date rule matches it. Move it yourself and it stays where you put it.
Checking a task off in the panel does what checking it off in the editor does, including the Tasks plugin's recurrence and completion-date setting.
As of v0.2.0, panel completions don't write a
✅date. Install Tasks if you want one.
Default Buckets
| Bucket | Emoji | Date rule |
|---|---|---|
| To Review | 📥 | Unassigned tasks (system bucket) |
| Today | ⚡ | Due today |
| This Week | 📌 | Tomorrow → end of this week |
| Next Week | 🔭 | Next Monday → following Sunday |
| This Month | 📅 | This week → end of this calendar month |
| Someday / Maybe | 💭 | No date rule (manual only) |
Installation
Open Settings → Community plugins → Browse, search for GTD Tasks, then click Install and Enable.
Or add via Obsidian community plugin page.
- Install the <a href=https://github.com/TfTHacker/obsidian42-brat>BRAT community
- In BRAT settings, click Add Beta Plugin and enter: Unpreditable/GettingThingsDone
- Enable GTD Tasks in Community plugins
Usage
Open the panel
Click the checklist icon in the left ribbon, or run Open GTD Panel from the Command Palette (Ctrl/Cmd + P).
Move a task
Three ways to move a task to a different bucket:
| Method | How |
|---|---|
| Quick-move buttons | Click the small bucket buttons on the right side of the task row |
| Drag-and-drop | Drag a task row to any bucket, including collapsed ones |
| Context menu | Right-click a task row → Move to… |
The plugin writes the assignment back to the source markdown file immediately. If the task has subtasks that each have their own bucket assigned, you'll be asked whether to move them along with it.
Search
Type in the search box at the top of the panel to filter down to matching tasks. The status line below it shows how many tasks are currently visible; click it (or the × in the search box) to clear the search.
Configuration
Annotation style
Controls how bucket assignments are stored on the task line:
| Mode | Example |
|---|---|
| Inline tag (default) | - [ ] Buy milk #gtd/today |
| Inline field | - [ ] Buy milk [gtd:: today] |
| You can migrate all existing assignments between modes from the settings tab. |
Tag / field name
The prefix used in both storage modes. Default: gtd. Changing this also changes the tag/field name written to your files.
Files to scan
Limit which files are indexed:
- Entire vault — all
*.mdfiles - Specific folders — enter one or more folder paths
- Specific files — enter one or more file paths
Show completed tasks until midnight
Keeps a checked-off task in the panel, struck through, until midnight or until you reload Obsidian, whichever comes first. Clear them sooner with the broom icon in the panel header. Turn the setting off and each task disappears the moment you check it.
Repeating tasks are the exception. Checking one off hides it right away, because its next occurrence is already in the list.
Flag overdue and misfiled tasks
When enabled, two badges call out tasks whose due date needs attention:
❢(red) — the task's due date has passed.⚑(amber) — suggests a better bucket so you don't miss the due date: a task due today inThis Weekbelongs inToday.
Neither badge appears on completed tasks, or in the To Review bucket.
Hover a task to see the reason: ❢ Due Sat, Aug 1 (3 days overdue), ⚑ Due today (belongs in Today).
Compact view
Reduces padding on bucket headers and task rows for a denser layout.
Celebration animations
Choose what plays when you check off a task:
| Setting | Effect |
|---|---|
| Confetti (default) | Confetti burst only |
| Creature | Pixel creature only |
| All | Confetti burst + pixel creature |
| Off | No animation |
Tasks plugin fields
Control how the Tasks plugin fields show up in the panel:
- Show priority (default all) — which priority levels get an emoji badge (🔺⏫🔼🔽⏬) on the task row.
- Show recurrence badge (default on) — mark repeating tasks with
🔁on the task row. - Show Tasks fields in popover (default on) — list due date, priority, recurrence and the other Tasks fields when hovering a task.
Status bar
Each bucket can optionally show its task count in Obsidian's status bar. Toggle per bucket in the bucket list at the bottom of settings.
Bucket Date Rules
Each bucket can have an optional date range rule that auto-assigns tasks based on their 📅 due date:
| Rule | Covers |
|---|---|
today |
Today only |
this-week |
Tomorrow through end of this week (Sunday) |
next-week |
Next Monday through the following Sunday |
this-month |
Remaining days through end of this calendar month |
next-month |
First through last day of next calendar month |
within-days |
Due within the next N days |
within-days-range |
Due between day M and day N from today |
beyond-days |
Due more than N days from today (useful for Someday) |
Tasks with no due date and no manual assignment land in To Review.
To Review Bucket
The To Review bucket is a permanent system bucket that always appears first in the panel. It collects every task that has no manual assignment and no matching due date rule. Use it as a GTD-style inbox: process tasks from here by moving them into the appropriate time-horizon bucket.
Subtasks
A task indented under another task in your markdown file is tracked as its subtask. Parent rows show an active-subtask count badge, and a subtask that's been moved to a different bucket than its parent gets a small indicator pointing back to it. Moving a parent that has subtasks with their own bucket assignments will ask whether to move those subtasks along with it, or leave them where they are.
Localization
The panel and settings UI are available in German, Spanish, Estonian, French, Japanese, Korean, Lithuanian, Latvian, Portuguese, Russian, Ukrainian, and Chinese, in addition to English, matching Obsidian's UI language automatically. If you change Obsidian's language, default bucket names update to match on next load, with a one-time notice in the panel.
Network Use
This plugin opens github.com in your default browser when you click Share feedback & ideas in settings, after you confirm a dialog. No background connections, and your data never leaves your machine.
License
GPL-3.0 © 2026 Vitaly Ditman