# Parallel Claude Code Sessions with Crystal
## The Problem
Claude Code is powerful, but it's single-threaded. Complex projects have independent work streams that could run in parallel—backend, frontend, AI integration—but you're stuck doing them sequentially.
## The Solution: Git Worktrees + Crystal
**Git worktrees** let you check out multiple branches simultaneously in separate directories:
```bash
git worktree add ../worktree-backend -b feature/backend
git worktree add ../worktree-frontend -b feature/frontend
git worktree add ../worktree-ai -b feature/ai-integration
```
**Crystal** ([github.com/stravu/crystal](https://github.com/stravu/crystal)) is a desktop app that manages multiple Claude Code sessions visually. Point each session at a different worktree.
## The Pattern: Coordinator + Workers
Run one "coordinator" Claude session in your main repo. This session:
- Tracks progress in a ROADMAP.md
- Completes ticket workflows (push, MR, merge) when workers finish
- Assigns next tickets to available streams
- Handles merge conflicts between streams
Worker sessions just implement tickets. They don't update shared docs (avoids conflicts).
## Example Workflow
1. Coordinator creates worktrees and ROADMAP
2. Launch Crystal, create sessions for each worktree
3. Give each worker a prompt: "Work ticket #19"
4. Workers implement, test, push, create MR
5. Coordinator merges, updates ROADMAP, assigns next ticket
6. Repeat
## Tips
- Keep shared file ownership clear (one stream owns `package.json`, another owns `appsettings.json`)
- Workers should pull main before starting new tickets
- Put automation scripts in git so all worktrees have them
- Coordinator handles ROADMAP updates to avoid merge conflicts
Five parallel Claude sessions can massively accelerate a project. The coordination overhead is worth it.
New App "Crystal" to spwn multiple Claude Threads
By Mike
31 views
0