Task Tree

to-do list or tree of checkbox nodes and text nodes to organize your work.

Supports filtering with tags, searching words, drag and drop, undo and redo, keybindings, auto saving, and viewing changes in git commit history.

Task Tree view

The Task Tree view is where you create the tree with checkbox nodes and text nodes. It is located in the Explorer view container.

Menu

Here is the Task Tree view and its menu:

Filter with tags

Here you can filter with tags. You can additionaly specify if matching nodes must have any or all of the selected tags:

Search with tags

In addition to the built-in list find (F3 keybinding) functionality, here you can search with tags. The difference with the filter is that instead of hiding nodes, here the matching nodes are highlighted:

Drag and Drop

Here you can drag and drop nodes to organize them in the order needed. Additionally, the nodes can be moved up and down using keybindings:

Undo and Redo

Undo and Redo commands are available to navigate recent changes. However, it supports at the moment only 10 changes and they disappear once the extension is restarted:

Task Tree History view

The Task Tree History view allows you to see the git commit history of a Task Tree file. It is located in the SCM view container.

The extension uses the following commands to get the git information. They are printed in the logs every time they are used.

• git rev-parse --show-toplevel: used to get the git root directory of the Task Tree file.
• git log --pretty=format:"%h %aI %s" -n 10 --follow --name-only -- "/path/to/task-tree.json": used to get the revisions of the Task Tree file.
• git show <revision-hash>:"relative/path/to/task-tree.json": used to build the tree at that revision that later is used for comparison.

By the default the extension excludes position and collapsed changes from the view. To change that set the tasktree.includePositionChanges and tasktree.includeCollapsedChanges settings to true.

Bugs after extension updates

After some of the extension updates the following bugs may appear:

• Commands that should be disabled when there is not a Task Tree file open are enabled.
• Auto saving is not working.
• An error informs that a view does not exist when in reality it does.

These bugs are related to how VSCode handles extension updates, for now to fix this execute the Developer: Reload Window command from the Command Palette after every extension update.

Support

To make suggestions or report problems with the extension, create an issue at https://github.com/AndresMunozDeveloper/vsce-task-tree/issues

For other things, send an email with the subject "VSCE-TASK-TREE" (without double quotes) at andres.munoz.developer@gmail.com. Emails without that subject will be automatically sent to trash.

Sponsor

I created this project because I needed a tool like this. Later I decided to publish it because I spent a considerable amount of time working on it so I wanted to have something to show for that time. Also because I thought that other people may find it useful too.

So, if you found it useful and would like to see new features often, consider donating/sponsoring this project using the following payment method:

• PayPal

You can also recommend it to your coworkers and friends.

Possible new features

• Markdown support: in addition to JSON files, markdown files will be supported.
• Sorting: sort nodes based on their properties.
• Migrate from Tree View API to Webview: this will allow to implement features not possible with the current view. This is a big change.
• ... and many others...