List your Todo.sh add-ons here. Include a short description and a link to the GitHub repository or other location.

Filters

Since version 2.4, todo.sh provides TODOTXT_SORT_COMMAND and TODOTXT_FINAL_FILTER, which can be used to modify the list commands’ output.

Future Tasks

Hide tasks containing a date threshold (t:YYYY-MM-DD) until the specified point in the future.

Note: The date command can be used to append date thresholds (e.g. todo.sh append <#> "t:`date -d '1 day' +%F`").
The schedule extension provides a wrapper for this.

Caveats: Currently there is no distinction between regular list commands and listall – i.e. future tasks will never be displayed.

Discussion thread

Project page

Download file

New or Enhanced Commands/Actions

To learn how to use one of those add-ons, see Creating and Installing Add-ons.

add and do / add and pri in one step

This is the example detailed here: Creating Add-ons: Examples

It allows to add an item and mark it as done in one shot with the following syntax:

todo.sh add x Helping colleague to install linux

It also allows to set a priority when adding an item using the following syntax:

todo.sh add pri A “Need to write plugin example on Gina’s wiki”

Project page

Download file

Variations:

• add and do Gina’s addx
• add and pri Gina’s adda

Archive only selected done items

This allows to archive selectively one single item or a set of items matching a given keyword.
For example to archive all done items related to project1:

todo.sh archive +project1

To archive item #17:

todo.sh archive 17

Note that if the keyword is a number it is interpreted as an item number

Project page

Download file

edit: open in text editor

To open $TODO_DIR/todo.txt in your default text editor ($EDITOR environment variable):

todo.sh edit

To open $TODO_DIR/done.txt:

todo.sh edit done

Project page

Download file

Adaptations:

• doegox
• dhein (discussion thread)
• FND (discussion thread)

cd: display directory paths

Outputs the command necessary to change the current directory to the directory holding the todotxt files, the directory holding add-ons or the directory holding the configuiration file.

Discussion thread

Project page

Download file

nav: open item’s URL in browser

todo.sh add Should have a look at http://github.com/ginatrapani ASAP

TODO: ‘Should have a look at http://github.com/ginatrapani ASAP’ added on line 111.

todo.sh nav 111

Project page

Download file

commit: record state in local Git repository

Commit all changes to existing Git repository in $TODO_DIR.

Discussion thread

Project page

Download file

birdseye: your productivity report

A Python script birdseye.py (called with the birdseye action) analyzes the todo.txt and done.txt files to generate a report of completed and incomplete items in every context and project. (Requires Python and both birdseye.py and birdseye files to run.)

Project Page

projectview: sorts tasks by projects

List tasks categorized by project.

Example:

 ===== Projects =====

- Project1 -
01 item 1 +Project1
- Project2 -
02 item 2 +Project2
04 item 4 +Project2
- Not in projects -
03 item3

Discussion thread

Project page

Download file