A terminal automation skill that launches Claude Code and automatically enables Remote Control for seamless multi-device coding sessions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install claude-code-launcher
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install claude-code-launcher using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Claude Code Launcher?
The Claude Code Launcher is a specialized automation tool designed to streamline the initiation of AI-assisted development environments. As part of the Openclaw Skills library, it eliminates the repetitive manual steps required to start a Claude session, such as opening new terminal windows, navigating deep into project directories, and typing startup commands.
By leveraging macOS UI automation, this skill ensures that your workspace is prepared perfectly every time. It is particularly effective for developers who utilize the Remote Control feature to sync their Claude sessions across different devices, providing a robust bridge between local development and AI mobility.
Claude Code Launcher Use Cases
- Rapidly opening a project for an interactive coding session using a single voice or chat command.
- Automatically enabling Remote Control mode to hand off a Claude Code session to a mobile device.
- Switching between multiple coding projects quickly without manually managing terminal windows.
- Troubleshooting terminal-based AI setups through automated error detection and recovery logic provided by Openclaw Skills.
How Claude Code Launcher Works
- Terminal Preparation: The skill opens a new macOS Terminal window and initializes a clean shell environment.
- Project Navigation: It validates the provided directory path and navigates the shell to the target project root.
- Claude Code Launch: The skill executes the claude code command and waits for the interactive interface to load.
- Remote Control Activation: It automatically sends the /remote-control command to the terminal session.
- Menu Interaction: The automation identifies and clicks the Continue prompts to establish the remote session.
- Session Reporting: It captures a screenshot of the QR code and session URL, reporting the final state back to the user.
Claude Code Launcher Setup
To utilize this skill, you must ensure your macOS environment is configured for UI automation and the Claude CLI is accessible.
Prerequisites
- macOS with Terminal.app
peekabooCLI for terminal and keyboard automationclaudeCLI installed via Homebrew or NPM
Required Permissions
Openclaw Skills require specific system permissions to interact with your terminal:
- Open System Settings → Privacy & Security.
- Enable Screen Recording for Openclaw.
- Enable Accessibility for Openclaw.
Installation
# Ensure Claude Code is updated
brew install claude
# Verify dependencies
peekaboo --version
Claude Code Launcher Data Schema & Taxonomy
The skill organizes execution data and session metadata to provide transparency during the automation process.
| Data Type | Purpose | Storage Location |
|---|---|---|
| Execution Logs | Detailed history of automation steps and CLI output | ~/.openclaw/workspace/logs/claude-code-launcher.log |
| Screenshots | Visual confirmation of Remote Control status and QR codes | ~/.openclaw/workspace/ |
| Session Metadata | Extracted URLs and QR code text for device pairing | In-memory session context |
| Path Resolution | Mapping of shorthand project names to absolute paths | System shell environment |
Claude Code Launcher Advanced Features
- Intelligent retry logic that handles terminal startup delays and shell configuration issues.
- Multi-device support via automated Remote Control handshaking and URL extraction.
- Visual state validation using screenshot capture to confirm the session is active and secure.
- Natural language processing through Openclaw Skills allowing for intuitive project switching like "Open my web-app in Claude".
SKILL.md
Loading
Related Openclaw Skills
Triumvirate Protocol
An identity-aware debate engine that orchestrates multi-architecture AI discourse through structured identity graphs and persistent thread tracking.
Identity Persistence Layer
A structured identity graph system for AI agents that synthesizes memory files into versioned, scored identity snapshots.
Cortex Protocol
A gasless on-chain identity protocol for AI agents using the ERC-8004 standard on the Base network.
Agent Sovereign Stack
A comprehensive infrastructure suite for AI agents to achieve sovereign identity, decentralized memory, and financial autonomy.
Batch Processing DataLoader
Eliminate N+1 query overhead by batching and caching database or API requests into efficient single operations.
HTTP Retry + Circuit Breaker Skill
A robust HTTP client extension for Openclaw Skills that implements exponential backoff retries and circuit breaker patterns to drastically reduce API failure rates.
Featured*
