Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
Manages executables as persistent macOS launchd user agents. Handles plist creation, service lifecycle (start, stop, restart), and log access through a set of shell scripts. Services auto-restart on crash and run without elevated privileges.
Using launchd instead of background shell processes means services survive session ends and restart automatically on failure without any manual intervention.
When to use it
- Keep a local proxy server running after terminal closes
- Auto-restart a development backend that crashes intermittently
- Run a scheduled background worker as a persistent user service
- Check which background services are currently active on macOS
- Tail logs from a long-running daemon without manual log hunting
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: run my Go server at ~/projects/myapp as a background service that restarts on crash
- 1Build the Go binary with go build to produce an absolute binary path
- 2Call install.sh with the service name, binary path, any required args, and --workdir set to the project directory
- 3Verify the service is running with status.sh
- 4Confirm log output is appearing with logs.sh --follow
Service installed at ~/Library/LaunchAgents/ai.toolguard.myapp.plist, running as a user agent, logs streaming to ~/Library/Logs/toolguard/myapp/