# Send Claude Code Launcher to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - 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. ## Suggested prompts ### New install ```text 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. ``` ### Upgrade existing ```text 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. ``` ## Machine-readable fields ```json { "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": { "downloadUrl": "/downloads/claude-code-launcher", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=claude-code-launcher", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "references/troubleshooting.md", "scripts/launch_claude_code.sh" ], "downloadMode": "redirect", "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." ] } }, "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" } } ``` ## Documentation ### Overview This skill automates the process of launching Claude Code in a new terminal window with Remote Control enabled. It streamlines the workflow of: Opening a fresh terminal window Navigating to a project directory Starting Claude Code Activating Remote Control mode Handling user confirmations (if needed) Capturing and displaying the final state Perfect for switching between projects quickly or sharing Claude Code sessions across devices. ### Basic Launch claude-code-launcher /path/to/project ### With Options claude-code-launcher /path/to/project --verbose --screenshot ### From OpenClaw Chat Simply ask: "Launch Claude Code in proposal-generator with Remote Control" "Open the ai-native-lms project and enable Remote Control" "Start Claude Code in ~/dev/edikar-standalone" ### Step 1: Terminal Preparation Opens a new Terminal window using macOS automation Ensures fresh shell environment (zsh) Waits for the window to be ready ### Step 2: Project Navigation Changes directory to the specified project path Validates that the directory exists Reports any path resolution errors ### Step 3: Claude Code Launch Executes claude code command Waits for Claude Code interface to fully load (~5 seconds) Monitors for startup errors (missing dependencies, permission issues) ### Step 4: Remote Control Activation Types /remote-control command into Claude Code Presses Enter to submit Waits for Remote Control UI to appear (~3-6 seconds) ### Step 5: User Confirmation Detects the "Continue" option in Remote Control menu Presses Enter to confirm (or prompts user if needed) Validates that Remote Control is now active ### Step 6: Session Capture Takes a screenshot of the final state Displays the Remote Control session URL Extracts and displays QR code information Reports success or any errors encountered ### Error Handling The skill handles these common scenarios: IssueRecoveryTerminal 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 ### scripts/launch_claude_code.sh Main automation script using Peekaboo CLI for: Terminal window management Keyboard/text input automation Screenshot capture Error detection and recovery Logging all operations to ~/.openclaw/workspace/logs/claude-code-launcher.log ### references/troubleshooting.md Common issues and solutions: Permission setup (Screen Recording, Accessibility) Claude Code installation and updates Terminal app configuration Network troubleshooting ### Prerequisites ✅ Installed: peekaboo (for UI automation) ✅ Installed: claude CLI (Claude Code) ✅ System: macOS with Terminal.app ✅ Permissions: Screen Recording + Accessibility enabled To enable permissions: System Settings → Privacy & Security → Screen Recording → Enable OpenClaw System Settings → Privacy & Security → Accessibility → Enable OpenClaw ### What You Get After launching, you'll have: ✅ New Terminal window with Claude Code running ✅ Remote Control session active and shareable ✅ Session URL for accessing from other devices ✅ QR code for mobile devices (scan in Claude app) ✅ Full context of your project available to Claude ✅ Capability to pause/resume across devices ### Example Workflow User: "Launch Claude Code in edikar-standalone with Remote Control" ↓ Skill opens new Terminal ↓ cd ~/dev/edikar-standalone ↓ claude code ↓ /remote-control ↓ [Confirms continuation] ↓ Screenshot captured ↓ User sees: - Session URL: https://claude.ai/code/session_... - QR code displayed - Ready to access from phone/tablet ### Related Commands /remote-control - Activate Remote Control in Claude Code claude code - Start Claude Code interactive session peekaboo - macOS UI automation (used internally) Need help? See references/troubleshooting.md for common issues and solutions. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: QusaiiSaleem - Version: 1.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-01T11:32:25.308Z - Expires at: 2026-05-08T11:32:25.308Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/claude-code-launcher) - [Send to Agent page](https://openagent3.xyz/skills/claude-code-launcher/agent) - [JSON manifest](https://openagent3.xyz/skills/claude-code-launcher/agent.json) - [Markdown brief](https://openagent3.xyz/skills/claude-code-launcher/agent.md) - [Download page](https://openagent3.xyz/downloads/claude-code-launcher)