claude-issue-solver 1.23.1 → 1.24.1

package/README.md

@@ -157,6 +157,7 @@ claude-issue --help
 | `claude-issue show <number>` | - | Show full issue details |
 | `claude-issue pr <number>` | - | Create PR for solved issue |
 | `claude-issue review [number]` | - | Review PRs with AI suggestions |
+| `claude-issue config` | - | Manage settings (bot token) |
 | `claude-issue clean [number]` | `rm` | Remove worktree and branch |
 | `claude-issue go [number]` | - | Navigate to worktree |
 | `claude-issue init` | - | Setup wizard for requirements |
@@ -176,6 +177,11 @@ claude-issue --help
 - `-a, --all` - Clean all issue worktrees (with confirmation)
 - `-m, --merged` - Clean only worktrees with merged PRs (no confirmation)
 
+**`config` command:**
+- `cis config` - Show current configuration
+- `cis config bot-token` - Set up a bot token for reviews
+- `cis config --clear` - Clear all configuration
+
 ## How it works
 
 1. **Fetches issue** - Gets title and description from GitHub
@@ -256,6 +262,23 @@ Branches are named `issue-{number}-{slug}` where the slug is:
 - Bracket prefixes removed (e.g., `[Bug]` is stripped)
 - Duplicate consecutive words removed (e.g., `fix-fix-bug` → `fix-bug`)
 
+### AI Code Review
+The `review` command lets Claude review PRs and post suggestions:
+
+```bash
+cis review          # Select PRs to review (parallel)
+cis review 42       # Review specific issue's PR
+```
+
+Claude auto-detects whether you're reviewing your own PR or someone else's:
+- **Your own PR**: Posts comments with suggestions (GitHub limitation)
+- **Someone else's PR**: Can approve or request changes
+
+**Bot Token (Optional)**: Set up a bot token to get full review capabilities on your own PRs:
+```bash
+cis config bot-token    # Interactive setup with instructions
+```
+
 ## Tips
 
 - PRs are created automatically when Claude makes commits - no need to wait until the end

package/dist/commands/config.d.ts

@@ -0,0 +1,8 @@
+interface Config {
+    botToken?: string;
+}
+export declare function getConfig(): Config;
+export declare function saveConfig(config: Config): void;
+export declare function getBotToken(): string | undefined;
+export declare function configCommand(action?: string, value?: string): Promise<void>;
+export {};

package/dist/commands/config.js

@@ -0,0 +1,259 @@
+"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.getConfig = getConfig;
+exports.saveConfig = saveConfig;
+exports.getBotToken = getBotToken;
+exports.configCommand = configCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const child_process_1 = require("child_process");
+const CONFIG_DIR = path.join(os.homedir(), '.claude-issue-solver');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+function getConfig() {
+    try {
+        if (fs.existsSync(CONFIG_FILE)) {
+            return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    return {};
+}
+function saveConfig(config) {
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    }
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), { mode: 0o600 });
+}
+function getBotToken() {
+    return getConfig().botToken;
+}
+function validateToken(token) {
+    try {
+        const output = (0, child_process_1.execSync)('gh api user --jq .login', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: { ...process.env, GH_TOKEN: token },
+        });
+        return { valid: true, login: output.trim() };
+    }
+    catch (error) {
+        return { valid: false, error: error.message };
+    }
+}
+async function configCommand(action, value) {
+    // Handle clear action
+    if (action === '--clear' || action === 'clear') {
+        if (fs.existsSync(CONFIG_FILE)) {
+            fs.unlinkSync(CONFIG_FILE);
+            console.log(chalk_1.default.green('\n✅ Configuration cleared.\n'));
+        }
+        else {
+            console.log(chalk_1.default.dim('\nNo configuration to clear.\n'));
+        }
+        return;
+    }
+    // Handle bot-token action
+    if (action === 'bot-token') {
+        if (value) {
+            // Direct token provided
+            console.log(chalk_1.default.dim('\nValidating token...'));
+            const result = validateToken(value);
+            if (result.valid) {
+                const config = getConfig();
+                config.botToken = value;
+                saveConfig(config);
+                console.log(chalk_1.default.green(`\n✅ Bot token saved! Authenticated as: ${result.login}\n`));
+            }
+            else {
+                console.log(chalk_1.default.red('\n❌ Invalid token. Please check and try again.\n'));
+            }
+            return;
+        }
+        // Interactive setup
+        await setupBotToken();
+        return;
+    }
+    // Show current config
+    const config = getConfig();
+    console.log(chalk_1.default.bold('\nClaude Issue Solver Configuration\n'));
+    if (config.botToken) {
+        const result = validateToken(config.botToken);
+        if (result.valid) {
+            console.log(`  Bot token: ${chalk_1.default.green('✓ Configured')} (${result.login})`);
+        }
+        else {
+            console.log(`  Bot token: ${chalk_1.default.yellow('⚠ Invalid or expired')}`);
+        }
+    }
+    else {
+        console.log(`  Bot token: ${chalk_1.default.dim('Not configured')}`);
+    }
+    console.log();
+    console.log(chalk_1.default.dim('Commands:'));
+    console.log(chalk_1.default.dim('  cis config bot-token     Set up a bot token for reviews'));
+    console.log(chalk_1.default.dim('  cis config --clear       Clear all configuration'));
+    console.log();
+}
+async function setupBotToken() {
+    console.log(chalk_1.default.bold('\n🤖 Bot Token Setup\n'));
+    console.log(`A bot token allows Claude to post formal reviews (approve/request changes)
+on your own PRs. Without it, Claude can only post comments on your own PRs.
+
+${chalk_1.default.bold('You have two options:')}\n`);
+    const { choice } = await inquirer_1.default.prompt([
+        {
+            type: 'list',
+            name: 'choice',
+            message: 'How would you like to set up the bot?',
+            choices: [
+                { name: 'Use my existing account (create a token)', value: 'same-account' },
+                { name: 'Create a separate bot account (recommended for teams)', value: 'new-account' },
+                { name: 'I already have a token', value: 'have-token' },
+                { name: 'Cancel', value: 'cancel' },
+            ],
+        },
+    ]);
+    if (choice === 'cancel') {
+        console.log(chalk_1.default.dim('\nCancelled.\n'));
+        return;
+    }
+    if (choice === 'have-token') {
+        await promptForToken();
+        return;
+    }
+    if (choice === 'new-account') {
+        console.log(chalk_1.default.bold('\n📝 Creating a Bot Account\n'));
+        console.log(`1. Sign out of GitHub or open an incognito window
+2. Create a new account (e.g., ${chalk_1.default.cyan('yourname-bot')})
+   - Use email alias: ${chalk_1.default.cyan('you+bot@gmail.com')}
+3. Add the bot as a collaborator to your repos:
+   - Repo → Settings → Collaborators → Add the bot
+4. Log into the bot account and create a token (next step)
+`);
+        const { ready } = await inquirer_1.default.prompt([
+            {
+                type: 'confirm',
+                name: 'ready',
+                message: 'Ready to create a token for the bot account?',
+                default: true,
+            },
+        ]);
+        if (!ready) {
+            console.log(chalk_1.default.dim('\nRun `cis config bot-token` when ready.\n'));
+            return;
+        }
+    }
+    // Open GitHub token page
+    console.log(chalk_1.default.bold('\n🔑 Creating a Personal Access Token\n'));
+    console.log(`I'll open GitHub's token creation page. Create a token with:
+
+${chalk_1.default.bold('Settings:')}
+  • Token name: ${chalk_1.default.cyan('claude-issue-solver-bot')}
+  • Expiration: ${chalk_1.default.cyan('90 days')} (or your preference)
+  • Repository access: ${chalk_1.default.cyan('Only select repositories')} (pick your repos)
+
+${chalk_1.default.bold('Permissions needed:')}
+  • ${chalk_1.default.cyan('Pull requests')}: Read and write
+  • ${chalk_1.default.cyan('Contents')}: Read (to see PR diffs)
+`);
+    const { openBrowser } = await inquirer_1.default.prompt([
+        {
+            type: 'confirm',
+            name: 'openBrowser',
+            message: 'Open GitHub token page in browser?',
+            default: true,
+        },
+    ]);
+    if (openBrowser) {
+        const tokenUrl = 'https://github.com/settings/personal-access-tokens/new';
+        try {
+            if (process.platform === 'darwin') {
+                (0, child_process_1.execSync)(`open "${tokenUrl}"`, { stdio: 'pipe' });
+            }
+            else if (process.platform === 'linux') {
+                (0, child_process_1.execSync)(`xdg-open "${tokenUrl}"`, { stdio: 'pipe' });
+            }
+            else {
+                console.log(chalk_1.default.dim(`\nOpen this URL: ${tokenUrl}\n`));
+            }
+            console.log(chalk_1.default.dim('\nOpened GitHub in your browser.\n'));
+        }
+        catch {
+            console.log(chalk_1.default.dim(`\nOpen this URL: ${tokenUrl}\n`));
+        }
+    }
+    else {
+        console.log(chalk_1.default.dim('\nGo to: https://github.com/settings/personal-access-tokens/new\n'));
+    }
+    await promptForToken();
+}
+async function promptForToken() {
+    const { token } = await inquirer_1.default.prompt([
+        {
+            type: 'password',
+            name: 'token',
+            message: 'Paste your token here:',
+            mask: '*',
+        },
+    ]);
+    if (!token) {
+        console.log(chalk_1.default.dim('\nNo token provided.\n'));
+        return;
+    }
+    console.log(chalk_1.default.dim('\nValidating token...'));
+    const result = validateToken(token);
+    if (result.valid) {
+        const config = getConfig();
+        config.botToken = token;
+        saveConfig(config);
+        console.log(chalk_1.default.green(`\n✅ Bot token saved!`));
+        console.log(chalk_1.default.dim(`   Authenticated as: ${result.login}`));
+        console.log(chalk_1.default.dim(`   Config stored in: ${CONFIG_FILE}\n`));
+        console.log(`Now when you run ${chalk_1.default.cyan('cis review')}, Claude can post formal reviews.\n`);
+    }
+    else {
+        console.log(chalk_1.default.red('\n❌ Invalid token. Please check and try again.'));
+        console.log(chalk_1.default.dim('   Run `cis config bot-token` to retry.\n'));
+    }
+}

