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.

Settings

• enableFileWatcher: Enable watching for changes of opened file in Task Tree view by other programs
• hideTagNamesWhenTheyAllHaveSymbols: Hide tag names when they all have symbols in a node of the Task Tree view
• includeCollapsedChanges: Include collapsed changes in Task Tree History view
• includePositionChanges: Include position changes in Task Tree History view

After an update

After the extension is updated it is highly recommended to execute the Developer: Reload Window command from the Command Palette to avoid unexpected bugs in VSCode.

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) to andres.munoz.developer@gmail.com. Emails without that subject will be automatically sent to trash.

Sponsor

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...