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.