package/dist/commands/review.js

@@ -47,6 +47,7 @@ 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");
+const config_1 = require("./config");
 async function reviewCommand(issueNumber) {
     const spinner = (0, ora_1.default)(`Fetching issue #${issueNumber}...`).start();
     const issue = (0, github_1.getIssue)(issueNumber);
@@ -151,6 +152,9 @@ async function reviewCommand(issueNumber) {
     catch {
         console.log(chalk_1.default.yellow('Could not fetch PR diff, Claude will review the files directly.'));
     }
+    // Check for bot token early to include in prompt
+    const botToken = (0, config_1.getBotToken)();
+    const ghCmd = botToken ? `GH_TOKEN=\${BOT_TOKEN} gh` : 'gh';
     // Build the review prompt
     const prompt = `You are reviewing PR #${prNumber} for issue #${issueNumber}: ${issue.title}
 
@@ -167,10 +171,19 @@ Review the code changes in this PR. Look for:
 6. Performance problems
 
 ## How to Leave Feedback
-Use the gh CLI to post comments with suggestions. For each issue you find:
+${botToken ? `
+**IMPORTANT: A bot token is configured. Use this prefix for ALL gh commands:**
+\`\`\`bash
+GH_TOKEN=\${BOT_TOKEN} gh pr review ...
+GH_TOKEN=\${BOT_TOKEN} gh pr comment ...
+\`\`\`
+The BOT_TOKEN environment variable is already set in this terminal.
+
+You can use formal reviews (approve/request-changes):
 
 \`\`\`bash
-gh pr comment ${prNumber} --body "**File: path/to/file.ts**
+# Post suggestions as review comments
+GH_TOKEN=\${BOT_TOKEN} gh pr review ${prNumber} --comment --body "**File: path/to/file.ts**
 
 Description of the issue...
 
@@ -178,20 +191,57 @@ Description of the issue...
 // Your suggested fix here
 \\\`\\\`\\\`
 "
+
+# Final verdict
+GH_TOKEN=\${BOT_TOKEN} gh pr review ${prNumber} --approve --body "LGTM! Code looks good."
+# OR
+GH_TOKEN=\${BOT_TOKEN} gh pr review ${prNumber} --request-changes --body "Please address the issues above."
+\`\`\`
+` : `
+First, check if you can post formal reviews by running these commands:
+\`\`\`bash
+# Get PR author
+PR_AUTHOR=$(gh pr view ${prNumber} --json author --jq .author.login)
+# Get current user
+CURRENT_USER=$(gh api user --jq .login)
+echo "PR author: $PR_AUTHOR, Current user: $CURRENT_USER"
 \`\`\`
 
-The \`suggestion\` code block will create a "Commit suggestion" button on GitHub.
+### If PR author ≠ Current user (reviewing someone else's PR):
+You can use formal reviews with approve/request-changes:
 
-For a final review summary:
 \`\`\`bash
-gh pr comment ${prNumber} --body "## Review Summary
+# Post suggestions as review comments
+gh pr review ${prNumber} --comment --body "**File: path/to/file.ts**
 
-- Issue 1: ...
-- Issue 2: ...
+Description of the issue...
+
+\\\`\\\`\\\`suggestion
+// Your suggested fix here
+\\\`\\\`\\\`
 "
+
+# Final verdict
+gh pr review ${prNumber} --approve --body "LGTM! Code looks good."
+# OR
+gh pr review ${prNumber} --request-changes --body "Please address the issues above."
 \`\`\`
 
-Note: You cannot approve or request changes on your own PR. Just post suggestions as comments.
+### If PR author = Current user (reviewing your own PR):
+You can only post comments (GitHub doesn't allow self-review):
+
+\`\`\`bash
+gh pr comment ${prNumber} --body "**File: path/to/file.ts**
+
+Description of the issue...
+
+\\\`\\\`\\\`suggestion
+// Your suggested fix here
+\\\`\\\`\\\`
+"
+\`\`\`
+`}
+The \`suggestion\` code block creates a "Commit suggestion" button on GitHub.
 
 ## PR Diff
 ${diffContent ? `\n\`\`\`diff\n${diffContent.slice(0, 50000)}\n\`\`\`\n` : 'Run `gh pr diff ' + prNumber + '` to see the changes.'}
