Wunderline

Wunderlist for your command line!

Installation

npm install -g wunderline

Authentication

Wunderline requires you to create your own Wunderlist application and store the client id and an access token locally. You can create a new application here.

When creating an application you will be asked for an app url and an auth callback url, you can just use dummy values for these.

Once that's done, click CREATE ACCESS TOKEN as highlighted here:

Then create a .wunderlinerc in your home directory that looks like this, copying the CLIENT ID field and newly created access token:

{
  "client_id": "...",
  "access_token": "..."
}

Wunderline uses rc to load configuration options so there are many more options as to how and where you can store your config variables.

Usage

$ wunderline --help

Commands:

    add [task]      Add a task to your inbox
    inbox           View your inbox
    starred         View starred tasks
    today           View tasks due today
    week            View tasks due this week
    all             View all of your tasks
    overdue         View overdue tasks
    search [query]  Search your tasks
    open            Open Wunderlist
    export          Export your data
    whoami          Display effective user
    flush           Flush the application cache
    help [cmd]      display help for [cmd]

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

Adding Tasks

Add tasks to your inbox.

$ wunderline add Hello, World!

The add command also supports creating tasks from stdin.

$ cat todo.txt | wunderline add --stdin

You can also add tasks to a list, that list will be created if it doesn't exist.

$ wunderline add Hello, World! --list Greetings

Due dates are now supported using one of the following options.

$ wunderline add Hello, World! --today --tomorrow --due 2015-12-25

Viewing Lists

All of Wunderlists smart lists are supported, so there are various ways to see what tasks you have to do.

$ wunderline inbox
$ wunderline starred
$ wunderline today
$ wunderline week
$ wunderline all

Open

Open Wunderlist, defaults to opening the web app.

$ wunderline open

If you specify mac as the platform in your .wunderlinerc wunderline will open the native app for you.

{
  "platform": "mac"
}

Export

Exports your data to stdout.

$ wunderline export > export.json

Bonus Points

Ack / Ag

You could search for the word "todo" in a project and pipe the input into wunderline. Each line will be parsed and turned into a task, be careful because this could result in a lot of tasks!

This might be a terrible idea, even useless at best, but hopefully it will get you thinking.

$ ag todo --nocolor --nofilename | wunderline add -s

Debugging

wunderline uses request so if you want to inspect api requests just set the NODE_DEBUG variable.

$ NODE_DEBUG=request wunderline inbox

dhaffner / wunderline