Todoist

Overview

Read Todoist tasks from synced markdown files and manage them via the Python SDK. Provides task context to other skills (e.g., life-coach planning) and allows direct task management from the CLI.

Context

• Tasks are synced to todoist-sync/tasks/ as markdown files with YAML frontmatter
• Sync freshness is tracked in todoist-sync/sync-status.yml
• Token stored at ~/.config/todoist-cli/config.json (set up via npx @doist/todoist-cli auth token)
• Triage script uses uv run --script so dependencies are handled automatically
• For project structure, labels, priorities, and collaboration model, see the "Todoist organization reference" appendix in todoist-sync/README.md

Process

Step 1: Sync (always do this first)

Run the sync script to refresh local markdown files from Todoist: