oh-my-claude-sisyphus 3.6.0 → 3.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-claude-sisyphus",
-  "version": "3.6.0",
+  "version": "3.6.2",
   "description": "Multi-agent orchestration system for Claude Code - Inspired by oh-my-opencode",
   "type": "module",
   "main": "dist/index.js",

package/skills/omc-setup/SKILL.md

@@ -49,6 +49,14 @@ mkdir -p .claude && echo ".claude directory ready"
 # Extract old version before download
 OLD_VERSION=$(grep -m1 "^# oh-my-claudecode" .claude/CLAUDE.md 2>/dev/null | grep -oE 'v[0-9]+\.[0-9]+\.[0-9]+' || echo "none")
 
+# Backup existing CLAUDE.md before overwriting (if it exists)
+if [ -f ".claude/CLAUDE.md" ]; then
+  BACKUP_DATE=$(date +%Y-%m-%d)
+  BACKUP_PATH=".claude/CLAUDE.md.backup.${BACKUP_DATE}"
+  cp .claude/CLAUDE.md "$BACKUP_PATH"
+  echo "Backed up existing CLAUDE.md to $BACKUP_PATH"
+fi
+
 # Download fresh CLAUDE.md from GitHub
 curl -fsSL "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/docs/CLAUDE.md" -o .claude/CLAUDE.md && \
 echo "Downloaded CLAUDE.md to .claude/CLAUDE.md"
@@ -66,6 +74,8 @@ fi
 
 **Note**: The downloaded CLAUDE.md includes Context Persistence instructions with `<remember>` tags for surviving conversation compaction.
 
+**Note**: If an existing CLAUDE.md is found, it will be backed up to `.claude/CLAUDE.md.backup.YYYY-MM-DD` before downloading the new version.
+
 **MANDATORY**: Always run this command. Do NOT skip. Do NOT use Write tool.
 
 **FALLBACK** if curl fails:
@@ -84,6 +94,7 @@ After completing local configuration, report:
 
 **OMC Project Configuration Complete**
 - CLAUDE.md: Updated with latest configuration from GitHub at ./.claude/CLAUDE.md
+- Backup: Previous CLAUDE.md backed up to `.claude/CLAUDE.md.backup.YYYY-MM-DD` (if existed)
 - Scope: **PROJECT** - applies only to this project
 - Hooks: Provided by plugin (no manual installation needed)
 - Agents: 28+ available (base + tiered variants)
@@ -103,6 +114,14 @@ If `--local` flag was used, **STOP HERE**. Do not continue to HUD setup or other
 # Extract old version before download
 OLD_VERSION=$(grep -m1 "^# oh-my-claudecode" ~/.claude/CLAUDE.md 2>/dev/null | grep -oE 'v[0-9]+\.[0-9]+\.[0-9]+' || echo "none")
 
+# Backup existing CLAUDE.md before overwriting (if it exists)
+if [ -f "$HOME/.claude/CLAUDE.md" ]; then
+  BACKUP_DATE=$(date +%Y-%m-%d)
+  BACKUP_PATH="$HOME/.claude/CLAUDE.md.backup.${BACKUP_DATE}"
+  cp "$HOME/.claude/CLAUDE.md" "$BACKUP_PATH"
+  echo "Backed up existing CLAUDE.md to $BACKUP_PATH"
+fi
+
 # Download fresh CLAUDE.md to global config
 curl -fsSL "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/docs/CLAUDE.md" -o ~/.claude/CLAUDE.md && \
 echo "Downloaded CLAUDE.md to ~/.claude/CLAUDE.md"
