Obsidian Stats logoObsidian Stats

GTD Flow

by Marco Guidetti
5
4
3
2
1
Score: 35/100
New Plugin
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Structured GTD: sequential/parallel projects, defer dates, next actions, forecast and review.

Reviews

No reviews yet.

Stats

stars
4
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

GTD Flow

Structured, GTD-style task management for Obsidian, built on plain Markdown.

GTD Flow brings serious project structure — sequential and parallel projects, defer dates, next-action availability, forecast, and review — to your Obsidian vault, while keeping every task as a normal checklist line in your own notes. There is no hidden database: your Markdown is the source of truth, and the tasks stay readable (and editable) even with the plugin turned off.

It speaks the Tasks plugin emoji syntax, so the two can share the same files.

⚠️ Early release (0.1.0) — in active use and testing. Feedback welcome.

Screenshots

Next actions Forecast Timeline
Next actions Forecast Timeline
Review Perspectives Capture
Review Perspectives Capture

Why GTD Flow

  • Your notes stay yours. Projects are ordinary Markdown notes; tasks are ordinary - [ ] lines. Greppable, portable, Git-friendly, and fully usable without the plugin.
  • Real next-action logic. A task is available only when its project is active, its defer date has passed, and — in sequential projects — everything before it is done.
  • Action groups. Indent tasks to nest them; a group with open children isn't actionable until those children are finished.
  • One pane for the day. Forecast and a Mermaid-powered Gantt timeline (day / week / month) show what's due and what's coming.
  • Capture without friction. A quick-capture modal, a global command, and an obsidian://gtd-capture URL for grabbing tasks from anywhere.
  • Stays out of the way. Flags, durations, repeats, perspectives, archiving, and per-project page colors — use as much or as little as you like.

Core ideas

Concept GTD Flow
Project A note with type: project frontmatter
Sequential / parallel flow: key (overridable per action group)
Defer / Due 🛫 / 📅 on the task line
Flag a tag (default #flag)
Forecast Forecast + Timeline views
Review per-project interval + a review queue
Inbox a capture note you triage into projects

Feature highlights

  • Sequential/parallel projects with nested action groups
  • Defer, due, duration (⏱), repeat (🔁) on tasks, with inline auto-suggest
  • Next Actions, Forecast, Timeline (Gantt), Review, and Perspectives views
  • Quick capture (modal, command, and URL handler) and inbox triage into projects
  • Repeat-on-complete, flags, archiving, and an overdue badge in the status bar
  • In-note highlighting of next/available/blocked/overdue tasks
  • Per-project page styling (background tint and banner)

Install

While in beta, install with BRAT: add this repository as a beta plugin, then enable GTD Flow in Settings → Community plugins.

Manual install: download main.js, manifest.json, and styles.css from a release into <vault>/.obsidian/plugins/gtd-flow/ and enable the plugin.

Quick start

  1. Set your projects folder and inbox note in the plugin settings (defaults: GTD/Projects, GTD/Inbox.md).
  2. Run GTD Flow: New project, or right-click the projects folder → New GTD project.
  3. Add tasks as - [ ] lines; type at the end of a line for the date/duration/repeat suggester.
  4. Open Next actions from the ribbon and start working.

Documentation

Full usage, syntax, settings, and architecture: INSTRUCTIONS.md.

License

MIT © Marco Guidetti

Sponsors