
todoist
Todoist integration - link Claude Code sessions to tasks and automatically track progress
- GitHub stars
- 31
Install
/plugin install todoist@ccconfigsRun it inside Claude Code after adding the marketplace with /plugin marketplace add dhruvbaldawa/ccconfigs.
Contents
Discovered from sourceCommands 4
Add a comment with a link to the currently linked Todoist task. Useful for tracking related pull requests, documentation, commits, or other assets.
Arguments:
url(required): URL to attach (PR, commit, doc, etc.)description(optional): Human-readable description of the link
Examples:
# Attach a PR
/attach https://github.com/user/repo/pull/123
# Attach a PR with description
/attach https://github.com/user/repo/pull/123 "Add user authentication"
# Attach a commit
/attach https://github.com/user/repo/commit/abc123 "Fix login bug"
# Attach documentation
/attach https://docs.example.com/feature-spec "Feature specification"
What happens:
- Adds a comment to the linked Todoist task with the URL and description
- Comment format:
🔗 [description]: urlor🔗 urlif no description
Requirements:
- A task must be linked to this session (via
claude-todoistwrapper or/search) - The task ID is automatically read from the
CLAUDE_TODOIST_TASK_IDenvironment variable - If no task is linked, the command will fail with an error message
Implementation:
# Use TODOIST_PLUGIN_ROOT set by claude-todoist wrapper
"${TODOIST_PLUGIN_ROOT}/scripts/attach.ts" "$@"
Manually move the currently linked Todoist task to "For Review" section. Useful when you want to mark the task as complete before the session ends.
What happens:
- Moves the linked task from "In Progress" to "For Review"
- Task remains linked to the session
- Session-end hook will skip moving it (already in "For Review")
Use cases:
- Task is complete and ready for review
- You want to mark progress before taking a break
- You're switching to a different task in the same session
Requirements:
- A task must be linked to this session (via
claude-todoistwrapper or/search) - The task ID is automatically read from the
CLAUDE_TODOIST_TASK_IDenvironment variable - If no task is linked, the command will fail with an error message
Note: This does NOT unlink the task from the session. To unlink, use /unlink.
Implementation:
# Use TODOIST_PLUGIN_ROOT set by claude-todoist wrapper
"${TODOIST_PLUGIN_ROOT}/scripts/done.ts"
Search for tasks in your configured Todoist project and link one to this Claude Code session. Once linked, the task will be automatically available to all other /todoist:* commands without needing to specify which task to use.
What happens:
- Fetches all tasks from your configured project
- Presents an interactive fzf search menu
- Selected task is linked to this session (sets CLAUDE_TODOIST_TASK_ID environment variable)
- Task is immediately moved to "In Progress"
- All subsequent
/todoist:attach,/todoist:done, and/todoist:unlinkcommands will automatically use this task - Session-end hook will move it to "For Review" automatically when the session ends
Example:
> /search
→ [Interactive menu shows tasks]
→ User selects: "Fix login bug | P1 | due: tomorrow | #backend"
→ Task moved to "In Progress"
→ Session now linked to task
Implementation:
# Use TODOIST_PLUGIN_ROOT set by claude-todoist wrapper
SEARCH_SCRIPT="${TODOIST_PLUGIN_ROOT}/scripts/search-tasks.ts"
if [ ! -f "$SEARCH_SCRIPT" ]; then
echo "Error: Todoist plugin scripts not found at $TODOIST_PLUGIN_ROOT"
echo "Make sure you're using the claude-todoist wrapper to launch Claude."
exit 1
fi
# Run the search script
TASK_ID=$(bun "$SEARCH_SCRIPT" 2>&1)
if [ $? -eq 0 ] && [ -n "$TASK_ID" ]; then
# Update environment for current session
echo "CLAUDE_TODOIST_TASK_ID=$TASK_ID" >> "$CLAUDE_ENV_FILE"
export CLAUDE_TODOIST_TASK_ID="$TASK_ID"
# Move task to "In Progress"
SECTION_ID=$(jq -r '.sections.inProgress' ~/.config/ccconfigs/todoist.json)
bun "${TODOIST_PLUGIN_ROOT}/scripts/todoist-api.ts" move_task "$TASK_ID" "$SECTION_ID" > /dev/null 2>&1
echo "✓ Linked to Todoist task: $TASK_ID"
echo "Task moved to 'In Progress'"
else
echo "No task selected."
fi
Remove the link between this Claude Code session and the currently linked Todoist task. After unlinking, the session-end hook will not move the task to "For Review".
What happens:
- Clears the
CLAUDE_TODOIST_TASK_IDenvironment variable - Task remains in its current section (not moved)
- Session-end hook will skip task updates
Use cases:
- You started working on a different task
- The linked task was incorrect
- You want to prevent automatic status updates
Requirements:
- A task must be linked to this session (via
claude-todoistwrapper or/search) - The task ID is automatically read from the
CLAUDE_TODOIST_TASK_IDenvironment variable - If no task is linked, the command will display a message
Note: To link a different task after unlinking, use /search.
Implementation:
# Use TODOIST_PLUGIN_ROOT set by claude-todoist wrapper
"${TODOIST_PLUGIN_ROOT}/scripts/unlink.ts"
Hooks 2
Sponsors
Details
- Marketplace
- dhruvbaldawa/ccconfigs
- Source
- todoist
- Category
- Community