toolguard-daemon-control

通过 scripts 下的 bash 脚本将任意可执行程序安装为 macOS launchd 用户级服务，支持创建并启动、停止卸载、查询状态、列出全部托管服务以及查看 stdout/stderr 日志；服务随失败自动重启，日志写入用户日志目录。

johnnylambada

热度 68.97

最近更新 2026-05-18 12:02:24

分类：自动化依赖：代码执行 / 读写文件应用场景：自动化脚本 / DevOps / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add toolguard-daemon-control

Metadata

name: toolguard-daemon-control
description: Manage long-running processes as macOS launchd services. Use when asked to start, stop, restart, check status of, or manage background services/daemons. Handles launchd plist creation, service lifecycle, and log access. Use this instead of background exec for any process that should persist beyond the current session.

toolguard-daemon-control

Manage any executable as a persistent macOS launchd user agent.

Overview

Services are installed as ~/Library/LaunchAgents/ai.toolguard.<name>.plist and run as user-level launch agents. They auto-restart on failure and log to ~/Library/Logs/toolguard/.

Scripts

All scripts are in scripts/ relative to this skill's directory. Run them with bash.

install.sh — Create and start a service

bash scripts/install.sh <service-name> <command> [args...] [--workdir <dir>] [--env KEY=VALUE ...]

service-name: Short identifier (e.g., toolguard-proxy). Used in plist filename and log paths.
command: Absolute path to the executable.
args: Arguments passed to the command.
--workdir <dir>: Working directory for the process (default: $HOME).
--env KEY=VALUE: Environment variables (repeatable).

Example:

bash scripts/install.sh toolguard-proxy /usr/local/go/bin/go run ./cmd/server --config toolguard.dev.yaml --workdir ~/Documents/toolguard

uninstall.sh — Stop and remove a service

bash scripts/uninstall.sh <service-name>

Unloads the service and removes the plist file. Logs are preserved.

status.sh — Check service status

bash scripts/status.sh [service-name]

Without arguments, lists all ai.toolguard.* services. With a name, shows detailed status for that service.

logs.sh — View service logs

bash scripts/logs.sh <service-name> [--follow] [--lines <n>]

Shows stdout and stderr logs. Default: last 50 lines.

list.sh — List all managed services

bash scripts/list.sh

Lists all installed ai.toolguard.* services with their running state.

Notes

Services run as the current user (no sudo required).
Services auto-restart on crash (KeepAlive = true).
To run a Go project, use the compiled binary path or wrap in a shell script — launchd does not support go run directly. Use go build first, then point to the binary.
Log directory: ~/Library/Logs/toolguard/<service-name>/
Plist location: ~/Library/LaunchAgents/ai.toolguard.<service-name>.plist