GothenburgBitFactory/taskwarrior
Taskwarrior
Taskwarrior is a command-line task manager that lets you create, modify, filter, and complete to-do items directly from the terminal. It stores all tasks in a single plain-text file for portability and manual editing, and includes a custom expression language for selecting tasks by status, priority, tags, and date ranges.
The tool distinguishes itself through several integrated capabilities. It computes a numeric urgency score for each task based on weighted factors like age, tags, and due date to determine ordering. A recurrence template engine generates new task instances from a template after completion, supporting flexible schedules. An event-driven hook system runs external scripts at defined lifecycle points before or after task operations for automation and integration. A virtual tag system assigns dynamic tags based on task state and attributes, while context-based filter presets limit the visible task list to a specific subset. The named date expression parser interprets human-readable strings like "today" or "eom" into absolute timestamps.
Beyond core task management, the project supports user-defined custom fields to extend the task schema, JSON import and export for integration with other tools, and task synchronization across multiple installations. It also provides interactive task review, duration value specification, and formatted report views. The documentation covers installation via package managers, source tarballs, and git repository cloning.
Features
- Command Line Task Lists - Provides a full-featured command-line task manager for creating, modifying, filtering, and completing to-do items.
- Recurring Task Scheduling - Defines tasks that automatically regenerate on a fixed schedule such as daily or weekly.
- Task Urgency Scores - Computes a numeric urgency score for each task based on weighted factors like age, tags, and due date.
- Task Attribute Modifications - Enables updating any attribute of an existing task, such as description, priority, tags, or due date.
- Task Creations - Provides a command to create new to-do items with descriptions and optional metadata.
- Task List Management - Provides a command-line interface to list all tasks with filtering and sorting by user-defined criteria.
- Priority Management - Assigns priority levels to tasks to influence their ordering and urgency calculations.
- Task Synchronization Servers - Ships a built-in sync server that keeps task lists consistent across multiple machines.
- Flat-File Storage - Stores all tasks in a single plain-text file using a custom serialization format for portability.
- Automation Hooks - Runs custom scripts before or after task operations to enforce rules or trigger actions.
- Task Status Changes - Allows users to mark tasks as complete, recording the completion date for tracking progress.
- Expression-Based Filters - Provides a custom expression language for selecting tasks by status, priority, tags, and date ranges.
- User Data Syncing Utilities - Synchronizes task data across multiple devices so changes on one machine appear on all others.
- Task Automation Scripts - Runs external scripts before or after task operations to enforce rules, send notifications, or transform data.
- Task Filtering - Selects a subset of tasks by criteria such as status, project, tag, or due date to narrow the view.
- Task Text and Metadata Searches - Searches tasks by text, tags, priority, and date ranges using a flexible query syntax.
- Task Hooks - Runs custom scripts automatically before or after task operations to add behavior.
- Task Tagging Systems - Attaches labels to tasks for categorization and filtering, including a virtual tag system for dynamic tags.
- Urgency Scoring - Computes a numeric urgency score from weighted factors like age, tags, and due date to order tasks.
- Event-Driven Hook Systems - Executes external scripts at defined lifecycle points before or after task operations for automation.
- Task Ordering - Computes a numeric urgency score for each task based on priority, age, and tags to determine ordering.
- Urgency-Based Task Orderings - Computes a numeric urgency score for each task based on age, tags, and due date to determine ordering.
- Recurrence Templates - Generates new task instances from a template after completion, supporting flexible recurring schedules.
- Lifecycle Hook Scripts - Runs custom scripts at defined points in the task lifecycle to automate actions or enforce policies.
- Formatted Task Summaries - Generates formatted summaries of tasks with counts, status breakdowns, and overdue item highlights.
- Cross-Device Task Synchronization - Transfers task data between multiple installations so changes made on one machine appear on all others.
- JSON Data Exports - Outputs task data in structured JSON format and loads task data from JSON files for integration.
- Task Metadata Customization - Extends the default task schema with user-defined fields to store project-specific metadata.
- Reference Date Derivations - Parses human-readable date expressions like 'today' or 'eom' into absolute timestamps for task scheduling.
- Duration Value Retrievers - Parses human-readable duration strings like '1h' or '2w' for task estimates and recurrence intervals.
- JSON Data Import - Provides a built-in command to import task data from JSON files into the task database.
- Manifest-Defined Tasks - Extends the task schema with user-defined fields to store project-specific metadata alongside built-in properties.
- Custom Task Attribute Definitions - Allows users to define custom fields on tasks to store project-specific metadata.
- Named Date Expressions - Parses human-readable date strings like 'today' or 'eom' into absolute timestamps for task scheduling.
- Formatted Task Reports - Ships built-in report views that display tasks in formatted tables with status and urgency summaries.
- Event-Driven Scripting - Runs custom scripts triggered by task lifecycle events to enforce policies, send notifications, or integrate with other tools.
- Context-Based Filter Presets - Applies predefined filter presets to limit the visible task list to a specific subset of tasks.
- Context Presets - Ships predefined filter presets that limit the visible task list to a specific subset of tasks.
- Dynamic Tags - Assigns dynamic tags based on task state and attributes, enabling filtering without explicit user-defined labels.
- External Script Execution - Invokes arbitrary programs or scripts from within the task management workflow.
- Event-Triggered Scripts - Runs external scripts before or after task operations to enforce rules or send notifications.
- Custom Data Fields - Extends the task schema with custom fields to store project-specific data.
- Time and Task Management - Command-line based task and to-do list manager.
