project-session-manager

Manage isolated Git worktrees and tmux sessions for parallel coding tasks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual effort of setting up, tracking, attaching to, and cleaning isolated development environments for parallel coding tasks.

Core Features & Use Cases

  • Worktree orchestration: Create isolated Git worktrees for pull request reviews, issue fixes, and feature development.
  • Session management: Launch and manage Codex sessions in tmux, with commands for listing, attaching, inspecting, and terminating sessions.
  • Provider support: Work with GitHub and Jira references, project aliases, configurable base branches, and automated cleanup of completed work.
  • Use Case: Start a dedicated worktree and Codex session for a GitHub issue, implement the fix independently, then remove the session and worktree after the issue is closed.

Quick Start

Use the project session manager to create an isolated issue-fix environment for the specified project reference.

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 Git worktrees for parallel feature development and pull request reviews?

You can manage isolated Git worktrees by creating dedicated branches for parallel coding, pull request reviews, and issue fixes. This isolates work safely across projects and tasks, preventing branch conflicts during concurrent feature development.

How do I start a tmux session for a GitHub issue fix?

Start a tmux session for a GitHub issue fix by launching a dedicated Codex session in tmux. You can implement the fix independently, inspect the session status, and attach to the active session to monitor progress.

Do I need GitHub CLI or Jira CLI to manage project sessions?

You need Git and jq installed, while GitHub CLI or Jira CLI are required only for their respective workflows. tmux is also necessary to launch, attach, and manage isolated Codex development sessions.

What's the best way to coordinate parallel coding tasks across GitHub and Jira workflows?

Coordinate parallel coding tasks by using project aliases and configurable base branches to organize GitHub and Jira references. This approach tracks multiple issue fixes and feature development branches simultaneously without overlap.

How do I clean up completed Git worktrees and tmux sessions after an issue is closed?

Clean up completed Git worktrees and tmux sessions using automated cleanup commands. After an issue is closed, you can remove the dedicated session and worktree to keep your development environment organized and free of stale branches.

Can I inspect the status of active tmux sessions without attaching to them?

You can inspect the status of active tmux sessions without attaching by using session listing and status inspection commands. This allows you to review ongoing parallel coding tasks before deciding whether to attach or terminate a session.