Project Session Manager

功能

• Automated Git worktree creation for issues, PRs, and features
• Optional tmux session management for active development environments
• Support for GitHub and Jira issue/PR tracking providers
• Project alias and configuration management for diverse repositories
• Session registry and cleanup for merged/closed tasks

使用场景

• When needing to work on multiple issues or features simultaneously without interference
• When setting up a dedicated environment for reviewing a pull request
• When starting a new feature development branch with an isolated workspace
• When cleaning up old or merged development branches and worktrees

非目标

• Managing cloud infrastructure or deployment pipelines
• Acting as a code linter or static analysis tool
• Replacing the core functionality of Git, tmux, or provider CLIs

工作流

1. Parse command arguments (subcommand, reference, options)
2. Resolve project reference from configuration or defaults
3. Fetch relevant issue/PR information from provider CLI
4. Ensure local repository exists and clone if necessary
5. Create Git worktree for the task
6. Create session metadata and update registry
7. Create tmux session (if enabled)
8. Launch Claude Code within the session (if enabled)
9. Output session information or perform cleanup/status actions

先决条件

• git (with worktree support v2.5+)
• jq
• tmux (optional, but recommended)
• gh CLI (for GitHub workflows, optional)
• jira CLI (for Jira workflows, optional)