project-session-manager

Manage git worktrees and tmux sessions for isolated development environments.

2|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/chanhee-kang/oh-my-gemini --skill project-session-manager
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-session-manager
Source: https://github.com/chanhee-kang/oh-my-gemini/tree/main/skills/project-session-manager
Command: npx skills add https://github.com/chanhee-kang/oh-my-gemini --skill project-session-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the complexity of maintaining multiple isolated development contexts across several repositories by combining git worktrees with tmux sessions, providing reproducible workspaces for concurrent tasks.

Core Features & Use Cases

  • Isolated worktrees for PR reviews, issue fixes, and feature development across multiple repos, enabling true parallel work.
  • TMux-based session management with per-session metadata to simplify attaching, killing, and cleanup.
  • Teleport-like lightweight workflow for quick worktree creation without full session management.

Quick Start

For lightweight experiments without tmux: omc teleport #123 # Create worktree for issue/PR omc teleport my-feature # Create worktree for feature omc teleport list

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 parallel development across multiple git worktrees?

Managing parallel development across git worktrees requires pairing each worktree with an isolated tmux session. This approach maintains reproducible workspaces for concurrent PR reviews and feature branches without context switching between unrelated codebases.

Can I create a git worktree for an issue without starting a full tmux session?

Yes, you can create a git worktree for a specific issue or PR without full session management using a lightweight teleport workflow. This quickly sets up isolated workspaces for rapid experiments without the overhead of managing tmux session metadata.

What tools do I need to automate isolated dev environments with tmux and git worktrees?

Automating isolated dev environments requires git, tmux, and either the GitHub or Jira CLI installed. You also need to provide a configuration file that maps aliases to repository URLs and local paths to correctly orchestrate worktrees and sessions.

How does tmux session management simplify worktree cleanup?

Tmux session management simplifies worktree cleanup by attaching per-session metadata to each isolated environment. This metadata tracks active worktrees, making it straightforward to attach, kill, and remove sessions when parallel development tasks are finished.

When should I use git worktrees instead of cloning multiple repositories?

Git worktrees are ideal when you need isolated development contexts for concurrent PR reviews or feature branches within the same repository. Unlike multiple clones, worktrees share a single git history, saving disk space while enabling true parallel work.