project-session-manager

Provision git worktrees and tmux sessions for issues, PRs, and features.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/Pryma-Tech/iris --skill project-session-manager-pryma-tech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-session-manager
Source: https://github.com/Pryma-Tech/iris/tree/main/cli/skills/project-session-manager
Command: npx skills add https://github.com/Pryma-Tech/iris --skill project-session-manager-pryma-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Worktree-first development environment management for issues, PRs, and features, enabling isolation of work context with optional tmux sessions.

Core Features & Use Cases

  • Isolated worktree-based sessions for issue, PR, and feature development
  • Integrated tmux session management with easy attach/kill/cleanup
  • Teleport-style quick worktrees for rapid isolation and experimentation
  • Git providers integrations (GitHub and Jira) to pull PR/issue metadata and streamline workflows

Quick Start

Start with omc teleport to create an isolated worktree for an issue or PR.

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 multiple features and PRs?

You can manage isolated git worktrees by provisioning dedicated worktrees and tmux sessions for issues, PRs, and features. It coordinates worktree creation and tmux session management to isolate work context across multiple tasks.

Can I integrate GitHub and Jira metadata into tmux session management?

Yes, git provider integrations pull GitHub and Jira metadata to streamline workflows. It uses this metadata to automate worktree creation and configure tmux sessions for specific issues or PRs.

What is the best way to quickly create a git worktree for rapid experimentation?

The best way to create a git worktree for rapid experimentation is using teleport mode. Teleport mode provisions quick, lightweight worktrees to isolate and test changes without disrupting your main development environment.

How do I clean up tmux sessions and git worktrees after finishing a feature?

You can clean up tmux sessions and git worktrees using dedicated cleanup and kill commands. These commands remove finished worktrees and terminate associated tmux sessions from the persistent session registry.

Do I need tmux to use this worktree-based development environment?

Tmux is supported for integrated session management but is optional. The core functionality provisions isolated git worktrees for issues and features, offering worktree-first environment management with optional tmux attach and kill capabilities.

Why use git worktrees instead of cloning repositories for issue branching?

Git worktrees provide isolated development environments for issues and PRs without the overhead of cloning entire repositories. This worktree-first approach maintains a persistent session registry to track and switch between active tasks efficiently.