explaingit

gothenburgbitfactory/taskwarrior

★ 5,787C++Audience · generalComplexity · 2/5LicenseSetup · easy

TLDR

Taskwarrior is a command-line task manager where you type commands in a terminal to add tasks, set due dates, filter by project or priority, and mark things done. It runs on Linux, macOS, and Windows and has a large ecosystem of third-party extensions.

Mindmap

mindmap
  root((repo))
    Task Management
      Add tasks
      Mark tasks done
      Set due dates
      Filter by priority
    Installation
      Linux packages
      Homebrew macOS
      Build from source
    Ecosystem
      Third-party tools
      Hooks and extensions
      Stable data format
    Community
      GitHub Discussions
      Discord server
      Reddit community
    Project Info
      MIT license
      GitHub Sponsors
      Since 2006
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Track your personal to-do list from the terminal without needing a graphical app.

USE CASE 2

Organize tasks by project, priority, or due date and query them with flexible filters.

USE CASE 3

Build custom workflows using Taskwarrior's hooks and third-party extensions.

USE CASE 4

Replace a simple task app with a scriptable, keyboard-driven alternative.

Tech stack

C++LinuxmacOSWindowsCMake

Getting it running

Difficulty · easy Time to first run · 5min

Install via your Linux distro's package manager or Homebrew on macOS. Can also be compiled from source if needed.

MIT license, free to use, modify, and share for any purpose, including commercial projects. No restrictions.

In plain English

Taskwarrior is a command-line tool for managing tasks and to-do lists. Instead of a graphical app, you type commands in a terminal to add tasks, mark them done, filter your list by project or priority, set due dates, and query your task list in a wide variety of ways. It is written in C++ and designed to run on Linux, macOS, and Windows. The project has been in continuous development since 2006 and is maintained by a small group of volunteers under the Gothenburg Bit Factory organization. The README notes a large ecosystem of third-party tools, hooks, and extensions built around Taskwarrior, which reflects the fact that the core tool has a stable data format and command interface that others have built on top of over many years. The documentation on what those features and extensions are lives on the project website rather than in this README. Installation is available through the package managers of most major Linux distributions, including Arch Linux, Debian, Fedora, and Ubuntu. Homebrew on macOS is also a supported option. If none of those paths work, you can compile the source code directly. The community for Taskwarrior is spread across GitHub Discussions, a Discord server, and a Reddit community. The README describes contributions as welcome in many forms, including bug reports, code patches, and discussion. Development is funded through GitHub Sponsors. The README is direct about the situation: a small group of volunteers keeps the project alive, and sponsorships translate directly into hours those contributors can dedicate to development. Taskwarrior is released under the MIT license.

Copy-paste prompts

Prompt 1
How do I add a new task with a due date and assign it to a project in Taskwarrior?
Prompt 2
What Taskwarrior commands let me filter my task list by priority or project name?
Prompt 3
How do I mark a Taskwarrior task as done, and where does it go after that?
Prompt 4
What are the most useful third-party extensions or hooks for Taskwarrior?
Prompt 5
How do I install Taskwarrior on Ubuntu or macOS using a package manager?
Open on GitHub → Explain another repo

← gothenburgbitfactory on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.