@link-assistant/hive-mind 0.51.20 → 0.52.0

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # @link-assistant/hive-mind
 
+## 0.52.0
+
+### Minor Changes
+
+- b280bcc: Add `--prompt-playwright-mcp` flag to control Playwright MCP hints in system prompt
+
+  Users can now explicitly control whether Playwright MCP browser automation hints appear in the AI's system prompt:
+  - Use `--no-prompt-playwright-mcp` to disable hints even when Playwright MCP is installed
+  - Use `--prompt-playwright-mcp` to explicitly enable hints
+  - Omit the flag to keep the default auto-detection behavior
+
+## 0.51.21
+
+### Patch Changes
+
+- Increase swap space from 2GB to 4GB in installation script for improved stability
+
+  Fix: Show Claude CLI resume command using `(cd ... && claude --resume ...)` pattern
+
+  When using `--tool claude` (or the default tool), the console now displays a copyable Claude CLI resume command at the end of every session (success, failure, or usage limit reached):
+
+  ```
+  💡 To continue this session in Claude Code interactive mode:
+
+     (cd "/tmp/gh-issue-solver-..." && claude --resume <session-id>)
+  ```
+
+  Changes in this PR:
+  - Refactored `claude.command-builder.lib.mjs` to build Claude CLI commands instead of solve.mjs commands
+  - Added `buildClaudeResumeCommand()` for generating `(cd ... && claude --resume ...)` pattern
+  - Added `buildClaudeInitialCommand()` for generating `(cd ... && claude ...)` pattern
+  - Removed solve.mjs resume command display from console output
+  - Updated PR comments to use Claude CLI resume command pattern
+
+  This allows users to:
+  - Investigate sessions interactively in Claude Code
+  - Resume from where they left off after usage limits reset
+  - See full context and history
+  - Debug issues
+
+  The command uses the `(cd ... && claude --resume ...)` pattern for a fully copyable, executable command that works regardless of the current directory.
+
+  Note: The resume command is only shown for `--tool claude` since other tools (codex, opencode, agent) have different resume mechanisms.
+
+  Fixes #942
+
 ## 0.51.20
 
 ### Patch Changes

package/README.md

@@ -59,7 +59,7 @@ Minimum system requirements to run `hive.mjs`:
 ```
 1 CPU Core
 1 GB RAM
-> 2 GB SWAP
+> 4 GB SWAP
 50 GB disk space
 ```
 
@@ -301,100 +301,54 @@ review --repo owner/repo --pr 456
 
 ```bash
 solve <issue-url> [options]
-
-  --model, -m           Model (sonnet, opus for claude; grok-code-fast-1, gpt4o for opencode; gpt5, gpt5-codex, o3 for codex; grok, sonnet, haiku for agent)
-                        [default: sonnet for claude, grok-code-fast-1 for opencode, gpt-5 for codex, grok-code-fast-1 for agent]
-  --tool                AI tool (claude, opencode, codex, agent)    [default: claude]
-  --fork, -f            Fork repo if no write access         [default: false]
-  --auto-fork           Automatically fork public repos without write access (fails for private)
-                        [default: true]
-  --base-branch, -b     Target branch for PR                 [default: repo default]
-  --resume, -r          Resume from session ID
-  --verbose, -v         Enable verbose logging               [default: false]
-  --dry-run, -n         Prepare only, don't execute          [default: false]
-  --only-prepare-command  Only prepare and print the command [default: false]
-  --skip-tool-check     Skip tool connection check (use --no-tool-check to disable)
-                        [default: false]
-  --auto-pull-request-creation  Create draft PR before execution [default: true]
-  --attach-logs         Attach logs to PR (⚠️ sensitive)    [default: false]
-  --auto-close-pull-request-on-fail  Close PR on fail        [default: false]
-  --auto-continue       Continue with existing PR when issue URL is provided
-                        [default: true]
-  --auto-continue-limit, -c  Auto-continue when limit resets [default: false]
-  --auto-resume-on-errors  Auto-resume on network errors (503, etc.)
-                        [default: false]
-  --auto-continue-only-on-new-comments  Fail if no new comments
-                        [default: false]
-  --auto-commit-uncommitted-changes  Auto-commit changes    [default: false]
-  --auto-merge-default-branch-to-pull-request-branch  Merge default branch to PR branch
-                        (only in continue mode) [default: false]
-  --allow-fork-divergence-resolution-using-force-push-with-lease
-                        Allow force-push with --force-with-lease when fork diverges
-                        (DANGEROUS: can overwrite fork history) [default: false]
-  --prefix-fork-name-with-owner-name  Prefix fork name with owner (owner-repo)
-                        Useful for forking repos with same name from different owners
-                        [default: true]
-  --continue-only-on-feedback  Only continue if feedback detected
-                        [default: false]
-  --watch, -w           Monitor for feedback and auto-restart [default: false]
-  --watch-interval      Feedback check interval (seconds)    [default: 60]
-  --min-disk-space      Minimum disk space in MB             [default: 500]
-  --log-dir, -l         Directory for log files              [default: cwd]
-  --think               Thinking level (low, medium, high, max)  [optional]
-  --sentry              Enable Sentry error tracking (use --no-sentry to disable)
-                        [default: true]
-  --auto-cleanup        Delete temp directory on completion
-                        [default: true for private repos, false for public repos]
-  --version             Show version number
-  --help, -h            Show help
 ```
 
