Initial commit
This commit is contained in:
Zhongwei Li
239
commands/list_worktrees_prompt.md
Normal file
239
commands/list_worktrees_prompt.md
Normal file
@@ -0,0 +1,239 @@
|
||||
---
|
||||
model: claude-sonnet-4-5-20250929
|
||||
description: List all git worktrees with their configuration and status
|
||||
allowed-tools: Bash, Read, Glob, Grep
|
||||
---
|
||||
|
||||
# Purpose
|
||||
|
||||
List all git worktrees in the `trees/` directory with comprehensive information including branch names, directories, environment variables, port configuration, and service status.
|
||||
|
||||
## Variables
|
||||
|
||||
```
|
||||
PROJECT_CWD: . (current working directory - the main project root)
|
||||
WORKTREE_BASE_DIR: trees/
|
||||
```
|
||||
|
||||
## Instructions
|
||||
|
||||
- List all worktrees managed by git
|
||||
- For each worktree in trees/, gather configuration details
|
||||
- Read environment files to extract port configuration
|
||||
- Check if services are running on configured ports
|
||||
- Display comprehensive information in a clear, organized format
|
||||
- Show which worktrees are active vs stopped
|
||||
- Provide quick action commands for each worktree
|
||||
|
||||
## Workflow
|
||||
|
||||
### 1. List Git Worktrees
|
||||
|
||||
- Run: `git worktree list`
|
||||
- Parse output to identify all worktrees
|
||||
- Filter for worktrees in PROJECT_CWD/trees/ directory
|
||||
- Extract:
|
||||
- Worktree path
|
||||
- Branch name
|
||||
- Commit hash (if available)
|
||||
|
||||
### 2. Gather Configuration for Each Worktree
|
||||
|
||||
For each worktree found in trees/:
|
||||
|
||||
**Extract Branch/Directory Info:**
|
||||
- Worktree directory: `trees/<branch-name>`
|
||||
- Branch name from git worktree list
|
||||
- Working directory path
|
||||
|
||||
**Read Server Configuration:**
|
||||
- Check if `<worktree>/apps/server/.env` exists
|
||||
- If exists, read and extract:
|
||||
- `SERVER_PORT`
|
||||
- `DB_PATH`
|
||||
- If doesn't exist, note as "Not configured"
|
||||
|
||||
**Read Client Configuration:**
|
||||
- Check if `<worktree>/apps/client/.env` exists
|
||||
- If exists, read and extract:
|
||||
- `VITE_PORT`
|
||||
- `VITE_API_URL`
|
||||
- `VITE_WS_URL`
|
||||
- `VITE_MAX_EVENTS_TO_DISPLAY`
|
||||
- If doesn't exist, note as "Not configured"
|
||||
|
||||
**Read Root Configuration:**
|
||||
- Check if `<worktree>/.env` exists
|
||||
- Note presence/absence (contains API keys, don't display values)
|
||||
|
||||
### 3. Check Service Status
|
||||
|
||||
For each worktree with port configuration:
|
||||
|
||||
**Check Server Status:**
|
||||
- If SERVER_PORT identified, check: `lsof -i :<SERVER_PORT>`
|
||||
- Determine if process is running
|
||||
- Extract PID if running
|
||||
|
||||
**Check Client Status:**
|
||||
- If VITE_PORT identified, check: `lsof -i :<VITE_PORT>`
|
||||
- Determine if process is running
|
||||
- Extract PID if running
|
||||
|
||||
### 4. Check Dependencies
|
||||
|
||||
For each worktree:
|
||||
- Check if `<worktree>/apps/server/node_modules` exists
|
||||
- Check if `<worktree>/apps/client/node_modules` exists
|
||||
- Note if dependencies are installed or missing
|
||||
|
||||
### 5. Calculate Statistics
|
||||
|
||||
- Total number of worktrees
|
||||
- Number with services running
|
||||
- Number with services stopped
|
||||
- Total ports in use
|
||||
- Available port offsets (suggest next available)
|
||||
|
||||
### 6. Report
|
||||
|
||||
Follow the Report section format below.
|
||||
|
||||
## Report
|
||||
|
||||
After gathering all information, provide a comprehensive report in the following format:
|
||||
|
||||
```
|
||||
📊 Git Worktrees Overview
|
||||
|
||||
═══════════════════════════════════════════════════════════════
|
||||
|
||||
📈 Summary:
|
||||
Total Worktrees: <count>
|
||||
Running: <count> | Stopped: <count>
|
||||
Next Available Port Offset: <offset>
|
||||
|
||||
═══════════════════════════════════════════════════════════════
|
||||
|
||||
🌳 Main Repository (Default)
|
||||
📁 Location: <project-root>
|
||||
🌿 Branch: <current-branch>
|
||||
🔌 Ports: 4000 (server), 5173 (client)
|
||||
🎯 Status: <RUNNING|STOPPED>
|
||||
|
||||
Actions:
|
||||
└─ Start: ./scripts/start-system.sh
|
||||
└─ Stop: ./scripts/reset-system.sh
|
||||
|
||||
───────────────────────────────────────────────────────────────
|
||||
|
||||
🌳 Worktree: <branch-name>
|
||||
📁 Location: trees/<branch-name>
|
||||
🌿 Branch: <branch-name>
|
||||
📝 Commit: <commit-hash-short>
|
||||
|
||||
⚙️ Configuration:
|
||||
├─ Server Port: <SERVER_PORT>
|
||||
├─ Client Port: <VITE_PORT>
|
||||
├─ Database: <DB_PATH>
|
||||
├─ API URL: <VITE_API_URL>
|
||||
└─ WebSocket: <VITE_WS_URL>
|
||||
|
||||
📦 Dependencies:
|
||||
├─ Server: <✓ Installed | ❌ Missing>
|
||||
└─ Client: <✓ Installed | ❌ Missing>
|
||||
|
||||
🎯 Service Status:
|
||||
├─ Server: <🟢 RUNNING (PID: xxxx) | 🔴 STOPPED>
|
||||
└─ Client: <🟢 RUNNING (PID: xxxx) | 🔴 STOPPED>
|
||||
|
||||
🌐 Access URLs (if running):
|
||||
├─ Dashboard: http://localhost:<VITE_PORT>
|
||||
├─ Server API: http://localhost:<SERVER_PORT>
|
||||
└─ WebSocket: ws://localhost:<SERVER_PORT>/stream
|
||||
|
||||
Actions:
|
||||
├─ Start: cd trees/<branch-name> && SERVER_PORT=<port> CLIENT_PORT=<port> sh scripts/start-system.sh
|
||||
├─ Stop: SERVER_PORT=<port> CLIENT_PORT=<port> ./scripts/reset-system.sh
|
||||
└─ Remove: /remove_worktree <branch-name>
|
||||
|
||||
───────────────────────────────────────────────────────────────
|
||||
|
||||
[Repeat for each worktree]
|
||||
|
||||
═══════════════════════════════════════════════════════════════
|
||||
|
||||
💡 Quick Commands:
|
||||
|
||||
Create new worktree:
|
||||
└─ /create_worktree <branch-name> [port-offset]
|
||||
|
||||
Remove worktree:
|
||||
└─ /remove_worktree <branch-name>
|
||||
|
||||
Start a stopped worktree:
|
||||
└─ cd trees/<branch-name> && SERVER_PORT=<port> CLIENT_PORT=<port> sh scripts/start-system.sh &
|
||||
|
||||
Stop a running worktree:
|
||||
└─ lsof -ti :<SERVER_PORT> | xargs kill -9 && lsof -ti :<CLIENT_PORT> | xargs kill -9
|
||||
|
||||
View this list again:
|
||||
└─ /list_worktrees
|
||||
|
||||
═══════════════════════════════════════════════════════════════
|
||||
```
|
||||
|
||||
If no worktrees exist in trees/:
|
||||
|
||||
```
|
||||
📊 Git Worktrees Overview
|
||||
|
||||
═══════════════════════════════════════════════════════════════
|
||||
|
||||
🌳 Main Repository (Default)
|
||||
📁 Location: <project-root>
|
||||
🌿 Branch: <current-branch>
|
||||
🔌 Ports: 4000 (server), 5173 (client)
|
||||
🎯 Status: <RUNNING|STOPPED>
|
||||
|
||||
═══════════════════════════════════════════════════════════════
|
||||
|
||||
ℹ️ No worktrees found in trees/ directory
|
||||
|
||||
💡 Create your first worktree:
|
||||
/create_worktree <branch-name>
|
||||
|
||||
This will:
|
||||
• Create isolated git worktree
|
||||
• Configure unique ports (4010, 5183)
|
||||
• Install dependencies
|
||||
• Start services automatically
|
||||
|
||||
═══════════════════════════════════════════════════════════════
|
||||
```
|
||||
|
||||
If worktrees have configuration issues:
|
||||
|
||||
```
|
||||
⚠️ Configuration Warnings:
|
||||
|
||||
• trees/<branch-name>: Missing .env files
|
||||
└─ Fix: Recreate with /create_worktree <branch-name>
|
||||
|
||||
• trees/<branch-name>: Dependencies not installed
|
||||
└─ Fix: cd trees/<branch-name>/apps/server && bun install
|
||||
└─ Fix: cd trees/<branch-name>/apps/client && bun install
|
||||
|
||||
• trees/<branch-name>: Services running but ports mismatch
|
||||
└─ Fix: Stop services and update .env files
|
||||
```
|
||||
|
||||
## Notes
|
||||
|
||||
- Main repository is always shown first (uses default ports)
|
||||
- Worktrees are sorted alphabetically by branch name
|
||||
- Service status is checked in real-time
|
||||
- Port conflicts are detected and highlighted
|
||||
- Orphaned worktrees (in git but not in trees/) are noted
|
||||
- PIDs are shown for running processes for easy termination
|
||||
- All commands are copy-paste ready
|
||||
Reference in New Issue
Block a user