[GH-ISSUE #13] Fork with multi-project support - potential upstream interest? #9

Closed
opened 2026-03-03 18:49:55 +03:00 by kerem · 2 comments
Owner

Originally created by @kmichels on GitHub (Jan 9, 2026).
Original GitHub issue: https://github.com/OthmanAdi/planning-with-files/issues/13

Hey! I built a fork called multi-manus-planning that adds:

  • Multiple projects from one CWD via .planning/index.md coordinator
  • Separate planning/source paths (planning files in Obsidian, code elsewhere)
  • SessionStart hook for cross-machine git sync

Wanted to let you know and say thanks for the original - it is a great foundation. Happy to discuss if any of these features would fit upstream.

Originally created by @kmichels on GitHub (Jan 9, 2026). Original GitHub issue: https://github.com/OthmanAdi/planning-with-files/issues/13 Hey! I built a fork called [multi-manus-planning](https://github.com/kmichels/multi-manus-planning) that adds: - **Multiple projects from one CWD** via `.planning/index.md` coordinator - **Separate planning/source paths** (planning files in Obsidian, code elsewhere) - **SessionStart hook** for cross-machine git sync Wanted to let you know and say thanks for the original - it is a great foundation. Happy to discuss if any of these features would fit upstream.
kerem closed this issue 2026-03-03 18:49:55 +03:00
Author
Owner

@OthmanAdi commented on GitHub (Jan 9, 2026):

Hey @kmichels! Thanks for sharing this — really cool to see where you took it.

The multi-project coordinator is clever. I've been using this primarily for single-project workflows, but I can see how juggling multiple repos with separate planning locations would be useful, especially the Obsidian setup.

A few questions to understand your use case better:

  1. Which feature has been most valuable in practice? The multi-project switching, the separate paths, or the SessionStart sync?

  2. The SessionStart hook for git sync — this one feels like it could be broadly useful even for single-project users. How's it working for you across machines?

  3. The .planning/index.md coordinator — does Claude pick this up automatically, or do you have to prompt it to check the coordinator first?

I'll add a link to your fork in the README under a "Community Forks" section so others with similar needs can find it.

Thanks again for building on this and for the kind words. Let's keep the conversation going — always interested in how people are adapting the pattern.

<!-- gh-comment-id:3728930380 --> @OthmanAdi commented on GitHub (Jan 9, 2026): Hey @kmichels! Thanks for sharing this — really cool to see where you took it. The multi-project coordinator is clever. I've been using this primarily for single-project workflows, but I can see how juggling multiple repos with separate planning locations would be useful, especially the Obsidian setup. A few questions to understand your use case better: 1. **Which feature has been most valuable in practice?** The multi-project switching, the separate paths, or the SessionStart sync? 2. **The SessionStart hook for git sync** — this one feels like it could be broadly useful even for single-project users. How's it working for you across machines? 3. **The `.planning/index.md` coordinator** — does Claude pick this up automatically, or do you have to prompt it to check the coordinator first? I'll add a link to your fork in the README under a "Community Forks" section so others with similar needs can find it. Thanks again for building on this and for the kind words. Let's keep the conversation going — always interested in how people are adapting the pattern.
Author
Owner

@kmichels commented on GitHub (Jan 9, 2026):

Thanks for the thoughtful questions - happy to share what's working.

Most valuable feature: Honestly, the separate planning/source paths. I keep my planning files in an Obsidian vault (iCloud-synced across machines) while the actual code lives in various repos in local storage (still git synced though). This means I can browse and edit task plans in Obsidian's UI when I'm not in a Claude session, and they're still there when I come back. The multi-project switching is convenient but I'm still early in using it heavily.

SessionStart git sync: Works well for pulling the latest planning state when I switch machines. One thing I discovered today though: I originally had ~/.claude itself symlinked to iCloud for cross-machine sync, and that caused real-time sync conflicts. Moved to a cleaner approach: local ~/.claude per machine (install plugins independently on each), and only sync the planning files via git. The hook handles the planning file sync, and the rest is machine-local.

Coordinator pickup: Not automatic: you invoke the skill (either via slash command or Skill tool), and the first thing it does is check for .planning/index.md. If found, it reads the active: field and resolves the project's planning path. The SessionStart hook displays "Planning context: [project-name]" so you know where you are, but Claude doesn't automatically load the planning files until you invoke the skill or start working on something.

One thing worth noting: I discovered today that Claude Code plugins provide skills (invoked via the Skill tool), not commands (invoked via /slash). So I had to add a command wrapper file that users copy to ~/.claude/commands/ to enable the /multi-manus-planning slash command. Might be worth documenting for others building plugins.

Appreciate you linking the fork: let me know if any of this sparks ideas for the original. The coordinator pattern could potentially be upstreamed as an optional feature.

On Jan 9, 2026, at 08:32, CodingWithAdi @.***> wrote:

OthmanAdi
left a comment
(OthmanAdi/planning-with-files#13)
https://github.com/OthmanAdi/planning-with-files/issues/13#issuecomment-3728930380
Hey @kmichels https://github.com/kmichels! Thanks for sharing this — really cool to see where you took it.

The multi-project coordinator is clever. I've been using this primarily for single-project workflows, but I can see how juggling multiple repos with separate planning locations would be useful, especially the Obsidian setup.

A few questions to understand your use case better:

Which feature has been most valuable in practice? The multi-project switching, the separate paths, or the SessionStart sync?

The SessionStart hook for git sync — this one feels like it could be broadly useful even for single-project users. How's it working for you across machines?

The .planning/index.md coordinator — does Claude pick this up automatically, or do you have to prompt it to check the coordinator first?

I'll add a link to your fork in the README under a "Community Forks" section so others with similar needs can find it.

Thanks again for building on this and for the kind words. Let's keep the conversation going — always interested in how people are adapting the pattern.


Reply to this email directly, view it on GitHub https://github.com/OthmanAdi/planning-with-files/issues/13#issuecomment-3728930380, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAPYRGRCXYSFQ3IIUYDLHXL4F6UYVAVCNFSM6AAAAACRFWOF6CVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTOMRYHEZTAMZYGA.
You are receiving this because you were mentioned.

<!-- gh-comment-id:3730048274 --> @kmichels commented on GitHub (Jan 9, 2026): Thanks for the thoughtful questions - happy to share what's working. Most valuable feature: Honestly, the separate planning/source paths. I keep my planning files in an Obsidian vault (iCloud-synced across machines) while the actual code lives in various repos in local storage (still git synced though). This means I can browse and edit task plans in Obsidian's UI when I'm not in a Claude session, and they're still there when I come back. The multi-project switching is convenient but I'm still early in using it heavily. SessionStart git sync: Works well for pulling the latest planning state when I switch machines. One thing I discovered today though: I originally had ~/.claude itself symlinked to iCloud for cross-machine sync, and that caused real-time sync conflicts. Moved to a cleaner approach: local ~/.claude per machine (install plugins independently on each), and only sync the planning files via git. The hook handles the planning file sync, and the rest is machine-local. Coordinator pickup: Not automatic: you invoke the skill (either via slash command or Skill tool), and the first thing it does is check for .planning/index.md. If found, it reads the active: field and resolves the project's planning path. The SessionStart hook displays "Planning context: [project-name]" so you know where you are, but Claude doesn't automatically load the planning files until you invoke the skill or start working on something. One thing worth noting: I discovered today that Claude Code plugins provide skills (invoked via the Skill tool), not commands (invoked via /slash). So I had to add a command wrapper file that users copy to ~/.claude/commands/ to enable the /multi-manus-planning slash command. Might be worth documenting for others building plugins. Appreciate you linking the fork: let me know if any of this sparks ideas for the original. The coordinator pattern could potentially be upstreamed as an optional feature. > On Jan 9, 2026, at 08:32, CodingWithAdi ***@***.***> wrote: > > > OthmanAdi > left a comment > (OthmanAdi/planning-with-files#13) > <https://github.com/OthmanAdi/planning-with-files/issues/13#issuecomment-3728930380> > Hey @kmichels <https://github.com/kmichels>! Thanks for sharing this — really cool to see where you took it. > > The multi-project coordinator is clever. I've been using this primarily for single-project workflows, but I can see how juggling multiple repos with separate planning locations would be useful, especially the Obsidian setup. > > A few questions to understand your use case better: > > Which feature has been most valuable in practice? The multi-project switching, the separate paths, or the SessionStart sync? > > The SessionStart hook for git sync — this one feels like it could be broadly useful even for single-project users. How's it working for you across machines? > > The .planning/index.md coordinator — does Claude pick this up automatically, or do you have to prompt it to check the coordinator first? > > I'll add a link to your fork in the README under a "Community Forks" section so others with similar needs can find it. > > Thanks again for building on this and for the kind words. Let's keep the conversation going — always interested in how people are adapting the pattern. > > — > Reply to this email directly, view it on GitHub <https://github.com/OthmanAdi/planning-with-files/issues/13#issuecomment-3728930380>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAPYRGRCXYSFQ3IIUYDLHXL4F6UYVAVCNFSM6AAAAACRFWOF6CVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTOMRYHEZTAMZYGA>. > You are receiving this because you were mentioned. >
Sign in to join this conversation.
No labels
bug
pull-request
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/planning-with-files#9
No description provided.