Sitemd launch

Launch the sitemd dev server. Usage: /launch [demo|scratch]. No args serves the user's project.

install

source · Clone the upstream repo

git clone https://github.com/sitemd-cc/sitemd

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/sitemd-cc/sitemd "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/launch" ~/.claude/skills/sitemd-cc-sitemd-launch-33867f && rm -rf "$T"

manifest: .claude/skills/launch/SKILL.md

source content

Launch Site

Starts the dev server with file watching and live build sync, then opens in the default browser.

Input

Optional target from arguments:

$ARGUMENTS

No arguments → serve the user's project (
```
sitemd/
```
)
```
demo
```
→ serve the demo component showcase (
```
sitemd/templates/demo/
```
)
```
scratch
```
→ serve the blank-slate template (
```
sitemd/templates/scratch/
```
)

Procedure

Determine the target

Parse
```
$ARGUMENTS
```
for "demo" or "scratch"
If demo: set root to
```
sitemd/templates/demo/
```
, read port from its
```
settings/build.md
```
(default 4848)
If scratch: set root to
```
sitemd/templates/scratch/
```
, read port from its
```
settings/build.md
```
(default 4747)
If no arguments: set root to
```
sitemd/
```
, read port from its
```
settings/build.md
```
(default 4747)

Check binary

Check if
```
sitemd/sitemd
```
binary exists in the project
If missing, run
```
./sitemd/install
```
to download it

Check dependencies

Check if
```
<root>/node_modules/
```
exists (where
```
<root>
```
is the target directory from step 1)

If missing or if

package.json

is newer than

node_modules/

, run

npm install

from

<root>

If install fails, warn the user but continue launching — some features (icons, OG images) may not work

Launch the server

Kill any existing process on the determined port:
```
lsof -ti:<port> | xargs kill 2>/dev/null; true
```

Start the dev server in background:

cd <root> && ./sitemd/sitemd launch &

(for demo/scratch, use

SITEMD_PROJECT_ROOT="$(pwd)" ./sitemd/sitemd launch &

from inside the target directory)

Wait 1 second for the server to start, then open in browser:

If Chrome is installed (

/Applications/Google Chrome.app

exists), open with a dedicated debugging profile and DevTools:

sleep 1 && open -na "Google Chrome" --args --user-data-dir="/tmp/sitemd-chrome-debug" --auto-open-devtools-for-tabs http://localhost:<port>

Otherwise:
```
sleep 1 && open http://localhost:<port>
```

Tell the user what's running:
- Demo: "Demo showcase is live at http://localhost:<port> — browse to see what sitemd can do"
- Scratch: "Blank-slate template is live at http://localhost:<port>"
- Project: "Your site is live at http://localhost:<port> with live build sync — file changes auto-rebuild"

Rules

No permission required — Execute immediately without asking
Read the port from the target's settings — do not hardcode ports
Set
SITEMD_PROJECT_ROOT
when launching demo/scratch — tells the binary the actual project root

Use
./sitemd/sitemd launch
— the compiled binary, not

node engine/build --serve

Background the server so the terminal stays usable