+**Most frequently used options:**
+
+| Option    | Alias | Description                             | Default |
+| --------- | ----- | --------------------------------------- | ------- |
+| `--model` | `-m`  | AI model to use (sonnet, opus, haiku)   | sonnet  |
+| `--think` |       | Thinking level (low, medium, high, max) | -       |
+
+**Other useful options:**
+
+| Option          | Alias | Description                                      | Default |
+| --------------- | ----- | ------------------------------------------------ | ------- |
+| `--tool`        |       | AI tool (claude, opencode, codex, agent)         | claude  |
+| `--verbose`     | `-v`  | Enable verbose logging                           | false   |
+| `--attach-logs` |       | Attach logs to PR (⚠️ may expose sensitive data) | false   |
+| `--help`        | `-h`  | Show all available options                       | -       |
+
+> **📖 Full options list**: See [docs/CONFIGURATION.md](./docs/CONFIGURATION.md#solve-options) for all available options including forking, auto-continue, watch mode, and experimental features.
+
 ## 🔧 hive Options
 
 ```bash
 hive <github-url> [options]
-
-  --monitor-tag, -t     Label to monitor                     [default: "help wanted"]
-  --all-issues, -a      Monitor all issues (ignore labels)   [default: false]
-  --skip-issues-with-prs, -s  Skip issues with existing PRs [default: false]
-  --concurrency, -c     Parallel workers                     [default: 2]
-  --pull-requests-per-issue, -p  Number of PRs per issue    [default: 1]
-  --model, -m           Model (opus, sonnet for claude; grok-code-fast-1, gpt4o for opencode; gpt5, gpt5-codex, o3 for codex; grok, sonnet, haiku for agent)
-                        [default: sonnet for claude, grok-code-fast-1 for opencode, gpt-5 for codex, grok-code-fast-1 for agent]
-  --tool                AI tool (claude, opencode, codex, agent)    [default: claude]
-  --interval, -i        Poll interval (seconds)              [default: 300]
-  --max-issues          Limit processed issues               [default: 0 (unlimited)]
-  --once                Single run (don't monitor)           [default: false]
-  --dry-run             List issues without processing       [default: false]
-  --skip-tool-check     Skip tool connection check (use --no-tool-check to disable)
-                        [default: false]
-  --verbose, -v         Enable verbose logging               [default: false]
-  --min-disk-space      Minimum disk space in MB             [default: 500]
-  --auto-cleanup        Clean /tmp/* /var/tmp/* on success   [default: false]
-  --fork, -f            Fork repos if no write access        [default: false]
-  --auto-fork           Automatically fork public repos without write access
-                        [default: true]
-  --attach-logs         Attach logs to PRs (⚠️ sensitive)   [default: false]
-  --project-number, -pn  GitHub Project number to monitor
-  --project-owner, -po  GitHub Project owner (org or user)
-  --project-status, -ps  Project status column to monitor    [default: "Ready"]
-  --project-mode, -pm   Enable project-based monitoring      [default: false]
-  --youtrack-mode       Enable YouTrack mode instead of GitHub  [default: false]
-  --youtrack-stage      Override YouTrack stage to monitor
-  --youtrack-project    Override YouTrack project code
-  --target-branch, -tb  Target branch for pull requests      [default: repo default]
-  --log-dir, -l         Directory for log files              [default: cwd]
-  --auto-continue       Pass --auto-continue to solve for each issue
-                        [default: true]
-  --think               Thinking level (low, medium, high, max)  [optional]
-  --sentry              Enable Sentry error tracking (use --no-sentry to disable)
-                        [default: true]
-  --watch, -w           Monitor for feedback and auto-restart  [default: false]
-  --issue-order, -o     Order issues by date (asc, desc)     [default: asc]
-  --version             Show version number
-  --help, -h            Show help
 ```
 
+**Most frequently used options:**
+
+| Option         | Alias | Description                             | Default |
+| -------------- | ----- | --------------------------------------- | ------- |
+| `--model`      | `-m`  | AI model to use (sonnet, opus, haiku)   | sonnet  |
+| `--think`      |       | Thinking level (low, medium, high, max) | -       |
+| `--all-issues` | `-a`  | Monitor all issues (ignore labels)      | false   |
+| `--once`       |       | Single run (don't monitor continuously) | false   |
+
+**Other useful options:**
+
+| Option                   | Alias | Description                                       | Default |
+| ------------------------ | ----- | ------------------------------------------------- | ------- |
+| `--tool`                 |       | AI tool (claude, opencode, agent)                 | claude  |
+| `--concurrency`          | `-c`  | Number of parallel workers                        | 2       |
+| `--skip-issues-with-prs` | `-s`  | Skip issues with existing PRs                     | false   |
+| `--verbose`              | `-v`  | Enable verbose logging                            | false   |
+| `--attach-logs`          |       | Attach logs to PRs (⚠️ may expose sensitive data) | false   |
+| `--help`                 | `-h`  | Show all available options                        | -       |
+
+> **📖 Full options list**: See [docs/CONFIGURATION.md](./docs/CONFIGURATION.md#hive-options) for all available options including project monitoring, YouTrack integration, and experimental features.
+
 ## 🤖 Telegram Bot
 
 The Hive Mind includes a Telegram bot interface (SwarmMindBot) for remote command execution.
@@ -641,12 +595,14 @@ grep -E '\(cd /tmp/gh-issue-solver-[0-9]+ && claude --resume [0-9a-f-]{36}\)' hi
 
 ## 🔧 Configuration
 
-Authentication is handled through:
+**Authentication:**
 
 - `gh auth login` - GitHub CLI authentication
 - `claude-profiles` - Claude authentication profile migration to server
 
-No environment variable configuration is currently supported.
+**Environment Variables & Advanced Options:**
+
+For comprehensive configuration including environment variables, timeouts, retry limits, Telegram bot settings, YouTrack integration, and all CLI options, see [docs/CONFIGURATION.md](./docs/CONFIGURATION.md).
 
 ## 🐛 Reporting Issues
 
@@ -795,6 +751,18 @@ That can be done, but not recommended as reboot have better effect.
 
 Unlicense License - see [LICENSE](./LICENSE)
 
+## 🏆 Best Practices
+
+Hive Mind works even better when repositories have strong CI/CD pipelines. See [BEST-PRACTICES.md](./docs/BEST-PRACTICES.md) for recommended configurations that maximize AI solver quality.
+
+Key benefits of proper CI/CD:
+
+- AI solvers iterate until all checks pass
+- Consistent quality regardless of human/AI team composition
+- File size limits ensure code is readable by both AI and humans
+
+Ready-to-use templates are available for JavaScript, Rust, Python, Go, C#, and Java.
+
 ## 🤖 Contributing
 
 This project uses AI-driven development. See [CONTRIBUTING.md](./docs/CONTRIBUTING.md) for human-AI collaboration guidelines.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/hive-mind",
-  "version": "0.51.20",
+  "version": "0.52.0",
   "description": "AI-powered issue solver and hive mind for collaborative problem solving",
   "main": "src/hive.mjs",
   "type": "module",

package/src/claude.command-builder.lib.mjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+
+/**
+ * Claude CLI Command Builder Library
+ *
+ * This module provides utilities for building Claude-specific CLI commands.
+ * These builders are specifically designed for the Claude Code CLI tool (--tool claude)
+ * and help generate consistent, copy-pasteable commands using the pattern:
+ *
+ *   (cd "/path/to/workdir" && claude --resume <session-id>)
+ *
+ * This is the same pattern used by --auto-continue-on-limit-reset and allows users to:
+ * 1. Resume sessions directly using Claude CLI (not through solve.mjs)
+ * 2. Investigate issues interactively in the working directory
+ * 3. Continue work after usage limits reset
+ *
+ * Functions:
+ * - buildClaudeResumeCommand: Generate `(cd ... && claude --resume ...)` command
+ * - buildClaudeInitialCommand: Generate `(cd ... && claude ...)` command for new sessions
+ *
+ * Related issue: https://github.com/link-assistant/hive-mind/issues/942
+ */
+
+/**
+ * Build the Claude CLI resume command with the (cd ... && claude --resume ...) pattern
+ *
+ * This generates a copy-pasteable command that users can execute directly
+ * to resume a Claude session in interactive mode. This is the same pattern
+ * used by --auto-continue-on-limit-reset.
+ *
+ * The command includes all necessary flags to match how the original session was run:
+ * - --resume <sessionId>: Resume from the specified session
+ * - --model <model>: Use the same model as the original session (optional)
+ *
+ * Note: This function is specifically designed for Claude CLI (--tool claude)
+ * and should only be used when the tool is 'claude' or undefined (defaults to claude).
+ *
+ * @param {Object} options - Options for building the command
+ * @param {string} options.tempDir - The working directory (e.g., /tmp/gh-issue-solver-...)
+ * @param {string} options.sessionId - The session ID to resume
+ * @param {string} options.claudePath - Path to the claude CLI binary (defaults to 'claude')
+ * @param {string} [options.model] - The model to use (e.g., 'sonnet', 'opus', 'claude-sonnet-4-20250514')
+ * @returns {string} - The full resume command with (cd ... && claude --resume ...) pattern
+ */
+export const buildClaudeResumeCommand = ({ tempDir, sessionId, claudePath = 'claude', model }) => {
+  let args = `--resume ${sessionId}`;
+
+  if (model) {
+    args += ` --model ${model}`;
+  }
+
+  return `(cd "${tempDir}" && ${claudePath} ${args})`;
+};
+
+/**
+ * Build the Claude CLI initial command with the (cd ... && claude ...) pattern
+ *
+ * This generates the command pattern used when starting a new Claude session.
+ * Useful for documentation and debugging purposes.
+ *
+ * Note: This function is specifically designed for Claude CLI (--tool claude)
+ * and should only be used when the tool is 'claude' or undefined (defaults to claude).
+ *
+ * @param {Object} options - Options for building the command
+ * @param {string} options.tempDir - The working directory (e.g., /tmp/gh-issue-solver-...)
+ * @param {string} options.claudePath - Path to the claude CLI binary (defaults to 'claude')
+ * @param {string} [options.model] - The model to use
+ * @param {boolean} [options.verbose] - Whether to include --verbose flag
+ * @returns {string} - The command pattern (cd ... && claude ...)
+ */
+export const buildClaudeInitialCommand = ({ tempDir, claudePath = 'claude', model, verbose = false }) => {
+  let args = '--output-format stream-json --dangerously-skip-permissions';
+
+  if (verbose) {
+    args += ' --verbose';
+  }
+
+  if (model) {
+    args += ` --model ${model}`;
+  }
+
+  return `(cd "${tempDir}" && ${claudePath} ${args})`;
+};
+
+// Export default object for compatibility
+export default {
+  buildClaudeResumeCommand,
+  buildClaudeInitialCommand,
+};

package/src/claude.lib.mjs

@@ -14,6 +14,17 @@ import { timeouts, retryLimits } from './config.lib.mjs';
 import { detectUsageLimit, formatUsageLimitMessage } from './usage-limit.lib.mjs';
 import { createInteractiveHandler } from './interactive-mode.lib.mjs';
 import { displayBudgetStats } from './claude.budget-stats.lib.mjs';
+// Import Claude command builder for generating resume commands
+import { buildClaudeResumeCommand } from './claude.command-builder.lib.mjs';
+
+// Helper to display resume command at end of session
+const showResumeCommand = async (sessionId, tempDir, claudePath, model, log) => {
+  if (!sessionId || !tempDir) return;
+  const cmd = buildClaudeResumeCommand({ tempDir, sessionId, claudePath, model });
+  await log('\n💡 To continue this session in Claude Code interactive mode:\n');
+  await log(`   ${cmd}\n`);
+};
+
 /**
  * Format numbers with spaces as thousands separator (no commas)
  * Per issue #667: Use spaces for thousands, . for decimals
@@ -1250,6 +1261,7 @@ export const executeClaudeCommand = async params => {
         await log(`   Load: ${resourcesAfter.load}`, { verbose: true });
         // Log attachment will be handled by solve.mjs when it receives success=false
         await log('', { verbose: true });
+        await showResumeCommand(sessionId, tempDir, claudePath, argv.model, log);
         return {
           success: false,
           sessionId,
@@ -1349,6 +1361,7 @@ export const executeClaudeCommand = async params => {
           await log(`   ⚠️ Could not calculate token usage: ${tokenError.message}`, { verbose: true });
         }
       }
+      await showResumeCommand(sessionId, tempDir, claudePath, argv.model, log);
       return {
         success: true,
         sessionId,

package/src/hive.config.lib.mjs

@@ -266,6 +266,11 @@ export const createYargsConfig = yargsInstance => {
       description: 'Create comprehensive case study documentation for the issue including logs, analysis, timeline, root cause investigation, and proposed solutions. Organizes findings into ./docs/case-studies/issue-{id}/ directory. Only supported for --tool claude.',
       default: false,
     })
+    .option('prompt-playwright-mcp', {
+      type: 'boolean',
+      description: 'Enable Playwright MCP browser automation hints in system prompt (enabled by default, only takes effect if Playwright MCP is installed). Use --no-prompt-playwright-mcp to disable. Only supported for --tool claude.',
+      default: true,
+    })
     .parserConfiguration({
       'boolean-negation': true,
       'strip-dashed': false,

package/src/hive.mjs

@@ -750,6 +750,7 @@ if (isDirectExecution) {
             const promptExploreSubAgentFlag = argv.promptExploreSubAgent ? ' --prompt-explore-sub-agent' : '';
             const promptIssueReportingFlag = argv.promptIssueReporting ? ' --prompt-issue-reporting' : '';
             const promptCaseStudiesFlag = argv.promptCaseStudies ? ' --prompt-case-studies' : '';
+            const promptPlaywrightMcpFlag = argv.promptPlaywrightMcp === true ? ' --prompt-playwright-mcp' : argv.promptPlaywrightMcp === false ? ' --no-prompt-playwright-mcp' : '';
             // Use spawn to get real-time streaming output while avoiding command-stream's automatic quote addition
             const { spawn } = await import('child_process');
 
@@ -800,9 +801,9 @@ if (isDirectExecution) {
             if (argv.promptExploreSubAgent) args.push('--prompt-explore-sub-agent');
             if (argv.promptIssueReporting) args.push('--prompt-issue-reporting');
             if (argv.promptCaseStudies) args.push('--prompt-case-studies');
-
+            if (argv.promptPlaywrightMcp !== undefined) args.push(argv.promptPlaywrightMcp ? '--prompt-playwright-mcp' : '--no-prompt-playwright-mcp');
             // Log the actual command being executed so users can investigate/reproduce
-            const command = `${solveCommand} "${issueUrl}" --model ${argv.model}${toolFlag}${forkFlag}${autoForkFlag}${verboseFlag}${attachLogsFlag}${targetBranchFlag}${logDirFlag}${dryRunFlag}${skipToolConnectionCheckFlag}${autoContinueFlag}${thinkFlag}${promptPlanSubAgentFlag}${noSentryFlag}${watchFlag}${prefixForkNameWithOwnerNameFlag}${interactiveModeFlag}${promptExploreSubAgentFlag}${promptIssueReportingFlag}${promptCaseStudiesFlag}`;
+            const command = `${solveCommand} "${issueUrl}" --model ${argv.model}${toolFlag}${forkFlag}${autoForkFlag}${verboseFlag}${attachLogsFlag}${targetBranchFlag}${logDirFlag}${dryRunFlag}${skipToolConnectionCheckFlag}${autoContinueFlag}${thinkFlag}${promptPlanSubAgentFlag}${noSentryFlag}${watchFlag}${prefixForkNameWithOwnerNameFlag}${interactiveModeFlag}${promptExploreSubAgentFlag}${promptIssueReportingFlag}${promptCaseStudiesFlag}${promptPlaywrightMcpFlag}`;
             await log(`   📋 Command: ${command}`);
 
             let exitCode = 0;

package/src/solve.config.lib.mjs

@@ -281,6 +281,11 @@ export const createYargsConfig = yargsInstance => {
         description: 'Create comprehensive case study documentation for the issue including logs, analysis, timeline, root cause investigation, and proposed solutions. Organizes findings into ./docs/case-studies/issue-{id}/ directory. Only supported for --tool claude.',
         default: false,
       })
+      .option('prompt-playwright-mcp', {
+        type: 'boolean',
+        description: 'Enable Playwright MCP browser automation hints in system prompt (enabled by default, only takes effect if Playwright MCP is installed). Use --no-prompt-playwright-mcp to disable. Only supported for --tool claude.',
+        default: true,
+      })
       .parserConfiguration({
         'boolean-negation': true,
       })

package/src/solve.mjs

@@ -58,7 +58,7 @@ const { processAutoContinueForIssue } = autoContinue;
 const repository = await import('./solve.repository.lib.mjs');
 const { setupTempDirectory, cleanupTempDirectory } = repository;
 const results = await import('./solve.results.lib.mjs');
-const { cleanupClaudeFile, showSessionSummary, verifyResults } = results;
+const { cleanupClaudeFile, showSessionSummary, verifyResults, buildClaudeResumeCommand } = results;
 const claudeLib = await import('./claude.lib.mjs');
 const { executeClaude } = claudeLib;
 
@@ -828,14 +828,18 @@ try {
     // Default to Claude
     // Check for Playwright MCP availability if using Claude tool
     if (argv.tool === 'claude' || !argv.tool) {
-      const { checkPlaywrightMcpAvailability } = claudeLib;
-      const playwrightMcpAvailable = await checkPlaywrightMcpAvailability();
-      if (playwrightMcpAvailable) {
-        await log('🎭 Playwright MCP detected - enabling browser automation hints', { verbose: true });
-        argv.promptPlaywrightMcp = true;
+      // If flag is true (default), check if Playwright MCP is actually available
+      if (argv.promptPlaywrightMcp) {
+        const { checkPlaywrightMcpAvailability } = claudeLib;
+        const playwrightMcpAvailable = await checkPlaywrightMcpAvailability();
+        if (playwrightMcpAvailable) {
+          await log('🎭 Playwright MCP detected - enabling browser automation hints', { verbose: true });
+        } else {
+          await log('ℹ️  Playwright MCP not detected - browser automation hints will be disabled', { verbose: true });
+          argv.promptPlaywrightMcp = false;
+        }
       } else {
-        await log('ℹ️  Playwright MCP not detected - browser automation hints will be disabled', { verbose: true });
-        argv.promptPlaywrightMcp = false;
+        await log('ℹ️  Playwright MCP explicitly disabled via --no-prompt-playwright-mcp', { verbose: true });
       }
     }
     const claudeResult = await executeClaude({
@@ -886,12 +890,35 @@ try {
       await log('\n❌ USAGE LIMIT REACHED!');
       await log('   The AI tool has reached its usage limit.');
 
+      // Always show manual resume command in console so users can resume after limit resets
+      if (sessionId) {
+        const resetTime = global.limitResetTime;
+        await log('');
+        await log(`📁 Working directory: ${tempDir}`);
+        await log(`📌 Session ID: ${sessionId}`);
+        if (resetTime) {
+          await log(`⏰ Limit resets at: ${resetTime}`);
+        }
+        await log('');
+        // Show claude resume command only for --tool claude (or default)
+        // Uses the (cd ... && claude --resume ...) pattern for a fully copyable, executable command
+        const toolForResume = argv.tool || 'claude';
+        if (toolForResume === 'claude') {
+          const claudeResumeCmd = buildClaudeResumeCommand({ tempDir, sessionId, model: argv.model });
+          await log('💡 To continue this session in Claude Code interactive mode:');
+          await log('');
+          await log(`   ${claudeResumeCmd}`);
+          await log('');
+        }
+      }
+
       // If --attach-logs is enabled and we have a PR, attach logs with usage limit details
       if (shouldAttachLogs && sessionId && prNumber) {
         await log('\n📄 Attaching logs to Pull Request...');
         try {
-          // Build resume command
-          const resumeCommand = `${process.argv[0]} ${process.argv[1]} ${issueUrl} --resume ${sessionId}`;
+          // Build Claude CLI resume command
+          const tool = argv.tool || 'claude';
+          const resumeCommand = tool === 'claude' ? buildClaudeResumeCommand({ tempDir, sessionId, model: argv.model }) : null;
           const logUploadSuccess = await attachLogToGitHub({
             logFile: getLogFile(),
             targetType: 'pr',
@@ -921,7 +948,11 @@ try {
         // Fallback: Post simple failure comment if logs are not attached
         try {
           const resetTime = global.limitResetTime;
-          const failureComment = resetTime ? `❌ **Usage Limit Reached**\n\nThe AI tool has reached its usage limit. The limit will reset at: **${resetTime}**\n\nThis session has failed because \`--auto-continue-on-limit-reset\` was not enabled.\n\nTo automatically wait for the limit to reset and continue, use:\n\`\`\`bash\n./solve.mjs "${issueUrl}" --resume ${sessionId} --auto-continue-on-limit-reset\n\`\`\`` : `❌ **Usage Limit Reached**\n\nThe AI tool has reached its usage limit. Please wait for the limit to reset.\n\nThis session has failed because \`--auto-continue-on-limit-reset\` was not enabled.\n\nTo resume after the limit resets, use:\n\`\`\`bash\n./solve.mjs "${issueUrl}" --resume ${sessionId}\n\`\`\``;
+          // Build Claude CLI resume command
+          const tool = argv.tool || 'claude';
+          const resumeCmd = tool === 'claude' ? buildClaudeResumeCommand({ tempDir, sessionId, model: argv.model }) : null;
+          const resumeSection = resumeCmd ? `To resume after the limit resets, use:\n\`\`\`bash\n${resumeCmd}\n\`\`\`` : `Session ID: \`${sessionId}\``;
+          const failureComment = resetTime ? `❌ **Usage Limit Reached**\n\nThe AI tool has reached its usage limit. The limit will reset at: **${resetTime}**\n\n${resumeSection}` : `❌ **Usage Limit Reached**\n\nThe AI tool has reached its usage limit. Please wait for the limit to reset.\n\n${resumeSection}`;
 
           const commentResult = await $`gh pr comment ${prNumber} --repo ${owner}/${repo} --body ${failureComment}`;
           if (commentResult.code === 0) {
@@ -940,8 +971,9 @@ try {
         if (shouldAttachLogs && sessionId) {
           await log('\n📄 Attaching logs to Pull Request (auto-continue mode)...');
           try {
-            // Build resume command
-            const resumeCommand = `${process.argv[0]} ${process.argv[1]} ${issueUrl} --resume ${sessionId}`;
+            // Build Claude CLI resume command
+            const tool = argv.tool || 'claude';
+            const resumeCommand = tool === 'claude' ? buildClaudeResumeCommand({ tempDir, sessionId, model: argv.model }) : null;
             const logUploadSuccess = await attachLogToGitHub({
               logFile: getLogFile(),
               targetType: 'pr',
@@ -986,7 +1018,10 @@ try {
               return `${days}:${String(h).padStart(2, '0')}:${String(m).padStart(2, '0')}:${String(s).padStart(2, '0')}`;
             };
 
-            const waitingComment = `⏳ **Usage Limit Reached - Waiting to Continue**\n\nThe AI tool has reached its usage limit. Auto-continue is enabled with \`--auto-continue-on-limit-reset\`.\n\n**Reset time:** ${global.limitResetTime}\n**Wait time:** ${formatWaitTime(waitMs)} (days:hours:minutes:seconds)\n\nThe session will automatically resume when the limit resets.\n\nSession ID: \`${sessionId}\``;
+            // Build Claude CLI resume command
+            const tool = argv.tool || 'claude';
+            const resumeCmd = tool === 'claude' ? buildClaudeResumeCommand({ tempDir, sessionId, model: argv.model }) : null;
+            const waitingComment = `⏳ **Usage Limit Reached - Waiting to Continue**\n\nThe AI tool has reached its usage limit. Auto-continue is enabled with \`--auto-continue-on-limit-reset\`.\n\n**Reset time:** ${global.limitResetTime}\n**Wait time:** ${formatWaitTime(waitMs)} (days:hours:minutes:seconds)\n\nThe session will automatically resume when the limit resets.\n\nSession ID: \`${sessionId}\`${resumeCmd ? `\n\nTo resume manually:\n\`\`\`bash\n${resumeCmd}\n\`\`\`` : ''}`;
 
             const commentResult = await $`gh pr comment ${prNumber} --repo ${owner}/${repo} --body ${waitingComment}`;
             if (commentResult.code === 0) {
@@ -1001,12 +1036,25 @@ try {
   }
 
   if (!success) {
+    // Show claude resume command only for --tool claude (or default) on failure
+    // Uses the (cd ... && claude --resume ...) pattern for a fully copyable, executable command
+    const toolForFailure = argv.tool || 'claude';
+    if (sessionId && toolForFailure === 'claude') {
+      const claudeResumeCmd = buildClaudeResumeCommand({ tempDir, sessionId, model: argv.model });
+      await log('');
+      await log('💡 To continue this session in Claude Code interactive mode:');
+      await log('');
+      await log(`   ${claudeResumeCmd}`);
+      await log('');
+    }
+
     // If --attach-logs is enabled and we have a PR, attach failure logs before exiting
     if (shouldAttachLogs && sessionId && global.createdPR && global.createdPR.number) {
       await log('\n📄 Attaching failure logs to Pull Request...');
       try {
-        // Build resume command if we have session info
-        const resumeCommand = sessionId ? `${process.argv[0]} ${process.argv[1]} ${issueUrl} --resume ${sessionId}` : null;
+        // Build Claude CLI resume command
+        const tool = argv.tool || 'claude';
+        const resumeCommand = sessionId && tool === 'claude' ? buildClaudeResumeCommand({ tempDir, sessionId, model: argv.model }) : null;
         const logUploadSuccess = await attachLogToGitHub({
           logFile: getLogFile(),
           targetType: 'pr',

package/src/solve.results.lib.mjs

@@ -31,6 +31,12 @@ const { sanitizeLogContent, attachLogToGitHub } = githubLib;
 const autoContinue = await import('./solve.auto-continue.lib.mjs');
 const { autoContinueWhenLimitResets } = autoContinue;
 
+// Import Claude-specific command builders
+// These are used to generate copy-pasteable Claude CLI resume commands for users
+// Pattern: (cd "/tmp/gh-issue-solver-..." && claude --resume <session-id>)
+const claudeCommandBuilder = await import('./claude.command-builder.lib.mjs');
+export const { buildClaudeResumeCommand, buildClaudeInitialCommand } = claudeCommandBuilder;
+
 // Import error handling functions
 // const errorHandlers = await import('./solve.error-handlers.lib.mjs'); // Not currently used
 // Import Sentry integration
@@ -352,37 +358,44 @@ export const showSessionSummary = async (sessionId, limitReached, argv, issueUrl
     const absoluteLogPath = path.resolve(getLogFile());
     await log(`✅ Complete log file: ${absoluteLogPath}`);
 
+    // Show claude resume command only for --tool claude (or default)
+    // This allows users to investigate, resume, see context, and more
+    // Uses the (cd ... && claude --resume ...) pattern for a fully copyable, executable command
+    const tool = argv.tool || 'claude';
+    if (tool === 'claude') {
+      // Build the Claude CLI resume command using the command builder
+      const claudeResumeCmd = buildClaudeResumeCommand({ tempDir, sessionId, model: argv.model });
+
+      await log('');
+      await log('💡 To continue this session in Claude Code interactive mode:');
+      await log('');
+      await log(`   ${claudeResumeCmd}`);
+      await log('');
+    }
+
     if (limitReached) {
-      await log('\n⏰ LIMIT REACHED DETECTED!');
+      await log('⏰ LIMIT REACHED DETECTED!');
 
       if (argv.autoContinueOnLimitReset && global.limitResetTime) {
         await log(`\n🔄 AUTO-CONTINUE ON LIMIT RESET ENABLED - Will resume at ${global.limitResetTime}`);
         await autoContinueWhenLimitResets(issueUrl, sessionId, argv, shouldAttachLogs);
       } else {
-        // Only show resume recommendation if --no-auto-cleanup was passed
-        if (argv.autoCleanup === false) {
-          await log('\n🔄 To resume when limit resets, use:\n');
-          await log(`./solve.mjs "${issueUrl}" --resume ${sessionId}`);
-
-          if (global.limitResetTime) {
-            await log(`\n💡 Or enable auto-continue-on-limit-reset to wait until ${global.limitResetTime}:\n`);
-            await log(`./solve.mjs "${issueUrl}" --resume ${sessionId} --auto-continue-on-limit-reset`);
-          }
+        if (global.limitResetTime) {
+          await log(`\n⏰ Limit resets at: ${global.limitResetTime}`);
+        }
 
-          await log('\n   This will continue from where it left off with full context.\n');
-        } else {
-          await log('\n⚠️  Note: Temporary directory will be automatically cleaned up.');
+        await log('\n💡 After the limit resets, resume using the Claude command above.');
+
+        if (argv.autoCleanup !== false) {
+          await log('');
+          await log('⚠️  Note: Temporary directory will be automatically cleaned up.');
           await log('   To keep the directory for debugging or resuming, use --no-auto-cleanup');
         }
       }
     } else {
-      // Show command to resume session in interactive mode only if --no-auto-cleanup was passed
-      if (argv.autoCleanup === false) {
-        await log('\n💡 To continue this session in Claude Code interactive mode:\n');
-        await log(`   (cd ${tempDir} && claude --resume ${sessionId})`);
-        await log('');
-      } else {
-        await log('\n⚠️  Note: Temporary directory will be automatically cleaned up.');
+      // Show note about auto-cleanup only when enabled
+      if (argv.autoCleanup !== false) {
+        await log('ℹ️  Note: Temporary directory will be automatically cleaned up.');
         await log('   To keep the directory for debugging or resuming, use --no-auto-cleanup');
       }
     }

package/src/solve.watch.lib.mjs

@@ -400,15 +400,19 @@ export const watchForFeedback = async params => {
 
           // Check for Playwright MCP availability if using Claude tool
           if (argv.tool === 'claude' || !argv.tool) {
-            const playwrightMcpAvailable = await checkPlaywrightMcpAvailability();
-            if (playwrightMcpAvailable) {
-              await log('🎭 Playwright MCP detected - enabling browser automation hints', { verbose: true });
-              argv.promptPlaywrightMcp = true;
+            // If flag is true (default), check if Playwright MCP is actually available
+            if (argv.promptPlaywrightMcp) {
+              const playwrightMcpAvailable = await checkPlaywrightMcpAvailability();
+              if (playwrightMcpAvailable) {
+                await log('🎭 Playwright MCP detected - enabling browser automation hints', { verbose: true });
+              } else {
+                await log('ℹ️  Playwright MCP not detected - browser automation hints will be disabled', {
+                  verbose: true,
+                });
+                argv.promptPlaywrightMcp = false;
+              }
             } else {
-              await log('ℹ️  Playwright MCP not detected - browser automation hints will be disabled', {
-                verbose: true,
-              });
-              argv.promptPlaywrightMcp = false;
+              await log('ℹ️  Playwright MCP explicitly disabled via --no-prompt-playwright-mcp', { verbose: true });
             }
           }
 

package/CLAUDE.md

@@ -1,5 +0,0 @@
-Issue to solve: https://github.com/link-assistant/hive-mind/issues/962
-Your prepared branch: issue-962-7502f60e53a0
-Your prepared working directory: /tmp/gh-issue-solver-1766423610256
-
-Proceed.