Todo Points

Track your to-do progress over time. Tag checklist items with #pN points and project tags, then view a color-coded chart of points completed by day, week, or month.

Todo Points is a read-only dashboard. It reads todos from markdown checkbox lists in a folder of your vault and shows a canvas bar chart of points completed over time. It never edits your notes — you manage tasks with Obsidian's native checkboxes.

Features

• Points via #pN tags — put a #pN tag anywhere in a task line to assign points. - [ ] Fix bug #p5 is worth 5 points (any non-negative integer works).
• Project tags — any other #tag on the task line (e.g. #house, #game) names a project. A task's points count toward each of its project tags, and tasks without one fall into other.
• Stacked bar chart — bars are stacked by project (colors derived from the project name), with a legend of per-project totals for the visible period. Click a legend item to filter to that project; click it again (or all) to restore the stacked view.
• Periods — view points completed by day (last 7), week (last 8), or month (last 6).
• Editor highlighting — #pN tags are highlighted in a soft green in both the editor and reading view.

Usage

1. In Settings → Todo Points, choose the folder that holds your todo lists (leave empty to scan the entire vault).

2. Write checkbox lists with a date header above each group of tasks:

   # 2026-10-10
   
   - [x] Fix bug #p5 #work
   - [ ] Write docs #p2 #work
   - [ ] Mow the lawn #p3 #house
   

3. Open the Todo Points view (ribbon icon or command) to see your chart.

A completed task is a [x] checkbox. The completion day comes from a date (containing a year, month, and day) on a line above the task. Supported formats include 2026-10-10, 10/10/2026, 10-10-2026, 10.10.2026, October 10, 2026, and 10 October 2026 (with optional ordinals). Tasks above the first date fall back to the file's modification time.

Installation

From the community plugins directory

1. Open Settings → Community plugins → Browse.
2. Search for "Todo Points" and install it.
3. Enable it, then set the tracked folder in Settings → Todo Points.

Manually

Copy main.js, manifest.json, and styles.css into <vault>/.obsidian/plugins/todo-points/, then enable the plugin from Settings → Community plugins.

Building

pnpm install
pnpm run dev    # watch mode
pnpm run build  # type-check + production bundle