MCPcopy Index your code
hub / github.com/delashum/obsidian-checklist-plugin

github.com/delashum/obsidian-checklist-plugin @2.2.14

Chat with this repo
repository ↗ · DeepWiki ↗ · release 2.2.14 ↗ · + Follow
70 symbols 154 edges 20 files 0 documented · 0% updated 18mo ago2.2.14 · 2025-01-11★ 47571 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

LOOKING FOR ANOTHER MAINTAINER TO HELP OUT There's quite a bit of work to do on this plugin still and i've been neglecting it because work is too busy. I would love some help, or at least someone who could approve PRs and triage issues. Send me an email at delashum@gmail.com if you're interested.

obsidian-checklist-plugin

This plugin consolidates checklists from across files into a single view.

screenshot-main

Usage

After enabling this plugin, you will see the checklist appear in the right sidebar. If you do not you can run the Checklist: Open View command from the command palette to get it to appear.

By default block of checklist items you tag with #todo will appear in this sidebar.

You can complete checklist items by checking them off in your editor (e.g. - [ ] -> - [x]) or by clicking a checklist item in the sidebar which will update your .md file for you

Configuration

screenshot-settings

Tag name: The default tag to lookup checklist items by is #todo, but may be changed to whatever you like

Show completed?: By default the plugin will only show uncompleted tasks, and as tasks are completed they will filter out of the sidebar. You may choose to show all tasks

screenshot-completed

Show All Todos In File?: By default the plugin will only show tasks in the block that is tagged - changing this will show all tasks present in a file if the tag is present anywhere on the page.

Group by: You can group by either file or tagname. If you choose to group by tag name they will appear in the order that they first appear in your files (or last depending on sort order)

screenshot-tags

Sort order: By default checklist items will appear in the order they appear in the file, with files ordered with the oldest at the top. This can be changed to show the newest files at the top.

Glob File Matching

The "Include Files" setting uses Glob file matching. Specifically the plugin uses minimatch to match the file pattern - so any specific oddities will come from that plugin.

Couple of common examples to help structure your glob:

  • !{_templates/**,_archive/**} will include everything except for the two directories _templates and _archive.
  • {Daily/**,Weekly/**} will only include files in the Daily & Weekly directories

I recommend the Digital Ocean Glob Tool for figuring out how globs work - although the implementation is not identical to minimatch so there might be slight differences.

Extension points exported contracts — how you extend this code

HTMLAttributes (Interface)
(no doc)
svelte-custom.d.ts
TodoSettings (Interface)
(no doc)
src/settings.ts

Core symbols most depended-on inside this repo

getSettingValue
called by 27
src/main.ts
updateSettings
called by 11
src/main.ts
refresh
called by 6
src/view.ts
getTagMeta
called by 5
src/utils/helpers.ts
regexPlugin
called by 4
src/plugins/plugin-helper.ts
renderView
called by 3
src/view.ts
formTodo
called by 3
src/utils/tasks.ts
getAllLinesFromFile
called by 3
src/utils/helpers.ts

Shape

Function 37
Method 25
Class 6
Interface 2

Languages

TypeScript100%

Modules by API surface

src/utils/helpers.ts19 symbols
src/view.ts17 symbols
src/main.ts9 symbols
src/utils/tasks.ts6 symbols
src/settings.ts6 symbols
src/worker_helpers.ts3 symbols
src/svelte/clickOutside.directive.ts3 symbols
src/utils/files.ts2 symbols
src/plugins/plugin-helper.ts2 symbols
svelte-custom.d.ts1 symbols
src/utils/groups.ts1 symbols
src/plugins/link.ts1 symbols

For agents

$ claude mcp add obsidian-checklist-plugin \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page