project-session-manager

Provisions per-task git worktrees and tmux sessions for development environments.

Updated Feb 15, 2026
One-click install
npx skills add https://github.com/leejaedus/pepcode --skill project-session-manager-leejaedus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-session-manager
Source: https://github.com/leejaedus/pepcode/tree/main/skills/project-session-manager
Command: npx skills add https://github.com/leejaedus/pepcode --skill project-session-manager-leejaedus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers often juggle multiple tasks across several repositories, leading to context switching, drift in baselines, and wasted time. This Skill automates the creation and management of isolated development environments by provisioning per-task git worktrees and tmux sessions, ensuring clean, reproducible setups across projects.

Core Features & Use Cases

  • Create per-task worktrees and tmux sessions for PRs, issues, and feature work, enabling parallel development without workspace interference.
  • Launch Claude Code inside the active session to provide in-context guidance and code assistance during development.
  • Track and manage active sessions with a lightweight registry and a set of commands (review, fix, feature, list, attach, kill, cleanup, status) for end-to-end lifecycle.

Quick Start

Create a new PR review session for pep#123 and open Claude Code in a tmux session.

Frequently Asked Questions about project-session-manager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage isolated development environments for parallel git worktrees?

To manage isolated development environments, you can provision per-task git worktrees and tmux sessions. This ensures clean, reproducible setups across projects, preventing workspace interference while you work on multiple tasks in parallel.

Can I launch Claude Code inside a tmux session for PR reviews?

Yes, you can launch Claude Code inside an active tmux session. This provides in-context guidance and code assistance directly during PR reviews, issue fixes, or feature development within the isolated worktree.

What is the best way to automate tmux session orchestration for multiple repositories?

The best way to automate tmux session orchestration is using a deterministic workflow with a persistent session registry. It manages cloning, worktree creation, and Claude Code launch, tracking active sessions via lifecycle commands like list, attach, and kill.

How do I track active worktree and tmux sessions across different tasks?

You can track and manage active sessions using a lightweight registry with end-to-end lifecycle commands. Commands such as review, fix, feature, list, attach, kill, cleanup, and status allow you to monitor and control session metadata easily.

Does this session management approach work for fixing issues without switching git baselines?

Yes, provisioning a dedicated git worktree per issue fix prevents baseline drift. By isolating each task in its own worktree and tmux session, you eliminate context switching and maintain a clean baseline across multiple repositories.