NAME

todo.pl - a command-line interface to Hiveminder

DESCRIPTION

This is a simple command-line interface to Hiveminder that loosely emulates the interface of Lifehacker.com's todo.sh script.

SYNOPSIS

todo.pl [options] list [query]
todo.pl [options] add <summary>
todo.pl [options] edit <task-id> [summary]

todo.pl tag <task-id> tag1 tag2

todo.pl done <task-id>
todo.pl del|rm <task-id>

todo.pl [options] unaccepted
todo.pl accept <task-id>
todo.pl decline <task-id>

todo.pl assign <task-id> <email>
todo.pl [options] requests

todo.pl hide <task-id> date

todo.pl comment <task-id>

todo.pl [options] download [file]
todo.pl upload <file>
todo.pl braindump
todo.pl [options] editdump

todo.pl feedback

  Options:
     --group                          Operate on tasks in a group
     --tag                            Operate on tasks with a given tag
     --pri                            Operate on tasks with a given priority
     --due                            Operate on tasks due on a given day
     --hide                           Operate on tasks hidden until this day
     --owner                          Operate on tasks with a given owner


todo.pl list
      List all tasks in your todo list.

todo.pl list due before today not complete
      List tasks that are overdue.

todo.pl list important
      Lists tasks specified by the named search 'important'.
      For more on named searches, see the CONFIG FILE section of the perldoc

todo.pl --tag home --tag othertag --group personal list
      List personal tasks not in a group with tags 'home' and 'othertag'.

todo.pl --tag cli --group hiveminders edit 3G Implement todo.pl
      Move task 3G into the hiveminders group, set its tags to
      "cli", and change the summary.

todo.pl --tag "" edit 4J
      Delete all tags from task 4J

todo.pl tag 4J home
      Add the tag 'home' to task 4J

todo.pl braindump
      Open up $EDITOR to braindump tasks

todo.pl --tag sometag editdump
      Download and edit tasks with tag 'sometag'.
      Updates tasks after $EDITOR completes.

todo.pl feedback
      Open up $EDITOR to send feedback

CONFIG FILE

The config file (in $ENV{HOME}/.hiveminder) is YAML and contains the properties like email and password. If you ever need to reconfigure todo.pl, you can edit these values or just delete the file and todo.pl will reconfigure itself automatically.

To turn off colored output all the time, add the following to your config:

color: off

Named searches can be added to the config with a snippet like the following:

named_searches:
  something: "due before today tag stuff"

CONTRIBUTORS

Marc Dougherty <muncus@gmail.com> added support for named queries, and queries on the command line

LICENSE

This software is copyright 2006-2008 Best Practical Solutions, LLC.

You may use, modify and redistribute it however you'd like to. Feel free to fold, spindle or mutilate it, too.