Always-on Setup

y0mcp agents run as system services that start on boot and auto-restart on crash.

Machine requirements

Setup	Notes
Mac Studio / Mac Mini / Linux desktop	Works out of the box
Laptop (open)	Use caffeinate or disable sleep
Laptop (closed)	Use a VPS (e.g., Hetzner CAX11 ~€3/mo)

macOS (launchd)

# Start
launchctl load ~/Library/LaunchAgents/dev.y0mcp.my-project.plist

# Stop
launchctl unload ~/Library/LaunchAgents/dev.y0mcp.my-project.plist

# Check status
launchctl list | grep y0mcp

# View logs
tail -f ~/.y0mcp/my-project.log

Keep laptop awake

caffeinate -s &

Linux (systemd)

# Start
systemctl --user enable --now y0mcp-my-project

# Stop
systemctl --user disable --now y0mcp-my-project

# Check status
systemctl --user status y0mcp-my-project

# View logs
journalctl --user -u y0mcp-my-project -f

Heartbeat messages

Each agent sends Slack messages on lifecycle events:

• Start: 🟢 y0mcp agent started
• Crash: 🔴 y0mcp agent crashed (with error)
• Stop: 🔴 y0mcp agent stopped

Auto-restart behavior

• macOS: KeepAlive restarts on non-zero exit
• Linux: Restart=on-failure with 30s delay
• Throttle interval prevents rapid restart loops