psm_skill

Overview

This skill provides a shorthand alias for invoking the Project Session Manager (PSM) used to create isolated development environments with git worktrees and tmux. It forwards arguments to the full Project Session Manager command so teams can quickly open, switch, and manage session contexts. The alias preserves the same behavior and options as the canonical skill for consistency across workflows.

How this skill works

When called, the alias forwards all arguments to the underlying Project Session Manager implementation. The manager creates or attaches tmux sessions, sets up git worktrees for isolated feature branches, and applies optional templates for environment bootstrapping. All worktree and tmux lifecycle operations follow the Project Session Manager's rules and configuration.

When to use it

• Start an isolated development session for a new feature or bugfix
• Switch between parallel work contexts without affecting the main branch
• Onboard collaborators to a shared workspace with consistent tmux layouts
• Run multi-agent orchestration tasks that require separated codebases
• Automate session creation in CI or developer tooling scripts

Best practices

• Use descriptive session and worktree names to avoid collisions
• Commit or stash local changes before creating a worktree to prevent data loss
• Keep templates small and reproducible for fast environment setup
• Share a common configuration file with your team to standardize sessions
• Regularly prune unused worktrees and tmux sessions to reduce clutter

Example use cases

• Create a new worktree and tmux session for a hotfix with one command
• Open multiple isolated sessions to run parallel experiments safely
• Provision per-task environments for a multi-agent Claude Code workflow
• Automate developer environment creation in onboarding scripts
• Quickly recover and reattach to a previously started session after reconnecting