ClawHub

taskwarrior

Workspace-local task management powered by Taskwarrior. Add, organize, and track tasks by project, tags, due dates, and priority with all data stored inside the active workspace.

Audits

Pass
ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install taskwarrior

Taskwarrior (Workspace-Local Tasks) — AgentSkill

Skill name

taskwarrior

Purpose

Manage tasks using Taskwarrior as the backend with data stored inside the current workspace. This skill provides a safe, workspace-scoped wrapper for common Taskwarrior operations (add/list/modify/done/projects/tags/due/priority/annotations).

Runtime requirements (ClawHub)

This skill requires Taskwarrior to already be available in the runtime environment (e.g., included in the base image).

  • Validation: run task --version
  • If missing: report the dependency and instruct the environment owner to install system package taskwarrior (some distros package it as task).

This skill does not perform system-level installs (no apt, brew, dnf, etc.).

Workspace root resolution (portable)

The skill resolves the workspace root at runtime:

  1. If set, use the first available of:
    • OPENCLAW_WORKSPACE
    • WORKSPACE
    • PROJECT_DIR
    • REPO_ROOT
  2. Otherwise, fallback to the current working directory.

All Taskwarrior data is stored under: <workspace>/.openclaw/taskwarrior/

Workspace-local Taskwarrior home

  • taskrc: <workspace>/.openclaw/taskwarrior/taskrc
  • data dir: <workspace>/.openclaw/taskwarrior/.task/

Every Taskwarrior command MUST run with:

  • TASKRC=<workspace>/.openclaw/taskwarrior/taskrc
  • (optional) TASKDATA=<workspace>/.openclaw/taskwarrior/.task

Never write to global ~/.task or ~/.taskrc unless the user explicitly asks to use global storage.

Core workflow

  1. Check dependency

    • Run: task --version
    • If missing: stop and return dependency instructions (see references/clawhub_notes.md).

  2. Initialize workspace storage

    • Ensure directories exist:
      • <workspace>/.openclaw/taskwarrior/
      • <workspace>/.openclaw/taskwarrior/.task/
    • Ensure <workspace>/.openclaw/taskwarrior/taskrc contains at least:
      • data.location=<workspace>/.openclaw/taskwarrior/.task
      • confirmation=off
      • verbose=off

  3. Execute requested operations

    • Prefer stable/common commands (see references/taskwarrior_cheatsheet.md).

  4. Verify results

    • After any mutation, show a focused task <id> info or filtered task <filter> list.

Supported operations (useful subset)

  • Add tasks: task add ...
  • List tasks: task list, task <filter> list
  • Modify tasks: task <id> modify ...
  • Complete tasks: task <id> done
  • Start/stop: task <id> start|stop (if desired)
  • Projects/tags: task projects, task tags, project:<name>, +tag, -tag
  • Due/priorities: due:<date>, priority:H|M|L
  • Notes: task <id> annotate "..."

Safety

Follow references/safe_command_policy.md. Highlights:

  • No delete/purge unless explicitly requested.
  • Avoid broad bulk changes without previewing the matching set.
  • No global config writes by default.

References

  • references/workspace_data_layout.md
  • references/taskwarrior_cheatsheet.md
  • references/safe_command_policy.md
  • references/examples.md
  • references/clawhub_notes.md