claude-issue-solver 1.9.0 → 1.10.1

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,11 +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
 
@@ -87,31 +90,60 @@ 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
+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 |
+
+### 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
 
@@ -142,24 +174,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/new.d.ts

@@ -0,0 +1,4 @@
+export declare function newCommand(title: string, options: {
+    body?: string;
+    label?: string[];
+}): Promise<void>;

package/dist/commands/new.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.newCommand = newCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const github_1 = require("../utils/github");
+const solve_1 = require("./solve");
+async function newCommand(title, options) {
+    const spinner = (0, ora_1.default)('Creating issue...').start();
+    const issueNumber = (0, github_1.createIssue)(title, options.body, options.label);
+    if (!issueNumber) {
+        spinner.fail('Failed to create issue');
+        console.log(chalk_1.default.dim('Make sure you have write access to this repository.'));
+        process.exit(1);
+    }
+    spinner.succeed(`Created issue #${issueNumber}`);
+    console.log(chalk_1.default.dim(`Title: ${title}\n`));
+    // Now solve it immediately
+    await (0, solve_1.solveCommand)(issueNumber);
+}

package/dist/index.js

@@ -14,6 +14,7 @@ const pr_1 = require("./commands/pr");
 const clean_1 = require("./commands/clean");
 const select_1 = require("./commands/select");
 const go_1 = require("./commands/go");
+const new_1 = require("./commands/new");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const packageJson = require('../package.json');
 const program = new commander_1.Command();
@@ -110,4 +111,13 @@ program
     }
     await (0, go_1.goCommand)(issueNumber);
 });
+// New command - create issue and solve it
+program
+    .command('new <title>')
+    .description('Create a new issue and immediately start solving it')
+    .option('-b, --body <body>', 'Issue description')
+    .option('-l, --label <label...>', 'Add labels to the issue')
+    .action(async (title, options) => {
+    await (0, new_1.newCommand)(title, options);
+});
 program.parse();

package/dist/utils/github.d.ts

@@ -8,6 +8,7 @@ export interface IssueListItem {
     number: number;
     title: string;
 }
+export declare function createIssue(title: string, body?: string, labels?: string[]): number | null;
 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

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.createIssue = createIssue;
 exports.getIssue = getIssue;
 exports.listIssues = listIssues;
 exports.createPullRequest = createPullRequest;
@@ -7,6 +8,29 @@ exports.getIssueStatus = getIssueStatus;
 exports.getPRForBranch = getPRForBranch;
 exports.getIssuesWithOpenPRs = getIssuesWithOpenPRs;
 const child_process_1 = require("child_process");
+function createIssue(title, body, labels) {
+    try {
+        let cmd = `gh issue create --title "${title.replace(/"/g, '\\"')}"`;
+        if (body) {
+            cmd += ` --body "${body.replace(/"/g, '\\"')}"`;
+        }
+        if (labels && labels.length > 0) {
+            for (const label of labels) {
+                cmd += ` --label "${label.replace(/"/g, '\\"')}"`;
+            }
+        }
+        const output = (0, child_process_1.execSync)(cmd, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+        // Output is the issue URL, extract the number
+        const match = output.trim().match(/\/issues\/(\d+)$/);
+        if (match) {
+            return parseInt(match[1], 10);
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
 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'] });

package/package.json

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