@@ -118,6 +137,8 @@ else
 fi
 ```
 
+**Note**: If an existing CLAUDE.md is found, it will be backed up to `~/.claude/CLAUDE.md.backup.YYYY-MM-DD` before downloading the new version.
+
 ### Clean Up Legacy Hooks (if present)
 
 Check if old manual hooks exist and remove them to prevent duplicates:
@@ -147,6 +168,7 @@ After completing global configuration, report:
 
 **OMC Global Configuration Complete**
 - CLAUDE.md: Updated with latest configuration from GitHub at ~/.claude/CLAUDE.md
+- Backup: Previous CLAUDE.md backed up to `~/.claude/CLAUDE.md.backup.YYYY-MM-DD` (if existed)
 - Scope: **GLOBAL** - applies to all Claude Code sessions
 - Hooks: Provided by plugin (no manual installation needed)
 - Agents: 28+ available (base + tiered variants)
@@ -282,10 +304,10 @@ Ask user: "Would you like to install the OMC CLI for standalone analytics? (Reco
 # Check for bun (preferred) or npm
 if command -v bun &> /dev/null; then
   echo "Installing OMC CLI via bun..."
-  bun install -g oh-my-claudecode
+  bun install -g oh-my-claude-sisyphus
 elif command -v npm &> /dev/null; then
   echo "Installing OMC CLI via npm..."
-  npm install -g oh-my-claudecode
+  npm install -g oh-my-claude-sisyphus
 else
   echo "ERROR: Neither bun nor npm found. Please install Node.js or Bun first."
   exit 1
@@ -303,7 +325,7 @@ fi
 
 ### If User Chooses NO:
 
-Skip this step. User can install later with `npm install -g oh-my-claudecode`.
+Skip this step. User can install later with `npm install -g oh-my-claude-sisyphus`.
 
 ## Step 4: Verify Plugin Installation
 
@@ -480,11 +502,13 @@ MODES:
 
   Local Configuration (--local)
     - Downloads fresh CLAUDE.md to ./.claude/
+    - Backs up existing CLAUDE.md to .claude/CLAUDE.md.backup.YYYY-MM-DD
     - Project-specific settings
     - Use this to update project config after OMC upgrades
 
   Global Configuration (--global)
     - Downloads fresh CLAUDE.md to ~/.claude/
+    - Backs up existing CLAUDE.md to ~/.claude/CLAUDE.md.backup.YYYY-MM-DD
     - Applies to all Claude Code sessions
     - Cleans up legacy hooks
     - Use this to update global config after OMC upgrades

package/skills/project-session-manager/SKILL.md

@@ -0,0 +1,410 @@
+---
+name: project-session-manager
+description: Manage isolated dev environments with git worktrees and tmux sessions
+aliases: [psm]
+---
+
+# Project Session Manager (PSM) Skill
+
+Automate isolated development environments using git worktrees and tmux sessions with Claude Code. Enables parallel work across multiple tasks, projects, and repositories.
+
+## Commands
+
+| Command | Description | Example |
+|---------|-------------|---------|
+| `review <ref>` | PR review session | `/psm review omc#123` |
+| `fix <ref>` | Issue fix session | `/psm fix omc#42` |
+| `feature <proj> <name>` | Feature development | `/psm feature omc add-webhooks` |
+| `list [project]` | List active sessions | `/psm list` |
+| `attach <session>` | Attach to session | `/psm attach omc:pr-123` |
+| `kill <session>` | Kill session | `/psm kill omc:pr-123` |
+| `cleanup` | Clean merged/closed | `/psm cleanup` |
+| `status` | Current session info | `/psm status` |
+
+## Project References
+
+Supported formats:
+- **Alias**: `omc#123` (requires `~/.psm/projects.json`)
+- **Full**: `owner/repo#123`
+- **URL**: `https://github.com/owner/repo/pull/123`
+- **Current**: `#123` (uses current directory's repo)
+
+## Configuration
+
+### Project Aliases (`~/.psm/projects.json`)
+
+```json
+{
+  "aliases": {
+    "omc": {
+      "repo": "Yeachan-Heo/oh-my-claudecode",
+      "local": "~/Workspace/oh-my-claudecode",
+      "default_base": "main"
+    }
+  },
+  "defaults": {
+    "worktree_root": "~/.psm/worktrees",
+    "cleanup_after_days": 14
+  }
+}
+```
+
+## Directory Structure
+
+```
+~/.psm/
+├── projects.json       # Project aliases
+├── sessions.json       # Active session registry
+└── worktrees/          # Worktree storage
+    └── <project>/
+        └── <type>-<id>/
+```
+
+## Session Naming
+
+| Type | Tmux Session | Worktree Dir |
+|------|--------------|--------------|
+| PR Review | `psm:omc:pr-123` | `~/.psm/worktrees/omc/pr-123` |
+| Issue Fix | `psm:omc:issue-42` | `~/.psm/worktrees/omc/issue-42` |
+| Feature | `psm:omc:feat-auth` | `~/.psm/worktrees/omc/feat-auth` |
+
+---
+
+## Implementation Protocol
+
+When the user invokes a PSM command, follow this protocol:
+
+### Parse Arguments
+
+Parse `{{ARGUMENTS}}` to determine:
+1. **Subcommand**: review, fix, feature, list, attach, kill, cleanup, status
+2. **Reference**: project#number, URL, or session ID
+3. **Options**: --branch, --base, --no-claude, --no-tmux, etc.
+
+### Subcommand: `review <ref>`
+
+**Purpose**: Create PR review session
+
+**Steps**:
+
+1. **Resolve reference**:
+   ```bash
+   # Read project aliases
+   cat ~/.psm/projects.json 2>/dev/null || echo '{"aliases":{}}'
+
+   # Parse ref format: alias#num, owner/repo#num, or URL
+   # Extract: project_alias, repo (owner/repo), pr_number, local_path
+   ```
+
+2. **Fetch PR info**:
+   ```bash
+   gh pr view <pr_number> --repo <repo> --json number,title,author,headRefName,baseRefName,body,files,url
+   ```
+
+3. **Ensure local repo exists**:
+   ```bash
+   # If local path doesn't exist, clone
+   if [[ ! -d "$local_path" ]]; then
+     git clone "https://github.com/$repo.git" "$local_path"
+   fi
+   ```
+
+4. **Create worktree**:
+   ```bash
+   worktree_path="$HOME/.psm/worktrees/$project_alias/pr-$pr_number"
+
+   # Fetch PR branch
+   cd "$local_path"
+   git fetch origin "pull/$pr_number/head:pr-$pr_number-review"
+
+   # Create worktree
+   git worktree add "$worktree_path" "pr-$pr_number-review"
+   ```
+
+5. **Create session metadata**:
+   ```bash
+   cat > "$worktree_path/.psm-session.json" << EOF
+   {
+     "id": "$project_alias:pr-$pr_number",
+     "type": "review",
+     "project": "$project_alias",
+     "ref": "pr-$pr_number",
+     "branch": "<head_branch>",
+     "base": "<base_branch>",
+     "created_at": "$(date -Iseconds)",
+     "tmux_session": "psm:$project_alias:pr-$pr_number",
+     "worktree_path": "$worktree_path",
+     "source_repo": "$local_path",
+     "github": {
+       "pr_number": $pr_number,
+       "pr_title": "<title>",
+       "pr_author": "<author>",
+       "pr_url": "<url>"
+     },
+     "state": "active"
+   }
+   EOF
+   ```
+
+6. **Update sessions registry**:
+   ```bash
+   # Add to ~/.psm/sessions.json
+   ```
+
+7. **Create tmux session**:
+   ```bash
+   tmux new-session -d -s "psm:$project_alias:pr-$pr_number" -c "$worktree_path"
+   ```
+
+8. **Launch Claude Code** (unless --no-claude):
+   ```bash
+   tmux send-keys -t "psm:$project_alias:pr-$pr_number" "claude" Enter
+   ```
+
+9. **Output session info**:
+   ```
+   Session ready!
+
+     ID: omc:pr-123
+     Worktree: ~/.psm/worktrees/omc/pr-123
+     Tmux: psm:omc:pr-123
+
+   To attach: tmux attach -t psm:omc:pr-123
+   ```
+
+### Subcommand: `fix <ref>`
+
+**Purpose**: Create issue fix session
+
+**Steps**:
+
+1. **Resolve reference** (same as review)
+
+2. **Fetch issue info**:
+   ```bash
+   gh issue view <issue_number> --repo <repo> --json number,title,body,labels,url
+   ```
+
+3. **Create feature branch**:
+   ```bash
+   cd "$local_path"
+   git fetch origin main
+   branch_name="fix/$issue_number-$(echo "$title" | tr ' ' '-' | tr '[:upper:]' '[:lower:]' | head -c 30)"
+   git checkout -b "$branch_name" origin/main
+   ```
+
+4. **Create worktree**:
+   ```bash
+   worktree_path="$HOME/.psm/worktrees/$project_alias/issue-$issue_number"
+   git worktree add "$worktree_path" "$branch_name"
+   ```
+
+5. **Create session metadata** (similar to review, type="fix")
+
+6. **Update registry, create tmux, launch claude** (same as review)
+
+### Subcommand: `feature <project> <name>`
+
+**Purpose**: Start feature development
+
+**Steps**:
+
+1. **Resolve project** (from alias or path)
+
+2. **Create feature branch**:
+   ```bash
+   cd "$local_path"
+   git fetch origin main
+   branch_name="feature/$feature_name"
+   git checkout -b "$branch_name" origin/main
+   ```
+
+3. **Create worktree**:
+   ```bash
+   worktree_path="$HOME/.psm/worktrees/$project_alias/feat-$feature_name"
+   git worktree add "$worktree_path" "$branch_name"
+   ```
+
+4. **Create session, tmux, launch claude** (same pattern)
+
+### Subcommand: `list [project]`
+
+**Purpose**: List active sessions
+
+**Steps**:
+
+1. **Read sessions registry**:
+   ```bash
+   cat ~/.psm/sessions.json 2>/dev/null || echo '{"sessions":{}}'
+   ```
+
+2. **Check tmux sessions**:
+   ```bash
+   tmux list-sessions -F "#{session_name}" 2>/dev/null | grep "^psm:"
+   ```
+
+3. **Check worktrees**:
+   ```bash
+   ls -la ~/.psm/worktrees/*/ 2>/dev/null
+   ```
+
+4. **Format output**:
+   ```
+   Active PSM Sessions:
+
+   ID                 | Type    | Status   | Worktree
+   -------------------|---------|----------|---------------------------
+   omc:pr-123        | review  | active   | ~/.psm/worktrees/omc/pr-123
+   omc:issue-42      | fix     | detached | ~/.psm/worktrees/omc/issue-42
+   ```
+
+### Subcommand: `attach <session>`
+
+**Purpose**: Attach to existing session
+
+**Steps**:
+
+1. **Parse session ID**: `project:type-number`
+
+2. **Verify session exists**:
+   ```bash
+   tmux has-session -t "psm:$session_id" 2>/dev/null
+   ```
+
+3. **Attach**:
+   ```bash
+   tmux attach -t "psm:$session_id"
+   ```
+
+### Subcommand: `kill <session>`
+
+**Purpose**: Kill session and cleanup
+
+**Steps**:
+
+1. **Kill tmux session**:
+   ```bash
+   tmux kill-session -t "psm:$session_id" 2>/dev/null
+   ```
+
+2. **Remove worktree**:
+   ```bash
+   worktree_path=$(jq -r ".sessions[\"$session_id\"].worktree" ~/.psm/sessions.json)
+   source_repo=$(jq -r ".sessions[\"$session_id\"].source_repo" ~/.psm/sessions.json)
+
+   cd "$source_repo"
+   git worktree remove "$worktree_path" --force
+   ```
+
+3. **Update registry**:
+   ```bash
+   # Remove from sessions.json
+   ```
+
+### Subcommand: `cleanup`
+
+**Purpose**: Clean up merged PRs and closed issues
+
+**Steps**:
+
+1. **Read all sessions**
+
+2. **For each PR session, check if merged**:
+   ```bash
+   gh pr view <pr_number> --repo <repo> --json merged,state
+   ```
+
+3. **For each issue session, check if closed**:
+   ```bash
+   gh issue view <issue_number> --repo <repo> --json closed,state
+   ```
+
+4. **Clean up merged/closed sessions**:
+   - Kill tmux session
+   - Remove worktree
+   - Update registry
+
+5. **Report**:
+   ```
+   Cleanup complete:
+     Removed: omc:pr-123 (merged)
+     Removed: omc:issue-42 (closed)
+     Kept: omc:feat-auth (active)
+   ```
+
+### Subcommand: `status`
+
+**Purpose**: Show current session info
+
+**Steps**:
+
+1. **Detect current session** from tmux or cwd:
+   ```bash
+   tmux display-message -p "#{session_name}" 2>/dev/null
+   # or check if cwd is inside a worktree
+   ```
+
+2. **Read session metadata**:
+   ```bash
+   cat .psm-session.json 2>/dev/null
+   ```
+
+3. **Show status**:
+   ```
+   Current Session: omc:pr-123
+   Type: review
+   PR: #123 - Add webhook support
+   Branch: feature/webhooks
+   Created: 2 hours ago
+   ```
+
+---
+
+## Error Handling
+
+| Error | Resolution |
+|-------|------------|
+| Worktree exists | Offer: attach, recreate, or abort |
+| PR not found | Verify URL/number, check permissions |
+| No tmux | Warn and skip session creation |
+| No gh CLI | Error with install instructions |
+
+## Requirements
+
+- `git` with worktree support (v2.5+)
+- `gh` CLI (authenticated)
+- `tmux`
+- `jq` for JSON parsing
+
+## Initialization
+
+On first run, create default config:
+
+```bash
+mkdir -p ~/.psm/worktrees ~/.psm/logs
+
+# Create default projects.json if not exists
+if [[ ! -f ~/.psm/projects.json ]]; then
+  cat > ~/.psm/projects.json << 'EOF'
+{
+  "aliases": {
+    "omc": {
+      "repo": "Yeachan-Heo/oh-my-claudecode",
+      "local": "~/Workspace/oh-my-claudecode",
+      "default_base": "main"
+    }
+  },
+  "defaults": {
+    "worktree_root": "~/.psm/worktrees",
+    "cleanup_after_days": 14,
+    "auto_cleanup_merged": true
+  }
+}
+EOF
+fi
+
+# Create sessions.json if not exists
+if [[ ! -f ~/.psm/sessions.json ]]; then
+  echo '{"version":1,"sessions":{},"stats":{"total_created":0,"total_cleaned":0}}' > ~/.psm/sessions.json
+fi
+```

package/skills/project-session-manager/lib/config.sh

@@ -0,0 +1,86 @@
+#!/bin/bash
+# PSM Configuration Management
+
+PSM_ROOT="${HOME}/.psm"
+PSM_WORKTREES="${PSM_ROOT}/worktrees"
+PSM_PROJECTS="${PSM_ROOT}/projects.json"
+PSM_SESSIONS="${PSM_ROOT}/sessions.json"
+PSM_LOGS="${PSM_ROOT}/logs"
+
+# Initialize PSM directories and config files
+psm_init() {
+    mkdir -p "$PSM_WORKTREES" "$PSM_LOGS"
+
+    # Create default projects.json if not exists
+    if [[ ! -f "$PSM_PROJECTS" ]]; then
+        cat > "$PSM_PROJECTS" << 'EOF'
+{
+  "aliases": {
+    "omc": {
+      "repo": "Yeachan-Heo/oh-my-claudecode",
+      "local": "~/Workspace/oh-my-claudecode",
+      "default_base": "main"
+    }
+  },
+  "defaults": {
+    "worktree_root": "~/.psm/worktrees",
+    "cleanup_after_days": 14,
+    "auto_cleanup_merged": true
+  }
+}
+EOF
+        echo "Created default projects.json"
+    fi
+
+    # Create sessions.json if not exists
+    if [[ ! -f "$PSM_SESSIONS" ]]; then
+        echo '{"version":1,"sessions":{},"stats":{"total_created":0,"total_cleaned":0}}' > "$PSM_SESSIONS"
+        echo "Created sessions.json"
+    fi
+}
+
+# Get project config by alias
+# Usage: psm_get_project "omc"
+# Returns: repo|local|default_base
+psm_get_project() {
+    local alias="$1"
+    if [[ ! -f "$PSM_PROJECTS" ]]; then
+        return 1
+    fi
+
+    local repo=$(jq -r ".aliases[\"$alias\"].repo // empty" "$PSM_PROJECTS")
+    local local_path=$(jq -r ".aliases[\"$alias\"].local // empty" "$PSM_PROJECTS")
+    local default_base=$(jq -r ".aliases[\"$alias\"].default_base // \"main\"" "$PSM_PROJECTS")
+
+    if [[ -z "$repo" ]]; then
+        return 1
+    fi
+
+    # Expand ~ to $HOME
+    local_path="${local_path/#\~/$HOME}"
+
+    echo "${repo}|${local_path}|${default_base}"
+}
+
+# Add or update project alias
+psm_set_project() {
+    local alias="$1"
+    local repo="$2"
+    local local_path="$3"
+    local default_base="${4:-main}"
+
+    local tmp=$(mktemp)
+    jq ".aliases[\"$alias\"] = {\"repo\": \"$repo\", \"local\": \"$local_path\", \"default_base\": \"$default_base\"}" \
+        "$PSM_PROJECTS" > "$tmp" && mv "$tmp" "$PSM_PROJECTS"
+}
+
+# Get default worktree root
+psm_get_worktree_root() {
+    local root=$(jq -r '.defaults.worktree_root // "~/.psm/worktrees"' "$PSM_PROJECTS")
+    echo "${root/#\~/$HOME}"
+}
+
+# Get cleanup days setting
+psm_get_cleanup_days() {
+    jq -r '.defaults.cleanup_after_days // 14' "$PSM_PROJECTS"
+}