taskwarrior

What This Skill Does

The taskwarrior skill enables sophisticated, workspace-aware task management directly within your OpenClaw environment. By leveraging the robust Taskwarrior engine, this skill allows you to track projects, manage priorities, set due dates, and add detailed annotations without cluttering your system-wide task list. It automatically initializes a hidden directory structure within your active workspace—specifically at <workspace>/.openclaw/taskwarrior/—ensuring that all your task data, configurations, and metadata remain strictly local to your current project. This approach provides a clean, portable workflow where your task list travels with your codebase, making it ideal for collaborative projects or keeping specific project requirements separate from your daily personal to-dos.

Installation

To install this skill, use the ClawHub command within your OpenClaw terminal: clawhub install openclaw/skills/skills/aghareza/taskwarrior. Before execution, ensure the system dependency 'taskwarrior' (or 'task') is pre-installed in your environment. The skill performs a validation check upon first run by executing task --version; if it fails, you must install the native package via your system's package manager. No external network connections are required once installed.

Use Cases

Use this skill to maintain project-specific roadmaps, manage complex developer backlogs, or keep track of documentation tasks alongside your code. Because it supports tagging and project categorization, you can easily filter large lists, prioritize critical bugs (priority:H), or track long-term architectural tasks. It is perfect for developers who prefer command-line efficiency over heavy GUI tools.

Example Prompts

1. "Add a new task to research the API rate limiting issue, set priority to high, and add it to the backend-migration project."
2. "Show me all pending tasks for the current project that are due this week."
3. "Mark task 4 as complete and add a note explaining that the fix was applied to the production branch."

Tips & Limitations

• Data Isolation: All task data is contained within the .openclaw directory of your workspace; deleting this folder removes all tasks for that project.
• Safety First: This skill adheres to strict safety policies, meaning broad modifications or deletions are gated to prevent accidental data loss. Always verify your filter lists before running batch modifications.
• Portability: Because the storage is relative to the workspace root, copying your workspace to a new machine will retain your task history, provided the Taskwarrior binary is available in the new environment.