@@ -200,11 +250,19 @@ Start by examining the diff and the changed files, then provide your review.`;
     // Write prompt to a file
     const promptFile = path.join(worktreePath, '.claude-review-prompt.txt');
     fs.writeFileSync(promptFile, prompt);
+    // Bot token already fetched above
+    const botTokenEnv = botToken ? `export BOT_TOKEN="${botToken}"\nexport GH_TOKEN="${botToken}"` : '# No bot token configured';
+    const botNote = botToken
+        ? 'Using bot token for reviews (can approve/request changes)'
+        : 'No bot token - using your account (may have limitations on own PRs)';
     // Create runner script for review
     const runnerScript = path.join(worktreePath, '.claude-review-runner.sh');
     const runnerContent = `#!/bin/bash
 cd "${worktreePath}"
 
+# Set bot token if configured
+${botTokenEnv}
+
 # Set terminal title
 echo -ne "\\033]0;Review PR #${prNumber}: ${issue.title.replace(/"/g, '\\"').slice(0, 50)}\\007"
 
@@ -213,6 +271,8 @@ echo "━━━━━━━━━━━━━━━━━━━━━━━━
 echo ""
 echo "Issue #${issueNumber}: ${issue.title.replace(/"/g, '\\"')}"
 echo ""
+echo "${botNote}"
+echo ""
 echo "Claude will review the PR and post suggestions."
 echo "You can commit suggestions directly on GitHub."
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
@@ -388,6 +448,8 @@ async function launchReviewForPR(pr, projectRoot, projectName) {
             issueBody = issue.body;
         }
     }
+    // Check for bot token
+    const botToken = (0, config_1.getBotToken)();
     // Build the review prompt
     const prompt = `You are reviewing PR #${pr.number}: ${pr.title}
 ${pr.issueNumber ? `\n## Related Issue #${pr.issueNumber}\n${issueBody}\n` : ''}
@@ -401,10 +463,19 @@ Review the code changes in this PR. Look for:
 6. Performance problems
 
 ## How to Leave Feedback
