Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A web interface for the Taskwarrior todo application. Because being a neckbeard is only fun sometimes.

This branch is 60 commits behind theunraveler:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

A Web Interface for Taskwarrior

A lightweight, Sinatra-based web interface for the wonderful Taskwarrior todo application.

TaskwarriorWeb screenshot


  • ruby >= 1.9 (support for ruby < 1.9 is very unlikely, but pull requests are gladly accepted).


gem install taskwarrior-web

This will install an executable called task-web


task-web at your terminal to start it up. This will start the process, background it, and open the URL in your browser.

It uses Vegas to make the Sinatra app into an executable, so all options for Vegas are valid for task-web. Type task-web -h for more options.


The current featureset includes:

  • Viewing tasks sorted and grouped in various ways.
  • Creating a new task with a due date, project, and tags.
  • Editing and deleting tasks (only task >= 2.0).
  • task-web will pull your task config (from .taskrc) and use it to determine date formatting and when an upcoming task should be marked as "due".
  • If you are on a Mac and use, you get a dock badge showing the number of pending tasks.
  • Optional Basic HTTP Auth protection. To enable, set task-web.user and task-web.passwd in your .taskrc file.

Reporting Bugs

To report a bug, use the Github issue tracker. Since taskwarrior-web works with several different versions of task, using many different configurations, please include the output from task _version and either the output of task show or a copy of your .taskrc file when filing a bug. This helps me reproduce bugs easier.

Here is an example of a good bug report.


This project is not developed by the Taskwarrior team. Obviously, taskwarrior-web extends Taskwarrior, but the projects are separate.

Build Status

Something went wrong with that request. Please try again.