claude-issue-solver 1.10.0 → 1.11.0

package/README.md

@@ -26,6 +26,7 @@ This CLI tool fetches an issue from your repo, creates a worktree, opens Claude
 $ claude-issue
 
 Open issues for my-project:
+(2 issues with open PRs hidden)
 
 ? Select an issue to solve:
 ❯ #42  Add dark mode support
@@ -45,12 +46,13 @@ Open issues for my-project:
 
 ## Features
 
-- 🎯 **Interactive issue selection** - Lists open issues with arrow-key navigation
+- 🎯 **Interactive issue selection** - Lists open issues with arrow-key navigation (hides issues with open PRs)
 - ✨ **Create and solve** - Create new issues and start solving them immediately
 - 🌿 **Worktree isolation** - Each issue gets its own worktree, work on multiple issues in parallel
-- 🤖 **Automatic PR creation** - Creates a PR that closes the issue when merged
-- 📁 **Works with any repo** - Auto-detects project name from git remote
-- 💻 **Opens in new terminal** - Keeps your current terminal free (supports iTerm2 and Terminal.app on macOS)
+- 🤖 **Real-time PR creation** - Automatically creates/updates PR as Claude commits changes
+- 🧹 **Smart cleanup** - Auto-clean merged PRs, close VS Code/terminal windows on macOS
+- 📁 **Monorepo support** - Recursively copies all `.env*` files, symlinks `node_modules`
+- 💻 **Cross-platform terminals** - iTerm2, Terminal.app (macOS), gnome-terminal, xterm, konsole (Linux)
 
 ## Requirements
 
@@ -65,6 +67,17 @@ Open issues for my-project:
 npm install -g claude-issue-solver
 ```
 
+Then run the setup wizard to check/install requirements:
+
+```bash
+claude-issue init
+```
+
+This will:
+- Check for Node.js, GitHub CLI, Claude Code, and Git
+- Install missing tools (on macOS via Homebrew)
+- Guide you through authentication for `gh` and `claude`
+
 Or install from source:
 
 ```bash
@@ -88,37 +101,61 @@ claude-issue 42
 
 # List open issues
 claude-issue list
+claude-issue ls
+
+# Create a new issue and solve it immediately
+claude-issue new "Add dark mode support"
+claude-issue new "Fix login bug" -b "Users can't login on mobile"
+claude-issue new "Fix crash" -l bug -l priority
 
 # Create PR for a solved issue (if you skipped it earlier)
 claude-issue pr 42
 
-# Clean up worktree and branch after PR is merged
-claude-issue clean 42
-
-# Clean all worktrees (shows PR/issue status)
-claude-issue clean
+# Clean up worktree and branch
+claude-issue clean 42        # Clean specific issue
+claude-issue clean           # Interactive selection
+claude-issue clean --all     # Clean all worktrees (with confirmation)
+claude-issue clean --merged  # Auto-clean only merged PRs (no confirmation)
 
 # Navigate to a worktree or open its PR
-claude-issue go
-
-# Create a new issue and solve it immediately
-claude-issue new "Add dark mode support"
-
-# With description and labels
-claude-issue new "Fix login bug" -b "Users can't login on mobile" -l bug
+claude-issue go              # Interactive selection
+claude-issue go 42           # Go to specific issue
 
 # Show help
 claude-issue --help
 ```
 
+## Commands Reference
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `claude-issue` | - | Interactive issue selection |
+| `claude-issue <number>` | - | Solve specific issue |
+| `claude-issue new <title>` | - | Create issue and solve it |
+| `claude-issue list` | `ls` | List open issues |
+| `claude-issue pr <number>` | - | Create PR for solved issue |
+| `claude-issue clean [number]` | `rm` | Remove worktree and branch |
+| `claude-issue go [number]` | - | Navigate to worktree |
+| `claude-issue init` | - | Setup wizard for requirements |
+
+### Command Options
+
+**`new` command:**
+- `-b, --body <text>` - Issue description
+- `-l, --label <name>` - Add label (can be used multiple times)
+
+**`clean` command:**
+- `-a, --all` - Clean all issue worktrees (with confirmation)
+- `-m, --merged` - Clean only worktrees with merged PRs (no confirmation)
+
 ## How it works
 
 1. **Fetches issue** - Gets title and description from GitHub
 2. **Creates worktree** - Makes a new git worktree with branch `issue-{number}-{slug}`
-3. **Sets up environment** - Copies `.env` files, symlinks `node_modules`
+3. **Sets up environment** - Recursively copies all `.env*` files, symlinks `node_modules`
 4. **Opens Claude** - Launches Claude Code in a new terminal with the issue as context
-5. **Interactive session** - Claude stays open so you can ask for changes
-6. **Creates PR** - When you exit, prompts to create a PR that closes the issue
+5. **Real-time PR creation** - Background watcher creates PR on first commit, pushes updates on subsequent commits
+6. **Interactive session** - Claude stays open so you can ask for changes
 
 ## Workflow
 
@@ -149,24 +186,65 @@ claude-issue --help
          │
          ▼
 ┌─────────────────┐
-│ Create PR       │
+│ Auto-create PR  │
 │ "Closes #42"    │
 └────────┬────────┘
          │
          ▼
 ┌─────────────────┐
 │ claude-issue    │
-│ clean 42        │
+│ clean --merged  │
 └─────────────────┘
 ```
 
+## Smart Features
+
+### Issue Filtering
+When selecting issues, the tool automatically hides issues that already have open PRs from `issue-{number}-*` branches. A message shows how many were hidden.
+
+### PR Status Display
+When cleaning, the tool shows the status of each worktree:
+- `✓ PR merged` - Safe to clean
+- `◐ PR open` - PR still under review
+- `✗ PR closed` - PR was closed without merging
+- `● Issue closed` - Issue was closed
+- `○ Issue open` - Issue still open
+
+### Orphaned Folder Cleanup
+If a worktree folder exists but isn't registered in git (e.g., after a failed cleanup), the tool detects it and offers to remove it.
+
+### Auto-Close Windows (macOS)
+When cleaning a worktree, the tool automatically closes related terminal windows (iTerm2/Terminal.app) and VS Code windows that have the worktree open.
+
+### Monorepo Support
+The tool recursively finds and copies all `.env*` files from your project, preserving directory structure. This works great with turborepo and other monorepo setups where env files exist in subdirectories like `apps/myapp/.env.local`.
+
+Skipped directories: `node_modules`, `.git`, `dist`, `build`, `.next`, `.turbo`
+
+### Branch Naming
+Branches are named `issue-{number}-{slug}` where the slug is:
+- Lowercase with hyphens
+- Max 30 characters
+- Bracket prefixes removed (e.g., `[Bug]` is stripped)
+- Duplicate consecutive words removed (e.g., `fix-fix-bug` → `fix-bug`)
+
 ## Tips
 
-- Use `/exit` in Claude to end the session and trigger PR creation
-- Worktrees share the same `.git` so commits are visible in main repo
-- Run `claude-issue clean` after merging to clean up - it shows PR status (merged/open/closed)
-- You can work on multiple issues in parallel - each gets its own worktree
+- PRs are created automatically when Claude makes commits - no need to wait until the end
+- Use `claude-issue clean --merged` after merging PRs for quick cleanup
+- Worktrees share the same `.git` so commits are visible in the main repo
+- You can work on multiple issues in parallel - each gets its own worktree and terminal
 - Use `claude-issue go` to quickly navigate to worktrees or open PRs in browser
+- The `go` command also offers options to open in Finder (macOS) or copy the cd command
+
+## Platform Support
+
+| Feature | macOS | Linux |
+|---------|-------|-------|
+| New terminal window | iTerm2, Terminal.app | gnome-terminal, xterm, konsole |
+| Auto-close terminals on clean | ✓ | - |
+| Auto-close VS Code on clean | ✓ | - |
+| Open in Finder | ✓ | - |
 
 ## License
 

package/dist/commands/init.d.ts

@@ -0,0 +1 @@
+export declare function initCommand(): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,232 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initCommand = initCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const child_process_1 = require("child_process");
+const os = __importStar(require("os"));
+function commandExists(cmd) {
+    try {
+        (0, child_process_1.execSync)(`which ${cmd}`, { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isGhAuthenticated() {
+    try {
+        (0, child_process_1.execSync)('gh auth status', { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isClaudeAuthenticated() {
+    try {
+        // Claude Code stores auth in ~/.claude or similar
+        // Just check if it runs without error
+        (0, child_process_1.execSync)('claude --version', { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function installWithBrew(pkg) {
+    if (!commandExists('brew')) {
+        console.log(chalk_1.default.yellow(`\n   Homebrew not found. Please install ${pkg} manually.`));
+        return false;
+    }
+    try {
+        console.log(chalk_1.default.dim(`\n   Running: brew install ${pkg}`));
+        (0, child_process_1.spawnSync)('brew', ['install', pkg], { stdio: 'inherit' });
+        return commandExists(pkg === 'gh' ? 'gh' : pkg);
+    }
+    catch {
+        return false;
+    }
+}
+function installWithNpm(pkg) {
+    try {
+        console.log(chalk_1.default.dim(`\n   Running: npm install -g ${pkg}`));
+        (0, child_process_1.spawnSync)('npm', ['install', '-g', pkg], { stdio: 'inherit' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function runGhAuth() {
+    try {
+        console.log(chalk_1.default.dim('\n   Running: gh auth login'));
+        console.log(chalk_1.default.cyan('   Follow the prompts to authenticate with GitHub:\n'));
+        (0, child_process_1.spawnSync)('gh', ['auth', 'login'], { stdio: 'inherit' });
+        return isGhAuthenticated();
+    }
+    catch {
+        return false;
+    }
+}
+function runClaudeAuth() {
+    try {
+        console.log(chalk_1.default.dim('\n   Running: claude'));
+        console.log(chalk_1.default.cyan('   Follow the prompts to authenticate with Anthropic:\n'));
+        (0, child_process_1.spawnSync)('claude', ['--help'], { stdio: 'inherit' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function initCommand() {
+    console.log(chalk_1.default.bold('\n🔧 Claude Issue Solver - Setup\n'));
+    const platform = os.platform();
+    const isMac = platform === 'darwin';
+    const requirements = [
+        {
+            name: 'Node.js',
+            check: () => {
+                try {
+                    const version = (0, child_process_1.execSync)('node --version', { encoding: 'utf-8' }).trim();
+                    const major = parseInt(version.replace('v', '').split('.')[0], 10);
+                    return major >= 18;
+                }
+                catch {
+                    return false;
+                }
+            },
+            installCmd: 'https://nodejs.org/ or: brew install node',
+        },
+        {
+            name: 'GitHub CLI',
+            check: () => commandExists('gh'),
+            install: () => installWithBrew('gh'),
+            authCheck: isGhAuthenticated,
+            auth: runGhAuth,
+            installCmd: isMac ? 'brew install gh' : 'https://cli.github.com/',
+            authCmd: 'gh auth login',
+        },
+        {
+            name: 'Claude Code',
+            check: () => commandExists('claude'),
+            install: () => installWithNpm('@anthropic-ai/claude-code'),
+            authCheck: isClaudeAuthenticated,
+            auth: runClaudeAuth,
+            installCmd: 'npm install -g @anthropic-ai/claude-code',
+            authCmd: 'claude (follow prompts)',
+        },
+        {
+            name: 'Git',
+            check: () => commandExists('git'),
+            installCmd: isMac ? 'xcode-select --install' : 'apt install git',
+        },
+    ];
+    let allPassed = true;
+    for (const req of requirements) {
+        const spinner = (0, ora_1.default)(`Checking ${req.name}...`).start();
+        // Check if installed
+        if (req.check()) {
+            // Check if authenticated (if applicable)
+            if (req.authCheck && !req.authCheck()) {
+                spinner.warn(chalk_1.default.yellow(`${req.name} - not authenticated`));
+                if (req.auth) {
+                    const authSpinner = (0, ora_1.default)(`Authenticating ${req.name}...`).start();
+                    authSpinner.stop();
+                    if (req.auth()) {
+                        console.log(chalk_1.default.green(`   ✓ ${req.name} authenticated`));
+                    }
+                    else {
+                        console.log(chalk_1.default.red(`   ✗ ${req.name} authentication failed`));
+                        console.log(chalk_1.default.dim(`     Run manually: ${req.authCmd}`));
+                        allPassed = false;
+                    }
+                }
+            }
+            else {
+                spinner.succeed(chalk_1.default.green(`${req.name}`));
+            }
+        }
+        else {
+            spinner.fail(chalk_1.default.red(`${req.name} - not found`));
+            // Try to install
+            if (req.install && isMac) {
+                const installSpinner = (0, ora_1.default)(`Installing ${req.name}...`).start();
+                installSpinner.stop();
+                if (req.install()) {
+                    console.log(chalk_1.default.green(`   ✓ ${req.name} installed`));
+                    // Now check auth if needed
+                    if (req.authCheck && !req.authCheck() && req.auth) {
+                        console.log(chalk_1.default.yellow(`   → ${req.name} needs authentication`));
+                        if (req.auth()) {
+                            console.log(chalk_1.default.green(`   ✓ ${req.name} authenticated`));
+                        }
+                        else {
+                            console.log(chalk_1.default.red(`   ✗ ${req.name} authentication failed`));
+                            console.log(chalk_1.default.dim(`     Run manually: ${req.authCmd}`));
+                            allPassed = false;
+                        }
+                    }
+                }
+                else {
+                    console.log(chalk_1.default.red(`   ✗ Failed to install ${req.name}`));
+                    console.log(chalk_1.default.dim(`     Install manually: ${req.installCmd}`));
+                    allPassed = false;
+                }
+            }
+            else {
+                console.log(chalk_1.default.dim(`     Install: ${req.installCmd}`));
+                allPassed = false;
+            }
+        }
+    }
+    console.log();
+    if (allPassed) {
+        console.log(chalk_1.default.green.bold('✅ All requirements met! You\'re ready to use claude-issue.\n'));
+        console.log(chalk_1.default.dim('Try running:'));
+        console.log(chalk_1.default.cyan('  claude-issue list    # List open issues'));
+        console.log(chalk_1.default.cyan('  claude-issue         # Interactive issue selection'));
+        console.log(chalk_1.default.cyan('  claude-issue new "Title"  # Create and solve new issue\n'));
+    }
+    else {
+        console.log(chalk_1.default.yellow.bold('⚠️  Some requirements are missing.\n'));
+        console.log(chalk_1.default.dim('Please install the missing requirements and run `claude-issue init` again.\n'));
+    }
+}

package/dist/index.js

@@ -15,6 +15,7 @@ const clean_1 = require("./commands/clean");
 const select_1 = require("./commands/select");
 const go_1 = require("./commands/go");
 const new_1 = require("./commands/new");
+const init_1 = require("./commands/init");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const packageJson = require('../package.json');
 const program = new commander_1.Command();
@@ -22,8 +23,14 @@ program
     .name('claude-issue')
     .description('Automatically solve GitHub issues using Claude Code')
     .version(packageJson.version);
-// Check requirements before any command
-program.hook('preAction', () => {
+// Commands that skip requirements check
+const skipRequirementsCommands = ['init'];
+// Check requirements before any command (except init)
+program.hook('preAction', (thisCommand) => {
+    const commandName = thisCommand.name();
+    if (skipRequirementsCommands.includes(commandName)) {
+        return;
+    }
     if (!(0, git_1.isGitRepo)()) {
         console.log(chalk_1.default.red('❌ Not in a git repository'));
         process.exit(1);
@@ -120,4 +127,11 @@ program
     .action(async (title, options) => {
     await (0, new_1.newCommand)(title, options);
 });
+// Init command - guided setup
+program
+    .command('init')
+    .description('Check and install requirements (gh, claude-code)')
+    .action(async () => {
+    await (0, init_1.initCommand)();
+});
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-issue-solver",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Automatically solve GitHub issues using Claude Code",
   "main": "dist/index.js",
   "bin": {