majiayu000 Task Assistant
Overview
This skill enables task management via the task CLI tool backed by SQLite with
vector search. Use this skill to create, track, update, and organize tasks
during coding sessions.
Quick Start
# Create a task
task add "Implement authentication" --project Backend -d "next friday"
# Create a task with tags
task add "Fix login bug" --tag bug --tag auth
# List tasks
task list # Active tasks
task list -q "auth" # Text search
task list --tag bug # Filter by tag
task list --semantic "API integration" # Semantic search
# Update task
task update 1 --status done
# View details
task view 1
Core Operations
Creating Tasks
# Basic task
task add "Task title" "Optional description"
# With project and due date (supports datetime)
task add "Review PR" --project Work -d "tomorrow at 14:00"
# As subtask
task add "Write tests" --parent 5
# Output JSON for programmatic use
task add "Deploy fix" --json
Listing and Searching
task list # Active (non-done) tasks
task list --all # Include completed
task list -q "search term" # Text search
task list --semantic "bug fixes" # AI-powered similarity search
task list --overdue # Past due date
task list --status in-progress # Filter by status
task list --priority 2 # Filter by priority (0=normal, 1=high, 2=urgent)
task list --project "Backend" # Filter by project
Updating Tasks
task update <id> --status done # Mark complete
task update <id> --status in-progress # Start working
task update <id> --priority 2 # Set urgent
task update <id> --due "2025-12-31T14:00:00Z" # Change due date
task update <id> --title "New title" # Change title
task update <id> -D "New description" # Change description
task update <id> --project "Work" # Move to project
task update <id> --clear-project # Remove from project
Comments and Attachments
task comment <id> "Progress note here"
task attach <id> ./relevant-file.pdf
Batch Operations
# Batch create from JSON file
task batch-add --file tasks.json
# Bulk update multiple tasks
task bulk update 1 2 3 --status done
# Bulk delete
task bulk delete 4 5 6 --yes
Tag Management
task tag list # List all tags with usage counts
task tag add <id> bug priority # Add tags to a task
task tag remove <id> bug # Remove tag from task
Additional Resources
- For setup instructions (semantic search, Google Calendar): Read
references/setup_guide.md - For advanced features (recurring tasks, reports, workspaces,
multi-database): Read
references/advanced_features.md - For TUI keyboard shortcuts: Read
references/tui_reference.md - For complete API reference: Read
references/api_reference.md