Usage

Commands are aware of project context where available. Task assumes you store all of your projects in the same directory (defined with —-project-dir), shell aliases are your friend.

Short flags exist for all options, but the long version is used here for clarity.

List Tasks

List tasks for your current project:

task list

Not in your project directory? No problem, specify the list you’d like to interact with:

task list —-list <yourgloriouslist>

The list selection convention is consistent throughout the app.

Add a Task

task add A glorious task that should be completed

Don’t worry about quotes unless you’re doing something funky, task will glue the arguments together for you.

Complete Tasks

Complete one or more tasks:

task complete 6 1 3

Tasks are completed in reverse numerical order (10…1) to avoid re-parsing the task list after each task is completed.

Open Reminders.app

Conveniently open (or bring to the foreground) Reminders.app:

task open

---

Additional usage information is available via —-help on the command line.

Shell Aliases

The defaults may not work for you. Shell aliases are cheap and easy. Define a different project directory from bash:

export TASK_PROJECT_DIR=“${HOME}/myprettyneatprojectdir”
# List tasks in current project
alias t=“task list”
# Add task in current project
alias ta=“task add”
# Complete task(s) in current project
alias tc=“task complete”
# List task lists
alias tl=“task lists”
# Open Reminders.app
alias to=“task open”

Tweak until your heart is content without monkeying yet another config file.