project-session-manager

Manage project sessions with git worktrees and tmux.

Updated Mar 11, 2025
One-click install
npx skills add https://github.com/MohammedSaudAlsahli/dotfiles --skill project-session-manager-mohammedsaudalsahli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-session-manager
Source: https://github.com/MohammedSaudAlsahli/dotfiles/tree/main/ai/agents-skills/project-session-manager
Command: npx skills add https://github.com/MohammedSaudAlsahli/dotfiles --skill project-session-manager-mohammedsaudalsahli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, tmux, gh, jira, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides an organized way to manage project sessions with git worktrees and tmux sessions, enabling parallel work and isolation of development environments.

Core Features & Use Cases

  • Worktree Management: Create and manage git worktrees for isolated development environments.
  • Session Orchestration: Automate session creation, attachment, and cleanup.
  • Integration with Issue Tracking: Connect with GitHub and Jira for issue and PR management.
  • Use Case: Suppose you're working on a feature branch for a project. Use this Skill to create a new worktree, start a tmux session, and automatically sync your branch. When you're done, the Skill can help you clean up and close the session.

Quick Start

Use the omc teleport #123 command to create a worktree for an issue.

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 git worktrees and tmux sessions for parallel development?

This skill manages project sessions by creating git worktrees for isolated development environments and orchestrating tmux session creation, attachment, and cleanup for parallel work.

How do I create a tmux session linked to a GitHub issue worktree?

To create a tmux session linked to a GitHub issue worktree, use the command line interface to generate a worktree for the specific issue. It integrates with GitHub CLI to sync branches and start the session automatically.

Do I need Jira CLI to manage project sessions with git worktrees?

You do not need Jira CLI to manage basic git worktrees and tmux sessions. Jira CLI is an optional dependency only required if you want to integrate specific Jira issue tracking and project management features into your session workflow.

What is the best way to isolate development environments for multiple feature branches?

The best way to isolate development environments is using git worktrees paired with tmux sessions. This approach allows you to maintain separate working directories and terminal states for each feature branch without stashing or switching contexts.

Can I automate cleanup for git worktrees and tmux sessions when a feature is done?

Yes, you can automate cleanup for git worktrees and tmux sessions when a feature is complete. The session management tool handles command-line arguments for session teardown, ensuring both the worktree and terminal session are properly removed.

Does session management with git worktrees work without GitHub CLI?

Git worktree session management works without GitHub CLI for core worktree and tmux operations. The GitHub CLI is an optional dependency needed only for specific provider features like syncing branches directly with GitHub issues and pull requests.