Skip to content
Back to skills

Phy App Launcher

ASecurity

Create macOS desktop app launchers for dev projects. Click an icon on Desktop → auto-runs local dev server in Terminal. Use when user wants to make an app "persistent", create a desktop shortcut, launch dev server with one click, or says "make this app clickable" / "create launcher" / "desktop icon for this project".

  • 3 stars
  • 0 votes
  • 0 copies
  • 3 views
  • Added September 9, 2026
toolspythongobashnodedjangodockergitapiperformance

Works with

  • terminal
  • cli
  • api

Security analysis

A100/100

Scanned September 9, 2026

npx -y skills add Lord1Egypt/awesome-skill-forge --skill phy-app-launcher --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Phy App Launcher?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Phy App Launcher
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/lord1egypt-phy-app-launcher/badge)](https://www.skillsdirectory.com/skills/lord1egypt-phy-app-launcher)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: app-launcher
description: Create macOS desktop app launchers for dev projects. Click an icon on Desktop → auto-runs local dev server in Terminal. Use when user wants to make an app "persistent", create a desktop shortcut, launch dev server with one click, or says "make this app clickable" / "create launcher" / "desktop icon for this project".
homepage: https://canlah.ai
---

# App Launcher

Create clickable macOS .app bundles that launch dev servers.

## Quick Start

```bash
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)
```bash
python ~/.claude/skills/app-launcher/scripts/create_launcher.py ~/projects/my-app
```

### With Custom Options
```bash
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

| Option | Description |
|--------|-------------|
| `--name` | App display name (default: folder name) |
| `--cmd` | Start command (default: auto-detect) |
| `--icon` | Icon file path (.icns or .png) |
| `--output` | Output directory (default: ~/Desktop) |

## Auto-Detection

The script auto-detects project type:

| Project | Detection | Default Command |
|---------|-----------|-----------------|
| Node.js | `package.json` | `npm run dev` / `npm start` |
| Python | `app.py` / `main.py` | `python app.py` |
| Django | `manage.py` | `python manage.py runserver` |
| Docker | `docker-compose.yml` | `docker-compose up` |
| Make | `Makefile` | `make dev` |

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

## Custom Icon

Provide a .png or .icns file:
```bash
--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
```bash
python ~/.claude/skills/app-launcher/scripts/create_launcher.py .
```

### Create launcher with custom icon from project
```bash
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
```bash
python ~/.claude/skills/app-launcher/scripts/create_launcher.py ~/projects/api \
  --cmd "uvicorn main:app --reload"
```

---

## Author

**[Canlah AI](https://canlah.ai)** — Run performance marketing without breaking your brand.

- GitHub: [github.com/PHY041](https://github.com/PHY041)
- All Skills: [clawhub.ai/PHY041](https://clawhub.ai/PHY041)

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in tools →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.