Agent Purpose: Manage Taskwarrior tasks using the current project's git repository remote URL as a project ID.

Project ID Generation: Automatically slugified from git remote URL

•Example: git@github.com:zenobi-us/dotfiles.git → zenobi-us-dotfiles
•Stored in Taskwarrior project attribute for easy filtering

Core Capabilities

1. Automatic Project ID Resolution

The agent automatically:

•Detects the git repository remote URL: git config --get remote.origin.url
•Extracts owner and repo: github.com:{owner}/{repo}.git → {owner}-{repo}
•Uses this as the project filter for all task commands
•Allows manual override via environment variable: TASK_PROJECT_ID

2. Task Listing & Search

List all tasks for this project:

bash

task project:$PROJECT_ID list

Search tasks by tags:

bash

task project:$PROJECT_ID +tag list

Filter by status:

bash

task project:$PROJECT_ID status:pending list
task project:$PROJECT_ID status:completed list

Filter by priority:

bash

task project:$PROJECT_ID priority:H list
task project:$PROJECT_ID priority:L list

Complex filtering:

bash

task project:$PROJECT_ID +bug priority:H status:pending list

3. Task CRUD Operations

Add a new task:

bash

task project:$PROJECT_ID add "Task description" +tag priority:H

Create task with full attributes:

bash

task project:$PROJECT_ID add "Implementation task" project:$PROJECT_ID +feature +backend priority:M

Update existing task:

bash

task project:$PROJECT_ID 5 modify priority:H +urgent
task project:$PROJECT_ID 5 modify "New description" -old-tag +new-tag

Delete task:

bash

task project:$PROJECT_ID 5 delete

Mark task as done:

bash

task project:$PROJECT_ID 5 done

4. Task Analysis & Reporting

View task statistics:

bash

task project:$PROJECT_ID stats

Show task summary by status:

bash

task project:$PROJECT_ID summary

List active tasks:

bash

task project:$PROJECT_ID active list

5. Export & Import

Export tasks to JSON:

bash

task project:$PROJECT_ID export > backup.json

Import tasks from JSON:

bash

task import backup.json

Implementation Guidelines

When implementing commands that use this agent:

•
Always extract project ID first:
- •Run: git config --get remote.origin.url | sed -E 's/.*[:/]([^/]+)\/([^/.]+)(\.git)?$/\1-\2/'
- •Store in $PROJECT_ID variable
- •Allow override: ${TASK_PROJECT_ID:-$PROJECT_ID}
•
All task operations must include project filter:
- •Use: task project:$PROJECT_ID [filter] [command]
- •Never run task [command] without project filter in automated scripts
•
Handle edge cases:
- •No tasks found: Return empty list gracefully
- •Invalid project ID: Validate format (alphanumeric + dash only)
- •Missing .task directory: Initialize with task config report.next.labels ''
•
Provide human-readable output:
- •Parse JSON export for programmatic use
- •Format list output with clear columns and highlighting
- •Show task counts in summaries

Command Examples

Search with Multiple Filters

bash

# Find urgent bugs with high priority
task project:zenobi-us-dotfiles +bug priority:H list

# Find pending tasks with high priority
task project:zenobi-us-dotfiles status:pending priority:H +important list

Batch Operations

bash

# Mark all overdue tasks as waiting
task project:zenobi-us-dotfiles overdue modify +waiting

# Add same tag to multiple tasks
task project:zenobi-us-dotfiles 1,2,3 modify +reviewed

Complex Filtering

bash

# Find tasks matching pattern
task project:zenobi-us-dotfiles 'description~Bug' list

# Combine filters with AND/OR
task project:zenobi-us-dotfiles '(priority:H or status:pending)' list

Integration Points

This agent works with:

•Taskwarrior: Primary task management backend
•Git: Automatic project ID from repository metadata
•OpenCode Commands: /project:do:task workflow integration
•Bash/Scripts: Export/import for CI/CD automation

Reference

•Taskwarrior Documentation: https://taskwarrior.org
•Project filtering: task help | grep project
•Full filter syntax: man taskfilter or task help usage