{
  "schemaVersion": "1.0",
  "item": {
    "slug": "claude-code-launcher",
    "name": "Claude Code Launcher",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/QusaiiSaleem/claude-code-launcher",
    "canonicalUrl": "https://clawhub.ai/QusaiiSaleem/claude-code-launcher",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/claude-code-launcher",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=claude-code-launcher",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "references/troubleshooting.md",
      "scripts/launch_claude_code.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "claude-code-launcher",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T11:32:25.308Z",
      "expiresAt": "2026-05-08T11:32:25.308Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=claude-code-launcher",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=claude-code-launcher",
        "contentDisposition": "attachment; filename=\"claude-code-launcher-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "claude-code-launcher"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/claude-code-launcher"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/claude-code-launcher",
    "agentPageUrl": "https://openagent3.xyz/skills/claude-code-launcher/agent",
    "manifestUrl": "https://openagent3.xyz/skills/claude-code-launcher/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/claude-code-launcher/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Overview",
        "body": "This skill automates the process of launching Claude Code in a new terminal window with Remote Control enabled. It streamlines the workflow of:\n\nOpening a fresh terminal window\nNavigating to a project directory\nStarting Claude Code\nActivating Remote Control mode\nHandling user confirmations (if needed)\nCapturing and displaying the final state\n\nPerfect for switching between projects quickly or sharing Claude Code sessions across devices."
      },
      {
        "title": "Basic Launch",
        "body": "claude-code-launcher /path/to/project"
      },
      {
        "title": "With Options",
        "body": "claude-code-launcher /path/to/project --verbose --screenshot"
      },
      {
        "title": "From OpenClaw Chat",
        "body": "Simply ask:\n\n\"Launch Claude Code in proposal-generator with Remote Control\"\n\"Open the ai-native-lms project and enable Remote Control\"\n\"Start Claude Code in ~/dev/edikar-standalone\""
      },
      {
        "title": "Step 1: Terminal Preparation",
        "body": "Opens a new Terminal window using macOS automation\nEnsures fresh shell environment (zsh)\nWaits for the window to be ready"
      },
      {
        "title": "Step 2: Project Navigation",
        "body": "Changes directory to the specified project path\nValidates that the directory exists\nReports any path resolution errors"
      },
      {
        "title": "Step 3: Claude Code Launch",
        "body": "Executes claude code command\nWaits for Claude Code interface to fully load (~5 seconds)\nMonitors for startup errors (missing dependencies, permission issues)"
      },
      {
        "title": "Step 4: Remote Control Activation",
        "body": "Types /remote-control command into Claude Code\nPresses Enter to submit\nWaits for Remote Control UI to appear (~3-6 seconds)"
      },
      {
        "title": "Step 5: User Confirmation",
        "body": "Detects the \"Continue\" option in Remote Control menu\nPresses Enter to confirm (or prompts user if needed)\nValidates that Remote Control is now active"
      },
      {
        "title": "Step 6: Session Capture",
        "body": "Takes a screenshot of the final state\nDisplays the Remote Control session URL\nExtracts and displays QR code information\nReports success or any errors encountered"
      },
      {
        "title": "Error Handling",
        "body": "The skill handles these common scenarios:\n\nIssueRecoveryTerminal fails to openRetries once, then reports errorProject path doesn't existDisplays helpful path resolution suggestionsClaude Code not installedReports missing dependency and suggests brew install claudeClaude Code hangsTimeout after 15 seconds, allows manual interventionRemote Control fails to activateLogs error details, suggests checking Claude versionTerminal permissions deniedRequests user to enable Screen Recording in System PreferencesNetwork connectivity issueWaits up to 10 seconds for reconnection"
      },
      {
        "title": "scripts/launch_claude_code.sh",
        "body": "Main automation script using Peekaboo CLI for:\n\nTerminal window management\nKeyboard/text input automation\nScreenshot capture\nError detection and recovery\nLogging all operations to ~/.openclaw/workspace/logs/claude-code-launcher.log"
      },
      {
        "title": "references/troubleshooting.md",
        "body": "Common issues and solutions:\n\nPermission setup (Screen Recording, Accessibility)\nClaude Code installation and updates\nTerminal app configuration\nNetwork troubleshooting"
      },
      {
        "title": "Prerequisites",
        "body": "✅ Installed: peekaboo (for UI automation)\n✅ Installed: claude CLI (Claude Code)\n✅ System: macOS with Terminal.app\n✅ Permissions: Screen Recording + Accessibility enabled\n\nTo enable permissions:\n\nSystem Settings → Privacy & Security → Screen Recording → Enable OpenClaw\nSystem Settings → Privacy & Security → Accessibility → Enable OpenClaw"
      },
      {
        "title": "What You Get",
        "body": "After launching, you'll have:\n\n✅ New Terminal window with Claude Code running\n✅ Remote Control session active and shareable\n✅ Session URL for accessing from other devices\n✅ QR code for mobile devices (scan in Claude app)\n✅ Full context of your project available to Claude\n✅ Capability to pause/resume across devices"
      },
      {
        "title": "Example Workflow",
        "body": "User: \"Launch Claude Code in edikar-standalone with Remote Control\"\n↓\nSkill opens new Terminal\n↓\ncd ~/dev/edikar-standalone\n↓\nclaude code\n↓\n/remote-control\n↓\n[Confirms continuation]\n↓\nScreenshot captured\n↓\nUser sees:\n   - Session URL: https://claude.ai/code/session_...\n   - QR code displayed\n   - Ready to access from phone/tablet"
      },
      {
        "title": "Related Commands",
        "body": "/remote-control - Activate Remote Control in Claude Code\nclaude code - Start Claude Code interactive session\npeekaboo - macOS UI automation (used internally)\n\nNeed help? See references/troubleshooting.md for common issues and solutions."
      }
    ],
    "body": "Claude Code Launcher\nOverview\n\nThis skill automates the process of launching Claude Code in a new terminal window with Remote Control enabled. It streamlines the workflow of:\n\nOpening a fresh terminal window\nNavigating to a project directory\nStarting Claude Code\nActivating Remote Control mode\nHandling user confirmations (if needed)\nCapturing and displaying the final state\n\nPerfect for switching between projects quickly or sharing Claude Code sessions across devices.\n\nUsage\nBasic Launch\nclaude-code-launcher /path/to/project\n\nWith Options\nclaude-code-launcher /path/to/project --verbose --screenshot\n\nFrom OpenClaw Chat\n\nSimply ask:\n\n\"Launch Claude Code in proposal-generator with Remote Control\"\n\"Open the ai-native-lms project and enable Remote Control\"\n\"Start Claude Code in ~/dev/edikar-standalone\"\nHow It Works\nStep 1: Terminal Preparation\nOpens a new Terminal window using macOS automation\nEnsures fresh shell environment (zsh)\nWaits for the window to be ready\nStep 2: Project Navigation\nChanges directory to the specified project path\nValidates that the directory exists\nReports any path resolution errors\nStep 3: Claude Code Launch\nExecutes claude code command\nWaits for Claude Code interface to fully load (~5 seconds)\nMonitors for startup errors (missing dependencies, permission issues)\nStep 4: Remote Control Activation\nTypes /remote-control command into Claude Code\nPresses Enter to submit\nWaits for Remote Control UI to appear (~3-6 seconds)\nStep 5: User Confirmation\nDetects the \"Continue\" option in Remote Control menu\nPresses Enter to confirm (or prompts user if needed)\nValidates that Remote Control is now active\nStep 6: Session Capture\nTakes a screenshot of the final state\nDisplays the Remote Control session URL\nExtracts and displays QR code information\nReports success or any errors encountered\nError Handling\n\nThe skill handles these common scenarios:\n\nIssue\tRecovery\nTerminal fails to open\tRetries once, then reports error\nProject path doesn't exist\tDisplays helpful path resolution suggestions\nClaude Code not installed\tReports missing dependency and suggests brew install claude\nClaude Code hangs\tTimeout after 15 seconds, allows manual intervention\nRemote Control fails to activate\tLogs error details, suggests checking Claude version\nTerminal permissions denied\tRequests user to enable Screen Recording in System Preferences\nNetwork connectivity issue\tWaits up to 10 seconds for reconnection\nResources\nscripts/launch_claude_code.sh\n\nMain automation script using Peekaboo CLI for:\n\nTerminal window management\nKeyboard/text input automation\nScreenshot capture\nError detection and recovery\nLogging all operations to ~/.openclaw/workspace/logs/claude-code-launcher.log\nreferences/troubleshooting.md\n\nCommon issues and solutions:\n\nPermission setup (Screen Recording, Accessibility)\nClaude Code installation and updates\nTerminal app configuration\nNetwork troubleshooting\nPrerequisites\n\n✅ Installed: peekaboo (for UI automation)\n✅ Installed: claude CLI (Claude Code)\n✅ System: macOS with Terminal.app\n✅ Permissions: Screen Recording + Accessibility enabled\n\nTo enable permissions:\n\nSystem Settings → Privacy & Security → Screen Recording → Enable OpenClaw\nSystem Settings → Privacy & Security → Accessibility → Enable OpenClaw\n\nWhat You Get\n\nAfter launching, you'll have:\n\n✅ New Terminal window with Claude Code running\n✅ Remote Control session active and shareable\n✅ Session URL for accessing from other devices\n✅ QR code for mobile devices (scan in Claude app)\n✅ Full context of your project available to Claude\n✅ Capability to pause/resume across devices\nExample Workflow\nUser: \"Launch Claude Code in edikar-standalone with Remote Control\"\n↓\nSkill opens new Terminal\n↓\ncd ~/dev/edikar-standalone\n↓\nclaude code\n↓\n/remote-control\n↓\n[Confirms continuation]\n↓\nScreenshot captured\n↓\nUser sees:\n   - Session URL: https://claude.ai/code/session_...\n   - QR code displayed\n   - Ready to access from phone/tablet\n\nRelated Commands\n/remote-control - Activate Remote Control in Claude Code\nclaude code - Start Claude Code interactive session\npeekaboo - macOS UI automation (used internally)\n\nNeed help? See references/troubleshooting.md for common issues and solutions."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/QusaiiSaleem/claude-code-launcher",
    "publisherUrl": "https://clawhub.ai/QusaiiSaleem/claude-code-launcher",
    "owner": "QusaiiSaleem",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/claude-code-launcher",
    "downloadUrl": "https://openagent3.xyz/downloads/claude-code-launcher",
    "agentUrl": "https://openagent3.xyz/skills/claude-code-launcher/agent",
    "manifestUrl": "https://openagent3.xyz/skills/claude-code-launcher/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/claude-code-launcher/agent.md"
  }
}