{"id":50523228,"url":"https://github.com/ds1/multi-claude-sync","last_synced_at":"2026-06-03T06:04:12.590Z","repository":{"id":334867715,"uuid":"1143090296","full_name":"ds1/multi-claude-sync","owner":"ds1","description":"Coordination system for running multiple Claude Code instances across related projects","archived":false,"fork":false,"pushed_at":"2026-02-03T22:16:10.000Z","size":108,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-02-03T22:17:22.077Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ds1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-27T06:55:02.000Z","updated_at":"2026-02-03T22:16:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ds1/multi-claude-sync","commit_stats":null,"previous_names":["ds1/multi-claude-sync"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ds1/multi-claude-sync","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ds1%2Fmulti-claude-sync","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ds1%2Fmulti-claude-sync/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ds1%2Fmulti-claude-sync/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ds1%2Fmulti-claude-sync/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ds1","download_url":"https://codeload.github.com/ds1/multi-claude-sync/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ds1%2Fmulti-claude-sync/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33850652,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-03T02:00:06.370Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-03T06:04:08.097Z","updated_at":"2026-06-03T06:04:12.580Z","avatar_url":"https://github.com/ds1.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Multi-Claude Sync\n\nA coordination system for running multiple Claude Code instances across related projects.\n\n## The Problem\n\nWhen working on interconnected projects (e.g., a desktop app + its backend API), each Claude Code instance operates independently with no awareness of the other. This leads to:\n\n- API contracts getting out of sync\n- Duplicate or conflicting implementations\n- Lost context between sessions\n- Manual copy-pasting of decisions between instances\n\n## The Solution\n\nA shared sync file and workflow that enables:\n\n- **Cross-project coordination** - Both instances read/write to a shared sync file\n- **API contract documentation** - Single source of truth for request/response formats\n- **Decision tracking** - Architecture decisions documented with rationale\n- **Inter-Claude communication** - Attention flags when one instance needs info from the other\n- **Commit/push logging** - Track changes across both projects\n\n## Quick Start\n\n### 1. Set Up the Sync File\n\nPlace `SYNC.md` in the parent directory of your projects:\n\n```\nyour-workspace/\n├── SYNC.md                 # Shared sync file\n├── project-frontend/       # Project 1\n└── project-backend/        # Project 2\n```\n\nCopy `templates/SYNC.md` and customize for your projects.\n\n### 2. Update Each Project's CLAUDE.md\n\nAdd sync file instructions to each project. See `templates/CLAUDE-ADDITIONS.md`.\n\n### 3. Start Both Instances\n\n```bash\n# Terminal 1\ncd project-frontend\nclaude\n\n# Terminal 2\ncd project-backend\nclaude\n```\n\n### 4. Initialize Each Session\n\nGive each Claude its alias and point it to the sync file:\n\n```\nYour alias is \"cf\" (Claude Frontend). I also have \"cb\" (Claude Backend) running.\n\nBefore we begin:\n1. Read the sync file: /path/to/SYNC.md\n2. Check \"Attention Needed \u003e For [this-project]\" for items from the other instance\n3. Check \"User Input Needed\" - alert me immediately if there are items\n4. Review recent entries in \"Sync Log\" and \"Commit/Push Log\"\n\nSummarize anything important, then we can proceed.\n```\n\n## Documentation\n\n- **[WORKFLOW-GUIDE.md](./WORKFLOW-GUIDE.md)** - Detailed guide for the multi-Claude workflow\n- **[templates/SYNC.md](./templates/SYNC.md)** - Template sync file to customize\n- **[templates/CLAUDE-ADDITIONS.md](./templates/CLAUDE-ADDITIONS.md)** - What to add to each project's CLAUDE.md\n- **[examples/](./examples/)** - Real-world examples\n\n## Key Concepts\n\n### Aliases\n\nGive each Claude instance a short alias (e.g., `cm`, `cw`, `cf`, `cb`) to:\n- Keep track of which instance you're talking to\n- Reference in the sync file\n- Use in commit prefixes (e.g., `[cm] Add auth flow`)\n\n### Sync File Sections\n\n| Section | Purpose |\n|---------|---------|\n| **API Contract** | Request/response formats for all endpoints |\n| **Coordinated Task List** | Shared tasks with status and dependencies |\n| **Commit/Push Log** | Track commits and pushes from both projects |\n| **Decisions (Resolved)** | Finalized architecture decisions |\n| **User Input Needed** | Items requiring YOUR decision |\n| **Attention Needed** | Inter-Claude communication |\n\n### Communication Flow\n\n```\nClaude A needs info from Claude B:\n1. Claude A adds to \"Attention Needed \u003e For Project B\"\n2. You tell Claude B: \"Check the sync file\"\n3. Claude B reads, responds in sync file\n4. You tell Claude A: \"Check the sync file for response\"\n```\n\n### Pre-Push Alignment Review\n\nBefore pushing, verify both sides are compatible:\n\n1. Each Claude lists unpushed commits in Commit/Push Log\n2. One Claude creates alignment table (API → Client mappings)\n3. Other Claude confirms: \"✅ CONFIRMED ALIGNED\"\n4. Both push after confirmation\n\nThis catches API contract drift before it ships. Zero integration conflicts when both sides verify.\n\n### Sprint Retrospective\n\nAt end of session, conduct cross-review:\n\n1. Each Claude writes summary of accomplishments\n2. Share summaries between instances for review\n3. Each notes corrections/additions to the other's summary\n4. Iterate until consensus reached\n5. Combined summaries become official record\n\n**Why this matters:** Two perspectives catch omissions. The retro often reveals the \"meta-accomplishment\" - not just code shipped, but process improvements made.\n\n## Tips\n\n- **Start every session** by having Claude read the sync file\n- **Log commits immediately** after making them\n- **Use the sync file** for anything affecting both projects\n- **Be explicit** about which project/Claude you're addressing\n- **Clean up periodically** - archive old resolved items\n\n## Contributing\n\nThis workflow evolved from real multi-project development. If you have improvements or variations that work well, contributions are welcome.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fds1%2Fmulti-claude-sync","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fds1%2Fmulti-claude-sync","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fds1%2Fmulti-claude-sync/lists"}