-Use the gh CLI to post comments with suggestions. For each issue you find:
+${botToken ? `
+**IMPORTANT: A bot token is configured. Use this prefix for ALL gh commands:**
+\`\`\`bash
+GH_TOKEN=\${BOT_TOKEN} gh pr review ...
+GH_TOKEN=\${BOT_TOKEN} gh pr comment ...
+\`\`\`
+The BOT_TOKEN environment variable is already set in this terminal.
+
+You can use formal reviews (approve/request-changes):
 
 \`\`\`bash
-gh pr comment ${pr.number} --body "**File: path/to/file.ts**
+# Post suggestions as review comments
+GH_TOKEN=\${BOT_TOKEN} gh pr review ${pr.number} --comment --body "**File: path/to/file.ts**
 
 Description of the issue...
 
@@ -412,20 +483,57 @@ Description of the issue...
 // Your suggested fix here
 \\\`\\\`\\\`
 "
+
+# Final verdict
+GH_TOKEN=\${BOT_TOKEN} gh pr review ${pr.number} --approve --body "LGTM! Code looks good."
+# OR
+GH_TOKEN=\${BOT_TOKEN} gh pr review ${pr.number} --request-changes --body "Please address the issues above."
+\`\`\`
+` : `
+First, check if you can post formal reviews by running these commands:
+\`\`\`bash
+# Get PR author
+PR_AUTHOR=$(gh pr view ${pr.number} --json author --jq .author.login)
+# Get current user
+CURRENT_USER=$(gh api user --jq .login)
+echo "PR author: $PR_AUTHOR, Current user: $CURRENT_USER"
 \`\`\`
 
-The \`suggestion\` code block will create a "Commit suggestion" button on GitHub.
+### If PR author ≠ Current user (reviewing someone else's PR):
+You can use formal reviews with approve/request-changes:
 
-For a final review summary:
 \`\`\`bash
-gh pr comment ${pr.number} --body "## Review Summary
+# Post suggestions as review comments
+gh pr review ${pr.number} --comment --body "**File: path/to/file.ts**
 
-- Issue 1: ...
-- Issue 2: ...
+Description of the issue...
+
+\\\`\\\`\\\`suggestion
+// Your suggested fix here
+\\\`\\\`\\\`
 "
+
+# Final verdict
+gh pr review ${pr.number} --approve --body "LGTM! Code looks good."
+# OR
+gh pr review ${pr.number} --request-changes --body "Please address the issues above."
 \`\`\`
 
-Note: You cannot approve or request changes on your own PR. Just post suggestions as comments.
+### If PR author = Current user (reviewing your own PR):
+You can only post comments (GitHub doesn't allow self-review):
+
+\`\`\`bash
+gh pr comment ${pr.number} --body "**File: path/to/file.ts**
+
+Description of the issue...
+
+\\\`\\\`\\\`suggestion
+// Your suggested fix here
+\\\`\\\`\\\`
+"
+\`\`\`
+`}
+The \`suggestion\` code block creates a "Commit suggestion" button on GitHub.
 
 ## PR Diff
 ${diffContent ? `\n\`\`\`diff\n${diffContent.slice(0, 50000)}\n\`\`\`\n` : 'Run `gh pr diff ' + pr.number + '` to see the changes.'}
@@ -434,12 +542,19 @@ Start by examining the diff and the changed files, then provide your review.`;
     // Write prompt to a file
     const promptFile = path.join(worktreePath, '.claude-review-prompt.txt');
     fs.writeFileSync(promptFile, prompt);
+    const botTokenEnv = botToken ? `export BOT_TOKEN="${botToken}"\nexport GH_TOKEN="${botToken}"` : '# No bot token configured';
+    const botNote = botToken
+        ? 'Using bot token for reviews (can approve/request changes)'
+        : 'No bot token - using your account (may have limitations on own PRs)';
     // Create runner script for review
     const runnerScript = path.join(worktreePath, '.claude-review-runner.sh');
     const escapedTitle = pr.title.replace(/"/g, '\\"').slice(0, 50);
     const runnerContent = `#!/bin/bash
 cd "${worktreePath}"
 
+# Set bot token if configured
+${botTokenEnv}
+
 # Set terminal title
 echo -ne "\\033]0;Review PR #${pr.number}: ${escapedTitle}\\007"
 
@@ -448,6 +563,8 @@ echo "━━━━━━━━━━━━━━━━━━━━━━━━
 echo ""
 echo "${escapedTitle}"
 echo ""
+echo "${botNote}"
+echo ""
 echo "Claude will review the PR and post suggestions."
 echo "You can commit suggestions directly on GitHub."
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/dist/index.js

@@ -18,6 +18,7 @@ const new_1 = require("./commands/new");
 const init_1 = require("./commands/init");
 const show_1 = require("./commands/show");
 const review_1 = require("./commands/review");
+const config_1 = require("./commands/config");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const packageJson = require('../package.json');
 const program = new commander_1.Command();
@@ -168,4 +169,11 @@ program
         await (0, review_1.selectReviewCommand)();
     }
 });
+// Config command - manage settings
+program
+    .command('config [action] [value]')
+    .description('Manage configuration (bot-token, --clear)')
+    .action(async (action, value) => {
+    await (0, config_1.configCommand)(action, value);
+});
 program.parse();

package/package.json

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