process-launcher(borrowed: grapeot/process-launcher, MIT)
完整契约(含 trigger words、API endpoints、YAML 声明规则、安全边界)在
skills/skill_process_launcher.md —— 用之前先读它。架构与开发规范见 AGENTS.md。
速查
cd ~/.claude/skills/process-launcher
# 一次性 setup
uv venv && uv pip install -e '.[dev]'
cp config/launcher.example.yaml config/launcher.yaml # 真实路径只写进本地 config
# 启动 —— 必须从交互式 GUI 终端(Terminal.app/iTerm2)启动,launchd/cron/SSH 会断掉 TCC 链
.venv/bin/process-launcher start --config config/launcher.yaml
- 一次性任务 / 延时任务走
POST /run、/scheduled;常驻服务和周期任务只能 YAML 声明,HTTP 只读。 - AX 场景锚点:watch-transcriber 等录音类自动化、mac-audio-guard —— 凡是后台跑要碰 mic/screen 的 job,用这个而不是裸 cron。
- Upstream: https://github.com/grapeot/process-launcher(本目录是 git clone,
git pull可更新)。