todo

Synchronize tasks bidirectionally across Taskwarrior, Things 3, and Asana.

Updated Oct 1, 2024
One-click install
npx skills add https://github.com/einargudnig/dotfiles --skill todo-einargudnig
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: todo
Source: https://github.com/einargudnig/dotfiles/tree/main/claude/skills/todo
Command: npx skills add https://github.com/einargudnig/dotfiles --skill todo-einargudnig

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Centralizes and synchronizes tasks so Taskwarrior remains the source of truth while preventing duplicate, stale, or missing items across Things 3 and Asana and automating completion push-back.

Core Features & Use Cases

  • Bidirectional sync: Import tasks from Things 3 and Asana and push completed tasks back to their sources.
  • LLM filtering for Things 3: Use a local Ollama model to filter mobile captures so only developer-relevant work enters Taskwarrior.
  • Asana subtask and comment fidelity: Preserve subtask hierarchies via depends and sync Asana comments as Taskwarrior annotations.
  • Stale task detection & real-time hooks: Detect deleted or completed source tasks and mark them done in Taskwarrior, plus an on-exit hook for immediate push-back.
  • Automated scheduling: Runs periodic sync via launchd with logs and dry-run preview support.

Quick Start

Ask the assistant to show your next recommended task by saying what should I work on.

Frequently Asked Questions about todo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync Taskwarrior with Things 3 and Asana?

Taskwarrior sync with Things 3 and Asana is managed bidirectionally, establishing Taskwarrior as the source of truth. Completed tasks push back to their original sources automatically, while imports preserve Asana subtask hierarchies and comments.

Can I use a local LLM to filter Things 3 imports for Taskwarrior?

Yes, you can use a local Ollama model to filter Things 3 imports. This ensures only developer-relevant mobile captures enter Taskwarrior, preventing clutter from non-essential tasks.

Do I need a todo-sync CLI to push completed tasks back to Asana?

Yes, a configured todo-sync CLI is required to enable on-exit hooks for real-time completion push-back. You also need an Asana personal access token stored in the todo-sync TOML configuration.

How does stale task detection work when syncing Taskwarrior?

Stale task detection works by identifying deleted or completed source tasks in Things 3 and Asana. Once detected, the corresponding items are automatically marked done in Taskwarrior to maintain accurate lists.

Can I run periodic Taskwarrior sync automatically in the background?

Yes, periodic sync runs can be automated via launchd scheduling. This automated execution supports logging and includes a dry-run preview mode to verify changes before applying them.

How are Asana subtasks and comments handled during task synchronization?

Asana subtask hierarchies are preserved using Taskwarrior's depends functionality, while Asana comments are synced directly as Taskwarrior annotations to maintain full context and history.