claude-issue-solver 1.10.1 → 1.12.0

package/README.md

@@ -4,6 +4,10 @@
   <img src="claude-issue-solver-logo.webp" alt="Claude Issue Solver Logo" width="200">
 </p>
 
+[![npm version](https://img.shields.io/npm/v/claude-issue-solver.svg)](https://www.npmjs.com/package/claude-issue-solver)
+[![npm downloads](https://img.shields.io/npm/dm/claude-issue-solver.svg)](https://www.npmjs.com/package/claude-issue-solver)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 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.
@@ -67,6 +71,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
@@ -125,6 +140,7 @@ claude-issue --help
 | `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
 

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/commands/list.js

@@ -16,7 +16,10 @@ async function listCommand() {
         return;
     }
     for (const issue of issues) {
-        console.log(`  ${chalk_1.default.cyan(`#${issue.number}`)}\t${issue.title}`);
+        const labels = issue.labels.length > 0
+            ? ' ' + issue.labels.map(l => chalk_1.default.hex(`#${l.color}`).bold(`[${l.name}]`)).join(' ')
+            : '';
+        console.log(`  ${chalk_1.default.cyan(`#${issue.number}`)}\t${issue.title}${labels}`);
     }
     console.log();
 }

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/dist/utils/github.d.ts

@@ -4,9 +4,14 @@ export interface Issue {
     body: string;
     url: string;
 }
+export interface Label {
+    name: string;
+    color: string;
+}
 export interface IssueListItem {
     number: number;
     title: string;
+    labels: Label[];
 }
 export declare function createIssue(title: string, body?: string, labels?: string[]): number | null;
 export declare function getIssue(issueNumber: number): Issue | null;

package/dist/utils/github.js

@@ -48,7 +48,7 @@ function getIssue(issueNumber) {
 }
 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'] });
+        const output = (0, child_process_1.execSync)(`gh issue list --state open --limit ${limit} --json number,title,labels`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
         return JSON.parse(output);
     }
     catch {

package/package.json

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