Todoist integration - link Claude Code sessions to tasks and automatically track progress

GitHub stars
31

Install

/plugin install todoist@ccconfigs

Run it inside Claude Code after adding the marketplace with /plugin marketplace add dhruvbaldawa/ccconfigs.

Contents

Discovered from source

Commands 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]: url or 🔗 url if no description

Requirements:

  • A task must be linked to this session (via claude-todoist wrapper or /search)
  • The task ID is automatically read from the CLAUDE_TODOIST_TASK_ID environment 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-todoist wrapper or /search)
  • The task ID is automatically read from the CLAUDE_TODOIST_TASK_ID environment 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:

  1. Fetches all tasks from your configured project
  2. Presents an interactive fzf search menu
  3. Selected task is linked to this session (sets CLAUDE_TODOIST_TASK_ID environment variable)
  4. Task is immediately moved to "In Progress"
  5. All subsequent /todoist:attach, /todoist:done, and /todoist:unlink commands will automatically use this task
  6. 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_ID environment 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-todoist wrapper or /search)
  • The task ID is automatically read from the CLAUDE_TODOIST_TASK_ID environment 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"

Sponsors

Details

Marketplace
dhruvbaldawa/ccconfigs
Source
todoist
Category
Community

More from dhruvbaldawa/ccconfigs

All 6