App Launcher

Create clickable macOS .app bundles that launch dev servers.

Quick Start

python ~/.claude/skills/app-launcher/scripts/create_launcher.py /path/to/project

This creates ProjectName.app on Desktop. Double-click → Terminal opens → dev server runs.

Usage

Basic (Auto-detect)

python ~/.claude/skills/app-launcher/scripts/create_launcher.py ~/projects/my-app

With Custom Options

python ~/.claude/skills/app-launcher/scripts/create_launcher.py ~/projects/my-app \
  --name "My App" \
  --cmd "npm run dev" \
  --icon ~/icons/my-app.png \
  --output ~/Desktop

Options

Auto-Detection

The script auto-detects project type:

Also auto-detects venv/ or .venv/ and activates it.

Custom Icon

Provide a .png or .icns file:

--icon ~/Desktop/my-logo.png

The script converts PNG to proper macOS icns format.

Workflow

1. User says "create launcher for this project" or "make desktop icon"
2. Identify project path and any custom requirements (name, icon, command)
3. Run the script with appropriate options
4. Confirm the .app was created on Desktop
5. User can now double-click to launch

Examples

Create launcher for current project

python ~/.claude/skills/app-launcher/scripts/create_launcher.py .

Create launcher with custom icon from project

python ~/.claude/skills/app-launcher/scripts/create_launcher.py ~/projects/canmarket \
  --name "CanMarket Dev" \
  --icon ~/projects/canmarket/public/logo.png

Create launcher with specific command

python ~/.claude/skills/app-launcher/scripts/create_launcher.py ~/projects/api \
  --cmd "uvicorn main:app --reload"

Author

Canlah AI — Run performance marketing without breaking your brand.

• GitHub: github.com/PHY041
• All Skills: clawhub.ai/PHY041