launchagent-manager

# Launchagent Manager ## Description List, classify, prune LaunchAgents; analyze openclaw.json so the proper gateway LaunchAgent remains connected and tokens match. Keeps only OpenClaw-related agents; can unload/delete others. # LaunchAgent Manager Manages LaunchAgents in `~/Library/LaunchAgents` and analyzes **openclaw.json** so the **gateway LaunchAgent** stays correct: loaded when it should be, and **tokens matching** config vs running gateway. - **List/prune:** Classify agents as OpenClaw (keep) or other (prune). OpenClaw = Label or path contains "openclaw". - **Config check:** Read `openclaw.json` → gateway port, auth mode, token set; find the gateway plist (e.g. ai.openclaw.gateway); report loaded? running? tokens match? (Uses gateway-guard status when available.) Recommends loading the plist or running gateway-guard ensure --apply if needed. - **--fix:** With --config, can load the gateway plist if not loaded and run gateway-guard ensure --apply if tokens mismatch. ## Usage - **Ensure gateway stays connected:** Run `--config` to verify the gateway LaunchAgent is loaded and tokens match; use `--config --fix` to load plist and sync auth. - List what's running: see OpenClaw vs other agents. - Remove non-OpenClaw LaunchAgents: prune so only OpenClaw daemons remain. ```bash python3 <skill-dir>/scripts/launchagent_manager.py [--list] [--json] python3 <skill-dir>/scripts/launchagent_manager.py --config [--fix] [--json] python3 <skill-dir>/scripts/launchagent_manager.py --prune [--dry-run] python3 <skill-dir>/scripts/launchagent_manager.py --prune --apply [--delete-plists] ``` - **--list** (default) — List all LaunchAgents; show OpenClaw (kept) vs others (prune targets). Shows loaded/unloaded. - **--config** — Analyze openclaw.json and gateway LaunchAgent: config path, gateway port, auth, token set; gateway plist label and loaded?; gateway process running?; tokens match (config vs running)? Recommendations if plist not loaded or tokens mismatch. Exit 0 if all ok, 1 if action needed. - **--config --fix** — If gateway plist not loaded: run `launchctl load <plist>`. If tokens don't match: run gateway-guard `ensure --apply --json`. Requires gateway-guard skill. - **--config --json** — Machine-readable report: config_path, gateway, gateway_launchagent, gateway_loaded, tokens_match, gateway_running, recommendations. - **--json** — For --list: `{ "openclaw": [...], "others": [...] }`. - **--prune** — Operate on non-OpenClaw agents. Without --apply this is a dry-run (show what would be unloaded). - **--prune --dry-run** — Only show what would be unloaded. - **--prune --apply** — Unload each non-OpenClaw LaunchAgent. Plist files kept unless --delete-plists. - **--prune --apply --delete-plists** — Unload and delete plist files (backed up to OPENCLAW_HOME/backups/launchagents). ## Safety - Only user domain is touched: `~/Library/LaunchAgents/`. System domain is not modified. - OpenClaw detection is conservative: Label `com.openclaw.*` or any ProgramArgument containing "openclaw" → kept. - With --delete-plists, backups are written to `OPENCLAW_HOME/backups/launchagents/` before deletion. ## Requirements - macOS (launchctl, plist in user LaunchAgents). - Python 3 with plistlib (standard library).