Project Session Manager (PSM) FAQs

Question 1

Can I use PSM with private repositories?

Accepted Answer

Absolutely. As long as your local environment has the necessary git and CLI permissions (gh for GitHub or jira-cli for Jira), PSM can manage sessions for any repository you have access to.

Question 2

What is the benefit of using git worktrees with PSM?

Accepted Answer

Git worktrees allow you to have multiple branches of the same repository checked out in different directories simultaneously. PSM automates this process, so you can work on several tasks at once without the overhead of stashing changes or switching branches.

Question 3

Do I need to have tmux installed to use this skill?

Accepted Answer

Yes, for full session management. However, PSM also includes a lightweight 'teleport' command that manages git worktrees independently if you prefer not to use tmux for terminal persistence.

Question 4

How does PSM handle Jira integration?

Accepted Answer

PSM uses the Jira CLI to fetch issue metadata. When you start a 'fix' session with a Jira reference, it automatically creates a descriptive branch and worktree based on the ticket details.

Question 5

What happens to my worktrees when a PR is merged?

Accepted Answer

PSM includes a cleanup command that checks the status of your linked GitHub PRs or Jira issues. It identifies merged or closed tasks and automatically removes the associated worktrees and tmux sessions to keep your environment clean.

Project Session Manager (PSM)

Project Session Manager (PSM)

About

Key Features

Use Cases

About

Key Features

Use Cases