| name | deploy-server |
| description | Build and restart mclaude-server as a launchd service. Use when the user wants to deploy, rebuild, or restart the server. |
Deploy MClaude Server
Build and restart mclaude-server as a launchd service.
Steps
-
Build the server (release mode):
cd mclaude-server && swift build -c release
-
Restart the service (rebuild only — no plist changes):
launchctl kickstart -k gui/$(id -u)/com.mclaude.server
If you changed the plist (env vars etc.), do a full reload instead:
launchctl bootout gui/$(id -u)/com.mclaude.server
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.mclaude.server.plist
-
Verify:
curl -s http://localhost:8377/health
tail -10 /tmp/mclaude-server.log
Service Management
| Action | Command |
|---|
| Status | launchctl print gui/$(id -u)/com.mclaude.server |
| Restart | launchctl kickstart -k gui/$(id -u)/com.mclaude.server |
| Stop | launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.mclaude.server.plist |
| Start | launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.mclaude.server.plist |
| Logs | tail -f /tmp/mclaude-server.log |
Plist Location
~/Library/LaunchAgents/com.mclaude.server.plist
Environment Variables
| Variable | Default | Description |
|---|
MCLAUDE_HOST | 127.0.0.1 | Listen address |
MCLAUDE_PORT | 8377 | Listen port |
MCLAUDE_TMUX_TARGET | mclaude | tmux session to monitor |
MCLAUDE_POLL_INTERVAL | 1 | Poll interval in seconds |
Binary Location
.build/arm64-apple-macosx/release/mclaude-server
Notes
- Service auto-restarts on crash (
KeepAlive: true)
- Service auto-starts on login (
RunAtLoad: true)
- Monitors the
mclaude tmux session for active Claude sessions
- Logs at
/tmp/mclaude-server.log
