Todo Sync

Syncs global Claude directory todos and plans into the project's .claude directory.

3|1|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/nsheaps/ai-mktpl --skill todo-sync-nsheaps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Todo Sync
Source: https://github.com/nsheaps/ai-mktpl/tree/main/plugins/todo-sync/skills/todo-sync
Command: npx skills add https://github.com/nsheaps/ai-mktpl --skill todo-sync-nsheaps

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill keeps your project in sync with global task and plan data, reducing manual merging and confusion when todos and plans evolve in the Claude environment.

Core Features & Use Cases

  • Automatically merge local and global todos after TodoWrite, deduplicating entries by content.
  • Sync plans from the global Claude directory to the project to maintain alignment.
  • Troubleshooting guidance and file-location mappings for quick diagnosis.

Quick Start

Invoke a TodoWrite operation to trigger automatic synchronization of todos and plans into your project.

Frequently Asked Questions about Todo Sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically sync todos across multiple Claude projects?

You can sync todos across multiple Claude projects by applying post-tool-use hooks that map global Claude directory files to the current project's .claude directory. This enforces cross-project task tracking and deduplication to keep project state aligned.

What is the best way to merge local and global plans in a development workflow?

The best way to merge local and global plans in a development workflow is to use automated synchronization that deduplicates entries by content. This maintains plan alignment and reduces manual merging confusion when tasks evolve in the Claude environment.

How do I trigger automatic synchronization of todos and plans into my project?

To trigger automatic synchronization of todos and plans into your project, simply invoke a TodoWrite operation. The post-tool-use hooks will then automatically map and sync the global data to your local project directory.

Do I need any external dependencies to synchronize plans from the global Claude directory?

You do not need any external dependencies to synchronize plans from the global Claude directory. The synchronization operates entirely within the Claude environment using post-tool-use hooks and global-to-local file mappings.

Why are my cross-project todo entries duplicating after synchronization?

Cross-project todo entries may duplicate if the synchronization deduplication logic encounters content mismatches. The sync process applies deduplication by content to merge local and global todos, preventing exact duplicate entries from persisting.

Can I get troubleshooting guidance for file-location mappings during plan synchronization?

Yes, you can get troubleshooting guidance for file-location mappings during plan synchronization. The skill provides file-location mappings for quick diagnosis to help resolve issues with global-to-local sync behavior.