Skip to content

chore: add gwq worktree support for parallel coding sessions#75

Merged
steilerDev merged 1 commit into
betafrom
chore/parallel-worktree-sessions
Feb 16, 2026
Merged

chore: add gwq worktree support for parallel coding sessions#75
steilerDev merged 1 commit into
betafrom
chore/parallel-worktree-sessions

Conversation

@steilerDev
Copy link
Copy Markdown
Owner

Summary

  • Install gwq in the sandbox Dockerfile for git worktree management, with a fallback scripts/install-gwq.sh for existing sandboxes
  • Add scripts/worktree-create.sh and scripts/worktree-remove.sh for worktree lifecycle with automatic port slot allocation (slots 1-3), agent-memory symlink, and npm bootstrap
  • Make dev server ports configurable via CLIENT_DEV_PORT and PORT env vars in client/webpack.config.cjs (backward-compatible defaults)
  • Add .gwq.toml project config, .env.worktree to .gitignore, process to ESLint CJS globals
  • Document the "Parallel Coding Sessions" workflow in CLAUDE.md with port allocation table and usage examples

Test plan

  • Verify gwq --version works in a freshly built sandbox
  • Run scripts/worktree-create.sh feat/test-worktree 1 — confirm directory, .env.worktree, agent-memory symlink, and node_modules/ exist
  • In main worktree, npm run dev binds to 3000/5173; in new worktree, source .env.worktree && npm run dev binds to 3001/5174
  • Run scripts/worktree-remove.sh feat/test-worktree — confirm directory removed
  • Quality gates pass: npm run lint && npm run format:check && npm run typecheck && npm test && npm run build && npm audit

🤖 Generated with Claude Code

Enable multiple Claude Code sessions to run in parallel, each in an
isolated git worktree with its own node_modules, database, and dev
server ports. Includes gwq installation in sandbox Dockerfile, helper
scripts for worktree lifecycle management, configurable dev server
ports via CLIENT_DEV_PORT env var, and documentation in CLAUDE.md.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@steilerDev steilerDev merged commit bb9c538 into beta Feb 16, 2026
4 checks passed
@github-actions
Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 1.7.0-beta.14 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@github-actions
Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 1.7.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants