Repository navigation
Paseobility v2.12.8
The Paseo bot becomes a resident, self-healing service on macOS, Linux and Windows, and survives Paseo updates without losing running work.
- Survives Paseo updates. A Paseo client runtime that disappears while an installer replaces it is treated as a temporary outage and retried with growing waits. A failed status check never stops, archives or removes a still-running agent or its worktree; the task becomes
unknownand says so. Every failure writes its real error text to the bot's private stderr log. - Protects the bot's own computer. Task agents receive
PASEO_BOT_PROTECTED_HOSTS, andpaseo-multirefuses to install, replace, stop or restart Paseo on that host, asking for a manual update instead. - Resident supervisor on any controller.
tools/paseo-bot/supervisor.pyrestarts the dispatcher and GUI service about one second after they exit, detects hangs from their heartbeats, asks them to stop at a safe point before any forced restart, backs off crash loops and raises desktop alerts. The operating system keeps the supervisor alive: a launchd agent on macOS and a systemd user service on Linux (no admin rights), or the opt-inPaseoBotGuardianWindows service (one UAC consent, no stored password, runs in the user's own session and identity). Windows starts nothing in a console window. - GUI on Mac and Linux controllers. The bot GUI plugin connects through the new
gui-bridge.sh, or without SSH when it runs on the controller ("host": "local"), and shows the controller's real host name. Conversation managers share one workspace; a manager idle formanagerIdleDays(default 7) is archived and revived with the earlier conversation when needed. - Also included since v2.12.2: the resident Paseo bot itself (fleet project routing, reviewed task queue, chat planning GUI, Grok completion webhooks),
paseo-multiremote health reports and guarded cleanup, and a plugin skill-install fix that removes only its own staging directory after a failed backup move.
Validation:
- macOS and Windows CI passed for commit
a6b063dd21df138003fba3750d3b9a9eff13519f, including a real supervisor-loop integration test on both systems. - Real Mac (macOS 15.8.1): launchd agent install, dispatcher restart in 3 s, supervisor revived by launchd in 2 s with services adopted, graceful restart, local GUI bridge, simulated login, owner-only state files. The test environment was removed afterwards.
- Real Windows 11: guardian service revived by the Service Control Manager in 1.3 s, supervisor revived in 1.5 s, graceful restart in 3.5 s, and no console window during an 11-minute window watch.
- Package and plugin version consistency verified; the release ZIP is a
git archiveof the tagged commit.
Not verified: a physical reboot of the Mac, Linux on real hardware, and a declined UAC prompt. Existing compatibility reports retain their original scope.
The package version and plugin version are 2.12.8. Installation does not upgrade or restart Paseo, and the supervisor and guardian are installed only by their explicit commands.