Taskscape

by Belal Adel
5
4
3
2
1
Score: 50/100

Description

An Obsidian plugin that transforms your Markdown task lists into interactive Gantt timelines and grouped summaries, helping you visualize your habits, track progress, and spot patterns over time.

Reviews

No reviews yet.

Stats

0
stars
30
downloads
0
forks
6
days
3
days
3
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
8
commits

Latest Version

3 days ago

Changelog

Release 1.1.0:

  • Added click-to-open navigation from charts and summaries to task lines.
  • Added hover details for variants in grouped Summary rows.
  • Preserved timeline scroll position across updates and improved keyboard navigation.

README file from

Github

Taskscape reads a task file in your vault, works out how long each task stayed open, and draws it. It is useful for habit and self-improvement task lists where you want to see what repeats, what slipped, and how long things took.

Usage

Add a taskscape code block to any note:

```taskscape
source: TODO/Self Improve Tasks.md
```

With only source, every task and every date is shown. All other lines are optional:

Parameter What it does Default
source Path of the task file in your vault (with or without .md), or a [[wikilink]] required
view gantt or summary gantt
count Show only the last N tasks (Gantt view only) all
start Only tasks on or after this date (YYYY-MM-DD) oldest task
end Only tasks on or before this date (YYYY-MM-DD) latest task
source: TODO/Self Improve Tasks.md
view: summary
start: 2026-09-01
end: 2026-09-30

Dates are matched against a task's done date, or its due date if it has no done date. count keeps the last N tasks after the date filter is applied.

Views

1. Gantt View

Gantt draws one bar per task from its due date to its done date (or to today if it is still open).

Visualize your tasks on a timeline, track when tasks were due, when they were completed, and which ones are still pending.

[!TIP] Great for spotting patterns in your daily routine and getting a feel for your current rhythm.

  • Bars are packed into the fewest possible lanes, and tasks with the same name stay on the same lane when possible.
  • Hover a bar to see the full task name, dates, state and tags.
  • The chart opens scrolled to the latest dates.

2. Summary View

Summary groups repeating tasks into one row each:

Workout legs ×3 🚀 2026-10-23 🏁 2026-10-26

You'll see grouped overview of recurring tasks, how often tasks appear, their date ranges, and their completion states at a glance.

[!TIP] Perfect for looking back at your progress and seeing how far you've come.

  • ×N is how many times the task appears, 🚀 is its earliest done date and 🏁 is its latest done date (open if none is done).
  • Rows are sorted by name and end with small counts per state.
  • Group similar (beta) merges tasks whose names differ only slightly, such as "Workout legs" and "Workout - legs". It is off by default. Merged rows show a "variants" hint listing the original names.

The note updates automatically a moment after you save the task file.

Task Format

Taskscape reads lines in the emoji task format used by the Tasks plugin:

- [ ] Read a chapter #reading 📅 2026-10-01
- [x] Workout #daily 📅 2026-10-01 ✅ 2026-10-01
- [-] Call the bank 📅 2026-10-02 ❌ 2026-10-03

A task's state comes from its dates and markers:

State Meaning
🔵 pending No ✅ or ❌ date
🟢 on-time 📅 date = ✅ date
🟡 postponed 📅 date ≠ ✅ date
🔴 cancelled has a ❌ date

[!CAUTION] Nested Tasks

Only top-level task lines (- [ ] ...) are read. Indented sub-tasks are ignored.

Works well with Clockwork Tasks

Creating recurring tasks by hand takes time. Clockwork Tasks, another Obsidian plugin by me, lets you write your routines once and automatically generate their tasks each day.

Taskscape can visualize the tasks Clockwork Tasks creates, so you can build a routine and see your progress over time.

As a personal recommendation, keep daily tasks small—around 5–20 minutes. Schedule more demanding tasks two or three times a week, and consider adding days off. Find the pace that works for you: your life, your pace.

Installation

From the Community plugins browser: search for Taskscape, install and enable.

Manually: download main.js, manifest.json and styles.css from the latest release, put them in <your vault>/.obsidian/plugins/taskscape/, then reload and enable the plugin.

  1. Clone the repository and open its directory.
  2. Install the dependencies with npm ci.
  3. Build the plugin with npm run build.
  4. Copy the generated main.js, along with manifest.json and styles.css, into <your vault>/.obsidian/plugins/taskscape/.

Privacy

Taskscape makes no network requests, collects no telemetry, and only reads the task file named in the code block.

License

MIT