Todotxt.rb

todo.txt with a ruby flair

About

Todotxt is a ruby CLI interface to work with a todo.txt file

Install

rake install

I might release it as a proper gem in the future…

Todotxt relies on a configuration file (.todotxt.cfg) in your home directory, which points to the location of your todo.txt. You can run

todotxt generate_cfg

to generate this file, which will then point to ~/todo.txt.

Usage

The gem will install a command, todotxt which is used to interact with your todo.txt.

Tasks:
  todotxt add | a TEXT                           # Add a new Todo item
  todotxt append | app ITEM# STRING              # Append STRING to ITEM#
  todotxt del | rm ITEM#[, ITEM#, ITEM#, ...]    # Remove ITEM#
  todotxt do ITEM#[, ITEM#, ITEM#, ...]          # Mark ITEM# as done
  todotxt dp | depri ITEM#[, ITEM#, ITEM#, ...]  # Remove priority for ITEM#
  todotxt generate_cfg                           # Create a sample todo.txt
  todotxt generate_config                        # Create a .todotxt.cfg file in your home folder, containing the path to todo.txt
  todotxt help [TASK]                            # Describe available tasks or one specific task
  todotxt list | ls [SEARCH]                     # List all todos, or todos matching SEARCH
  todotxt listproj | lsproj                      # List all projects
  todotxt lscon | lsc                            # List all contexts
  todotxt lsdone | lsd                           # List all done items
  todotxt prepend | prep ITEM# STRING            # Prepend STRING to ITEM#
  todotxt pri | p ITEM# PRIORITY                 # Set priority of ITEM# to PRIORITY
  todotxt replace ITEM# TEXT                     # Completely replace ITEM# text with TEXT
  todotxt undo | u ITEM#[, ITEM#, ITEM#, ...]    # Mark ITEM# item as not done
  todotxt version                                # Show todotxt version

Calling simply todotxt will automatically run the ls command.

Dependencies

Bugs

Please report any bugs using the GitHub Issue Tracker.