By spm1001
Todoist CLI with GTD coaching — outcomes, weekly review, pattern detection
Status: Beta — actively developed Works with: Claude Code, standalone CLI Install: via batterie-de-savoir marketplace Requires: Python 3.11+, Todoist account + API token
Todoist CLI with GTD coaching for Claude Code.
A Python CLI for Todoist that understands GTD semantics — outcomes vs actions, team priorities, weekly reviews. Designed as a Claude Code skill but works standalone too.
Install via batterie-de-savoir marketplace:
/plugin marketplace add spm1001/batterie-de-savoir
/plugin install todoist-gtd
Then set up authentication and verify:
todoist auth # Prints setup instructions
todoist auth --token YOUR_TOKEN # Store your API token
todoist doctor # Verify everything works
Get your API token from Todoist developer settings, then store it:
todoist auth --token YOUR_API_TOKEN
Token is stored in macOS Keychain (if available) or in a file with restricted permissions on Linux.
# List projects
todoist projects
# Tasks in a project
todoist tasks --project "@Work"
# Filter syntax (same as Todoist app)
todoist filter "today"
todoist filter "assigned to: Alex & @waiting-for"
# Complete a task
todoist done <task-id>
# Add a task
todoist add "Review proposal" --project "@Work" --section "Now"
# Utility commands
todoist doctor # Check setup and diagnose issues
todoist version # Show version and commit info
When installed, Claude gains:
Claude triggers this skill on phrases like:
This skill assumes a specific Todoist setup:
| Concept | Todoist Implementation |
|---|---|
| Outcomes | Sections in "Desired Outcomes Q1" project |
| Team Priorities | Sections in a separate project |
| Next Actions | Tasks under outcome sections |
| Waiting For | @Wait project or waiting-for label |
Adapt the project names in SKILL.md to match your structure.
todoist-gtd/
├── src/todoist_gtd/ # Python package
│ ├── cli.py # Main CLI (todoist command)
│ ├── auth.py # Token-based authentication
│ ├── token_store.py # Keychain integration
│ ├── common.py # Shared utilities
│ └── flatten.py # Subtask flattening (todoist-flatten)
├── skills/coaching/ # Claude Code skill
│ ├── SKILL.md # Skill definition
│ └── references/ # GTD vocabulary, patterns, coaching
├── pyproject.toml # Package config + entry points
└── docs/ # Field reports and design docs
"Token revoked or expired"
todoist auth --token TOKEN with a fresh token from Todoist settings."Keychain is locked" (macOS)
security unlock-keychain).TODOIST_API_KEY environment variable instead."Request timed out"
"Could not connect to Todoist"
"Task not found or invalid"
"Cannot move task between workspaces"
"Rate limited by Todoist"
If you're joining as a contributor:
bon list --ready shows available workWhen using Claude to contribute:
MIT
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Suite-level utilities for the Batterie de Savoir suite — cross-plugin updates and maintenance
Session lifecycle, code review, data analysis, and behavioral skills for Claude Code. Best with: bon, garde-manger
Fast browser automation via Chrome DevTools Protocol. Requires: passe CLI (uv tool install passe), Chrome with CDP
Session lifecycle skill (couvert) + ping diagnostic MCP.
Collaborative editing layer for Claude and Sameer — Yjs Y.Text + CodeMirror 6 + pycrdt
npx claudepluginhub spm1001/batterie-de-savoir --plugin todoist-gtdGTD workflow automation for Obsidian vaults: capture, triage, route, focus
Task and project management with the tdn CLI. Helps Claude work as a productivity assistant, managing tasks, projects, and areas stored as markdown files on disk.
Todoist for Claude Code — manage tasks, projects, labels, and workflows from your terminal.
GTD mentor for inbox processing, weekly reviews, and coaching. Integrates with Apple Reminders and macOS Calendar.
Manage tasks, plan your day, and build up memory of important context about your work. Syncs with your calendar, email, and chat to keep everything organized and on track.
Solo entrepreneur workspace with Mission Control task management, Eisenhower matrix, and AI agent team operations