claude-issue-solver 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,143 @@
+# Claude Issue Solver
+
+Automatically solve GitHub issues using [Claude Code](https://claude.ai/code).
+
+This CLI tool fetches an issue from your repo, creates a worktree, opens Claude Code in a new terminal to solve it, and creates a PR when done.
+
+## Demo
+
+```bash
+$ claude-issue
+
+Open issues for my-project:
+
+? Select an issue to solve:
+❯ #42  Add dark mode support
+  #38  Fix login bug on mobile
+  #35  Update dependencies
+  Cancel
+
+📋 Fetching issue #42...
+✔ Found issue #42
+📌 Issue: Add dark mode support
+🌿 Creating worktree with branch: issue-42-add-dark-mode-support
+🤖 Opening new terminal to run Claude Code...
+
+✅ Worktree created at: ../my-project-issue-42-add-dark-mode-support
+   Claude is running in a new terminal window.
+```
+
+## Features
+
+- 🎯 **Interactive issue selection** - Lists open issues with arrow-key navigation
+- 🌿 **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)
+
+## Requirements
+
+- [Node.js](https://nodejs.org/) >= 18
+- [Claude Code CLI](https://claude.ai/code) - `npm install -g @anthropic-ai/claude-code`
+- [GitHub CLI](https://cli.github.com/) - `brew install gh` (and run `gh auth login`)
+- Git
+
+## Installation
+
+```bash
+npm install -g claude-issue-solver
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/MikeOuroumis/claude-issue-solver.git
+cd claude-issue-solver
+npm install
+npm run build
+npm link
+```
+
+## Usage
+
+Run from any git repository with GitHub issues:
+
+```bash
+# Interactive: show issues and select one
+claude-issue
+
+# Solve a specific issue directly
+claude-issue 42
+
+# List open issues
+claude-issue list
+
+# 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
+
+# Show help
+claude-issue --help
+```
+
+## 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`
+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
+
+## Workflow
+
+```
+┌─────────────────┐
+│  claude-issue   │
+│   (select 42)   │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│ Create worktree │
+│ ../project-issue│
+│ -42-fix-bug     │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│ Open new term   │
+│ with Claude     │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│ Claude solves   │
+│ issue & commits │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│ Create PR       │
+│ "Closes #42"    │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│ claude-issue    │
+│ clean 42        │
+└─────────────────┘
+```
+
+## 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 <number>` after merging to clean up
+- You can work on multiple issues in parallel - each gets its own worktree
+
+## License
+
+MIT

package/dist/commands/clean.d.ts

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

package/dist/commands/clean.js

@@ -0,0 +1,107 @@
+"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.cleanCommand = cleanCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const github_1 = require("../utils/github");
+const git_1 = require("../utils/git");
+const helpers_1 = require("../utils/helpers");
+async function cleanCommand(issueNumber) {
+    const spinner = (0, ora_1.default)(`Fetching issue #${issueNumber}...`).start();
+    const issue = (0, github_1.getIssue)(issueNumber);
+    if (!issue) {
+        spinner.fail(`Could not find issue #${issueNumber}`);
+        process.exit(1);
+    }
+    spinner.succeed(`Found issue #${issueNumber}`);
+    const projectRoot = (0, git_1.getProjectRoot)();
+    const projectName = (0, git_1.getProjectName)();
+    const branchSlug = (0, helpers_1.slugify)(issue.title);
+    const branchName = `issue-${issueNumber}-${branchSlug}`;
+    const worktreePath = path.join(path.dirname(projectRoot), `${projectName}-${branchName}`);
+    console.log();
+    console.log(chalk_1.default.bold(`🧹 Cleaning up issue #${issueNumber}`));
+    console.log(chalk_1.default.dim(`   Branch: ${branchName}`));
+    console.log(chalk_1.default.dim(`   Worktree: ${worktreePath}`));
+    console.log();
+    const { confirm } = await inquirer_1.default.prompt([
+        {
+            type: 'confirm',
+            name: 'confirm',
+            message: 'Remove worktree and delete branch?',
+            default: false,
+        },
+    ]);
+    if (!confirm) {
+        console.log(chalk_1.default.dim('Cancelled.'));
+        return;
+    }
+    // Remove worktree
+    if (fs.existsSync(worktreePath)) {
+        const worktreeSpinner = (0, ora_1.default)('Removing worktree...').start();
+        try {
+            (0, child_process_1.execSync)(`git worktree remove "${worktreePath}" --force`, {
+                cwd: projectRoot,
+                stdio: 'pipe',
+            });
+            worktreeSpinner.succeed('Worktree removed');
+        }
+        catch {
+            worktreeSpinner.warn('Could not remove worktree (may already be removed)');
+        }
+    }
+    // Delete branch
+    const branchSpinner = (0, ora_1.default)('Deleting branch...').start();
+    try {
+        (0, child_process_1.execSync)(`git branch -D "${branchName}"`, {
+            cwd: projectRoot,
+            stdio: 'pipe',
+        });
+        branchSpinner.succeed('Branch deleted');
+    }
+    catch {
+        branchSpinner.warn('Could not delete branch (may already be deleted)');
+    }
+    console.log();
+    console.log(chalk_1.default.green('✅ Cleanup complete!'));
+}

package/dist/commands/list.d.ts

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

package/dist/commands/list.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listCommand = listCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const github_1 = require("../utils/github");
+const git_1 = require("../utils/git");
+async function listCommand() {
+    const projectName = (0, git_1.getProjectName)();
+    console.log(chalk_1.default.bold(`\nOpen issues for ${projectName}:\n`));
+    const issues = (0, github_1.listIssues)();
+    if (issues.length === 0) {
+        console.log(chalk_1.default.yellow('No open issues found.'));
+        return;
+    }
+    for (const issue of issues) {
+        console.log(`  ${chalk_1.default.cyan(`#${issue.number}`)}\t${issue.title}`);
+    }
+    console.log();
+}

package/dist/commands/pr.d.ts

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

package/dist/commands/pr.js

@@ -0,0 +1,121 @@
+"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.prCommand = prCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const github_1 = require("../utils/github");
+const git_1 = require("../utils/git");
+const helpers_1 = require("../utils/helpers");
+async function prCommand(issueNumber) {
+    const spinner = (0, ora_1.default)(`Fetching issue #${issueNumber}...`).start();
+    const issue = (0, github_1.getIssue)(issueNumber);
+    if (!issue) {
+        spinner.fail(`Could not find issue #${issueNumber}`);
+        process.exit(1);
+    }
+    spinner.succeed(`Found issue #${issueNumber}`);
+    const projectRoot = (0, git_1.getProjectRoot)();
+    const projectName = (0, git_1.getProjectName)();
+    const branchSlug = (0, helpers_1.slugify)(issue.title);
+    const branchName = `issue-${issueNumber}-${branchSlug}`;
+    const worktreePath = path.join(path.dirname(projectRoot), `${projectName}-${branchName}`);
+    if (!fs.existsSync(worktreePath)) {
+        console.log(chalk_1.default.red(`\n❌ Worktree not found at ${worktreePath}`));
+        console.log(chalk_1.default.dim(`   Make sure you've run: claude-issue ${issueNumber}`));
+        process.exit(1);
+    }
+    const commits = (0, git_1.getCommitCount)(worktreePath);
+    if (commits === 0) {
+        console.log(chalk_1.default.yellow(`\n⚠️  No commits found on branch ${branchName}`));
+        console.log(chalk_1.default.dim(`   Make sure Claude has committed changes before creating a PR.`));
+        process.exit(1);
+    }
+    console.log();
+    console.log(chalk_1.default.bold(`📋 Issue #${issueNumber}: ${issue.title}`));
+    console.log(chalk_1.default.dim(`🌿 Branch: ${branchName}`));
+    console.log(chalk_1.default.dim(`📝 Commits: ${commits}`));
+    console.log();
+    const { confirm } = await inquirer_1.default.prompt([
+        {
+            type: 'confirm',
+            name: 'confirm',
+            message: `Create PR to close issue #${issueNumber}?`,
+            default: true,
+        },
+    ]);
+    if (!confirm) {
+        console.log(chalk_1.default.dim('Cancelled.'));
+        return;
+    }
+    const pushSpinner = (0, ora_1.default)('Pushing branch and creating PR...').start();
+    try {
+        (0, child_process_1.execSync)(`git push -u origin "${branchName}"`, {
+            cwd: worktreePath,
+            stdio: 'pipe',
+        });
+        const commitList = (0, git_1.getCommitList)(worktreePath);
+        const prBody = `## Summary
+
+Closes #${issueNumber}
+
+## Changes
+
+${commitList}
+
+---
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)`;
+        const prUrl = (0, child_process_1.execSync)(`gh pr create --title "Fix #${issueNumber}: ${issue.title.replace(/"/g, '\\"')}" --body "${prBody.replace(/"/g, '\\"')}" --head "${branchName}" --base main`, { cwd: worktreePath, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        pushSpinner.succeed('PR created!');
+        console.log();
+        console.log(chalk_1.default.green(`✅ PR created: ${prUrl}`));
+        console.log();
+        console.log(chalk_1.default.dim(`The PR will automatically close issue #${issueNumber} when merged.`));
+        console.log(chalk_1.default.dim(`To clean up after merge: claude-issue clean ${issueNumber}`));
+    }
+    catch (error) {
+        pushSpinner.fail('Failed to create PR');
+        console.error(error);
+        process.exit(1);
+    }
+}

package/dist/commands/select.d.ts

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

package/dist/commands/select.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectCommand = selectCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const github_1 = require("../utils/github");
+const git_1 = require("../utils/git");
+const solve_1 = require("./solve");
+async function selectCommand() {
+    const projectName = (0, git_1.getProjectName)();
+    console.log(chalk_1.default.bold(`\nOpen issues for ${projectName}:\n`));
+    const issues = (0, github_1.listIssues)();
+    if (issues.length === 0) {
+        console.log(chalk_1.default.yellow('No open issues found.'));
+        return;
+    }
+    const choices = issues.map((issue) => ({
+        name: `#${issue.number}\t${issue.title}`,
+        value: issue.number,
+    }));
+    choices.push({
+        name: chalk_1.default.dim('Cancel'),
+        value: -1,
+    });
+    const { issueNumber } = await inquirer_1.default.prompt([
+        {
+            type: 'list',
+            name: 'issueNumber',
+            message: 'Select an issue to solve:',
+            choices,
+            pageSize: 15,
+        },
+    ]);
+    if (issueNumber === -1) {
+        console.log(chalk_1.default.dim('Cancelled.'));
+        return;
+    }
+    await (0, solve_1.solveCommand)(issueNumber);
+}

package/dist/commands/solve.d.ts

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

package/dist/commands/solve.js

@@ -0,0 +1,198 @@
+"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.solveCommand = solveCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const github_1 = require("../utils/github");
+const git_1 = require("../utils/git");
+const helpers_1 = require("../utils/helpers");
+async function solveCommand(issueNumber) {
+    const spinner = (0, ora_1.default)(`Fetching issue #${issueNumber}...`).start();
+    const issue = (0, github_1.getIssue)(issueNumber);
+    if (!issue) {
+        spinner.fail(`Could not find issue #${issueNumber}`);
+        process.exit(1);
+    }
+    spinner.succeed(`Found issue #${issueNumber}`);
+    console.log();
+    console.log(chalk_1.default.bold(`📌 Issue: ${issue.title}`));
+    console.log(chalk_1.default.dim(`🔗 URL: ${issue.url}`));
+    console.log();
+    const projectRoot = (0, git_1.getProjectRoot)();
+    const projectName = (0, git_1.getProjectName)();
+    const branchSlug = (0, helpers_1.slugify)(issue.title);
+    const branchName = `issue-${issueNumber}-${branchSlug}`;
+    const worktreePath = path.join(path.dirname(projectRoot), `${projectName}-${branchName}`);
+    // Fetch latest main
+    const fetchSpinner = (0, ora_1.default)('Fetching latest main...').start();
+    try {
+        (0, child_process_1.execSync)('git fetch origin main --quiet', { cwd: projectRoot, stdio: 'pipe' });
+        fetchSpinner.succeed('Fetched latest main');
+    }
+    catch {
+        fetchSpinner.warn('Could not fetch origin/main');
+    }
+    // Check if worktree already exists
+    if (fs.existsSync(worktreePath)) {
+        console.log(chalk_1.default.yellow(`\n🌿 Worktree already exists at: ${worktreePath}`));
+        console.log(chalk_1.default.dim(`   Resuming work on issue #${issueNumber}...`));
+    }
+    else {
+        const worktreeSpinner = (0, ora_1.default)(`Creating worktree with branch: ${branchName}`).start();
+        try {
+            if ((0, git_1.branchExists)(branchName)) {
+                (0, child_process_1.execSync)(`git worktree add "${worktreePath}" "${branchName}"`, {
+                    cwd: projectRoot,
+                    stdio: 'pipe',
+                });
+            }
+            else {
+                (0, child_process_1.execSync)(`git worktree add "${worktreePath}" -b "${branchName}" origin/main`, {
+                    cwd: projectRoot,
+                    stdio: 'pipe',
+                });
+            }
+            worktreeSpinner.succeed(`Created worktree at: ${worktreePath}`);
+        }
+        catch (error) {
+            worktreeSpinner.fail('Failed to create worktree');
+            console.error(error);
+            process.exit(1);
+        }
+        // Copy env files and symlink node_modules
+        const setupSpinner = (0, ora_1.default)('Setting up worktree...').start();
+        (0, helpers_1.copyEnvFiles)(projectRoot, worktreePath);
+        (0, helpers_1.symlinkNodeModules)(projectRoot, worktreePath);
+        setupSpinner.succeed('Worktree setup complete');
+    }
+    // Build the prompt for Claude
+    const prompt = `Please solve this GitHub issue:
+
+## Issue #${issueNumber}: ${issue.title}
+
+${issue.body}
+
+---
+
+Instructions:
+1. Analyze the issue and understand what needs to be done
+2. Implement the necessary changes
+3. Make sure to run tests if applicable
+4. When done, commit your changes with a descriptive message that references the issue`;
+    // Create runner script
+    const runnerScript = path.join(worktreePath, '.claude-runner.sh');
+    const runnerContent = `#!/bin/bash
+cd "${worktreePath}"
+echo "🤖 Claude Code - Issue #${issueNumber}: ${issue.title}"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "Claude will stay open after solving the issue."
+echo "You can ask for more changes or type /exit when done."
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+claude --dangerously-skip-permissions "${prompt.replace(/"/g, '\\"').replace(/\n/g, '\\n')}"
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "Claude session ended."
+echo ""
+
+COMMITS=$(git log origin/main..HEAD --oneline 2>/dev/null | wc -l | tr -d ' ')
+
+if [ "$COMMITS" -eq 0 ]; then
+  echo "⚠️  No commits were made."
+  echo "To clean up: claude-issue clean ${issueNumber}"
+else
+  echo "✅ Found $COMMITS commit(s)"
+  echo ""
+  read -p "Create PR to close issue #${issueNumber}? (Y/n) " -n 1 -r
+  echo ""
+
+  if [[ ! $REPLY =~ ^[Nn]$ ]]; then
+    echo ""
+    echo "📤 Pushing branch and creating PR..."
+
+    git push -u origin "${branchName}"
+
+    COMMIT_LIST=$(git log origin/main..HEAD --pretty=format:'- %s' | head -10)
+
+    PR_URL=$(gh pr create \\
+      --title "Fix #${issueNumber}: ${issue.title.replace(/"/g, '\\"')}" \\
+      --body "## Summary
+
+Closes #${issueNumber}
+
+## Changes
+
+$COMMIT_LIST
+
+---
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)" \\
+      --head "${branchName}" \\
+      --base main)
+
+    echo ""
+    echo "✅ PR created: $PR_URL"
+    echo ""
+    echo "The PR will automatically close issue #${issueNumber} when merged."
+  fi
+
+  echo ""
+  echo "To clean up after merge: claude-issue clean ${issueNumber}"
+fi
+
+echo ""
+rm -f "${runnerScript}"
+`;
+    fs.writeFileSync(runnerScript, runnerContent, { mode: 0o755 });
+    console.log();
+    console.log(chalk_1.default.cyan('🤖 Opening new terminal to run Claude Code...'));
+    console.log();
+    (0, helpers_1.openInNewTerminal)(`'${runnerScript}'`);
+    console.log(chalk_1.default.green(`✅ Worktree created at: ${worktreePath}`));
+    console.log(chalk_1.default.dim(`   Claude is running in a new terminal window.`));
+    console.log();
+    console.log(chalk_1.default.dim(`   You can also open VS Code: code ${worktreePath}`));
+    console.log(chalk_1.default.dim(`   To clean up later: claude-issue clean ${issueNumber}`));
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const helpers_1 = require("./utils/helpers");
+const git_1 = require("./utils/git");
+const list_1 = require("./commands/list");
+const solve_1 = require("./commands/solve");
+const pr_1 = require("./commands/pr");
+const clean_1 = require("./commands/clean");
+const select_1 = require("./commands/select");
+const program = new commander_1.Command();
+program
+    .name('claude-issue')
+    .description('Automatically solve GitHub issues using Claude Code')
+    .version('1.0.0');
+// Check requirements before any command
+program.hook('preAction', () => {
+    if (!(0, git_1.isGitRepo)()) {
+        console.log(chalk_1.default.red('❌ Not in a git repository'));
+        process.exit(1);
+    }
+    const { ok, missing } = (0, helpers_1.checkRequirements)();
+    if (!ok) {
+        console.log(chalk_1.default.red('\n❌ Missing requirements:\n'));
+        for (const m of missing) {
+            console.log(chalk_1.default.yellow(`   • ${m}`));
+        }
+        console.log();
+        process.exit(1);
+    }
+});
+// Default command - interactive selection
+program
+    .argument('[issue]', 'Issue number to solve')
+    .action(async (issue) => {
+    if (issue) {
+        const issueNumber = parseInt(issue, 10);
+        if (isNaN(issueNumber)) {
+            console.log(chalk_1.default.red(`❌ Invalid issue number: ${issue}`));
+            process.exit(1);
+        }
+        await (0, solve_1.solveCommand)(issueNumber);
+    }
+    else {
+        await (0, select_1.selectCommand)();
+    }
+});
+// List command
+program
+    .command('list')
+    .alias('ls')
+    .description('List open issues')
+    .action(list_1.listCommand);
+// PR command
+program
+    .command('pr <issue>')
+    .description('Create PR for a solved issue')
+    .action(async (issue) => {
+    const issueNumber = parseInt(issue, 10);
+    if (isNaN(issueNumber)) {
+        console.log(chalk_1.default.red(`❌ Invalid issue number: ${issue}`));
+        process.exit(1);
+    }
+    await (0, pr_1.prCommand)(issueNumber);
+});
+// Clean command
+program
+    .command('clean <issue>')
+    .alias('rm')
+    .description('Remove worktree and branch for an issue')
+    .action(async (issue) => {
+    const issueNumber = parseInt(issue, 10);
+    if (isNaN(issueNumber)) {
+        console.log(chalk_1.default.red(`❌ Invalid issue number: ${issue}`));
+        process.exit(1);
+    }
+    await (0, clean_1.cleanCommand)(issueNumber);
+});
+program.parse();

package/dist/utils/git.d.ts

@@ -0,0 +1,8 @@
+export declare function exec(command: string, cwd?: string): string;
+export declare function execOrFail(command: string, cwd?: string): string;
+export declare function getProjectRoot(): string;
+export declare function getProjectName(): string;
+export declare function isGitRepo(): boolean;
+export declare function branchExists(branchName: string): boolean;
+export declare function getCommitCount(worktreePath: string): number;
+export declare function getCommitList(worktreePath: string, limit?: number): string;

package/dist/utils/git.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exec = exec;
+exports.execOrFail = execOrFail;
+exports.getProjectRoot = getProjectRoot;
+exports.getProjectName = getProjectName;
+exports.isGitRepo = isGitRepo;
+exports.branchExists = branchExists;
+exports.getCommitCount = getCommitCount;
+exports.getCommitList = getCommitList;
+const child_process_1 = require("child_process");
+function exec(command, cwd) {
+    try {
+        return (0, child_process_1.execSync)(command, {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch (error) {
+        return '';
+    }
+}
+function execOrFail(command, cwd) {
+    return (0, child_process_1.execSync)(command, {
+        cwd,
+        encoding: 'utf-8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+    }).trim();
+}
+function getProjectRoot() {
+    try {
+        return exec('git rev-parse --show-toplevel') || process.cwd();
+    }
+    catch {
+        return process.cwd();
+    }
+}
+function getProjectName() {
+    // Try to get from git remote
+    const remoteUrl = exec('git config --get remote.origin.url');
+    if (remoteUrl) {
+        // Extract repo name from URL (handles both HTTPS and SSH)
+        const match = remoteUrl.match(/\/([^/]+?)(\.git)?$/);
+        if (match) {
+            return match[1].replace('.git', '');
+        }
+    }
+    // Fallback to current directory name
+    return require('path').basename(process.cwd());
+}
+function isGitRepo() {
+    try {
+        (0, child_process_1.execSync)('git rev-parse --git-dir', { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function branchExists(branchName) {
+    try {
+        (0, child_process_1.execSync)(`git show-ref --verify --quiet refs/heads/${branchName}`, {
+            stdio: 'pipe',
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function getCommitCount(worktreePath) {
+    try {
+        const output = exec('git log origin/main..HEAD --oneline', worktreePath);
+        if (!output)
+            return 0;
+        return output.split('\n').filter(Boolean).length;
+    }
+    catch {
+        return 0;
+    }
+}
+function getCommitList(worktreePath, limit = 10) {
+    return exec(`git log origin/main..HEAD --pretty=format:'- %s' | head -${limit}`, worktreePath);
+}

package/dist/utils/github.d.ts

@@ -0,0 +1,13 @@
+export interface Issue {
+    number: number;
+    title: string;
+    body: string;
+    url: string;
+}
+export interface IssueListItem {
+    number: number;
+    title: string;
+}
+export declare function getIssue(issueNumber: number): Issue | null;
+export declare function listIssues(limit?: number): IssueListItem[];
+export declare function createPullRequest(title: string, body: string, branch: string, base?: string): string;

package/dist/utils/github.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIssue = getIssue;
+exports.listIssues = listIssues;
+exports.createPullRequest = createPullRequest;
+const child_process_1 = require("child_process");
+function getIssue(issueNumber) {
+    try {
+        const output = (0, child_process_1.execSync)(`gh issue view ${issueNumber} --json title,body,url`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+        const data = JSON.parse(output);
+        return {
+            number: issueNumber,
+            title: data.title,
+            body: data.body || '',
+            url: data.url,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function listIssues(limit = 20) {
+    try {
+        const output = (0, child_process_1.execSync)(`gh issue list --state open --limit ${limit} --json number,title`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+        return JSON.parse(output);
+    }
+    catch {
+        return [];
+    }
+}
+function createPullRequest(title, body, branch, base = 'main') {
+    const output = (0, child_process_1.execSync)(`gh pr create --title "${title}" --body "${body.replace(/"/g, '\\"')}" --head "${branch}" --base "${base}"`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+    return output.trim();
+}

package/dist/utils/helpers.d.ts

@@ -0,0 +1,8 @@
+export declare function slugify(text: string): string;
+export declare function checkRequirements(): {
+    ok: boolean;
+    missing: string[];
+};
+export declare function openInNewTerminal(script: string): void;
+export declare function copyEnvFiles(from: string, to: string): void;
+export declare function symlinkNodeModules(from: string, to: string): void;

package/dist/utils/helpers.js

@@ -0,0 +1,150 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slugify = slugify;
+exports.checkRequirements = checkRequirements;
+exports.openInNewTerminal = openInNewTerminal;
+exports.copyEnvFiles = copyEnvFiles;
+exports.symlinkNodeModules = symlinkNodeModules;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 50);
+}
+function checkRequirements() {
+    const missing = [];
+    try {
+        (0, child_process_1.execSync)('gh --version', { stdio: 'pipe' });
+    }
+    catch {
+        missing.push('gh (GitHub CLI) - Install: brew install gh');
+    }
+    try {
+        (0, child_process_1.execSync)('claude --version', { stdio: 'pipe' });
+    }
+    catch {
+        missing.push('claude (Claude Code CLI) - Install: npm install -g @anthropic-ai/claude-code');
+    }
+    return { ok: missing.length === 0, missing };
+}
+function openInNewTerminal(script) {
+    const platform = os.platform();
+    if (platform === 'darwin') {
+        // macOS - try iTerm2 first, then Terminal
+        const iTermScript = `
+      tell application "iTerm"
+        activate
+        set newWindow to (create window with default profile)
+        tell current session of newWindow
+          write text "${script.replace(/"/g, '\\"')}"
+        end tell
+      end tell
+    `;
+        const terminalScript = `
+      tell application "Terminal"
+        activate
+        do script "${script.replace(/"/g, '\\"')}"
+      end tell
+    `;
+        try {
+            // Check if iTerm is installed
+            if (fs.existsSync('/Applications/iTerm.app')) {
+                (0, child_process_1.execSync)(`osascript -e '${iTermScript}'`, { stdio: 'pipe' });
+            }
+            else {
+                (0, child_process_1.execSync)(`osascript -e '${terminalScript}'`, { stdio: 'pipe' });
+            }
+        }
+        catch {
+            // Fallback to Terminal
+            try {
+                (0, child_process_1.execSync)(`osascript -e '${terminalScript}'`, { stdio: 'pipe' });
+            }
+            catch {
+                console.log('Could not open new terminal. Run manually:');
+                console.log(script);
+            }
+        }
+    }
+    else if (platform === 'linux') {
+        // Linux - try common terminal emulators
+        const terminals = ['gnome-terminal', 'xterm', 'konsole'];
+        for (const term of terminals) {
+            try {
+                (0, child_process_1.execSync)(`which ${term}`, { stdio: 'pipe' });
+                if (term === 'gnome-terminal') {
+                    (0, child_process_1.spawn)(term, ['--', 'bash', '-c', script], { detached: true });
+                }
+                else {
+                    (0, child_process_1.spawn)(term, ['-e', script], { detached: true });
+                }
+                return;
+            }
+            catch {
+                continue;
+            }
+        }
+        console.log('Could not detect terminal emulator. Run manually:');
+        console.log(script);
+    }
+    else {
+        console.log('Unsupported platform. Run manually:');
+        console.log(script);
+    }
+}
+function copyEnvFiles(from, to) {
+    const envFiles = ['.env', '.env.local'];
+    for (const file of envFiles) {
+        const src = path.join(from, file);
+        const dest = path.join(to, file);
+        if (fs.existsSync(src) && !fs.existsSync(dest)) {
+            fs.copyFileSync(src, dest);
+        }
+    }
+}
+function symlinkNodeModules(from, to) {
+    const src = path.join(from, 'node_modules');
+    const dest = path.join(to, 'node_modules');
+    if (fs.existsSync(src) && !fs.existsSync(dest)) {
+        fs.symlinkSync(src, dest);
+    }
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "claude-issue-solver",
+  "version": "1.0.0",
+  "description": "Automatically solve GitHub issues using Claude Code",
+  "main": "dist/index.js",
+  "bin": {
+    "claude-issue": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "claude",
+    "github",
+    "issues",
+    "ai",
+    "automation",
+    "cli"
+  ],
+  "author": "MikeOuroumis",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MikeOuroumis/claude-issue-solver.git"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^12.1.0",
+    "inquirer": "^8.2.6",
+    "ora": "^5.4.1"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^8.2.10",
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist"
+  ]
+}