piu-piu-cli 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 All notable changes to piu-piu. Versions follow [semver](https://semver.org).
 
+## 0.1.1 (2026-10-05)
+
+- Fix piu-piu setup failing with launchd "Bootstrap failed: 5" when the service was already loaded
+
 ## 0.1.0 (2026-10-05)
 
 First release.

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://unpkg.com/piu-piu-cli@0.1.0/docs/banner.svg" alt="piu-piu: a 3D office for your Claude Code agents" width="100%">
+  <img src="https://unpkg.com/piu-piu-cli@0.1.1/docs/banner.svg" alt="piu-piu: a 3D office for your Claude Code agents" width="100%">
 </p>
 
 <p align="center">

package/bin/piu-piu.mjs

@@ -33,6 +33,22 @@ const fail = (msg) => {
   process.exit(1);
 };
 const quiet = (cmd, args) => spawnSync(cmd, args, { stdio: 'pipe', encoding: 'utf8' });
+const sleepSync = (ms) => Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+
+// launchd unloads asynchronously: loading again too soon fails with
+// "Bootstrap failed: 5". Unload, wait until it's gone, then load (retrying once).
+function launchdUnload(target) {
+  quiet('launchctl', ['bootout', target]);
+  for (let i = 0; i < 40 && quiet('launchctl', ['print', target]).status === 0; i++) sleepSync(250);
+}
+function launchdLoad(domain, plist) {
+  let r = quiet('launchctl', ['bootstrap', domain, plist]);
+  for (let i = 0; i < 3 && r.status !== 0; i++) {
+    sleepSync(1000);
+    r = quiet('launchctl', ['bootstrap', domain, plist]);
+  }
+  return r;
+}
 
 function claudeBinary() {
   for (const p of [join(homedir(), '.local', 'bin', 'claude'), '/opt/homebrew/bin/claude', '/usr/local/bin/claude']) if (existsSync(p)) return p;
@@ -138,9 +154,9 @@ function serviceInstall() {
   if (MAC) {
     const domain = `gui/${process.getuid()}`;
     // the pre-rename service, if this Mac still has it
-    quiet('launchctl', ['bootout', `${domain}/${LEGACY_LABEL}`]);
+    launchdUnload(`${domain}/${LEGACY_LABEL}`);
     rmSync(join(homedir(), 'Library', 'LaunchAgents', `${LEGACY_LABEL}.plist`), { force: true });
-    quiet('launchctl', ['bootout', `${domain}/${LABEL}`]);
+    launchdUnload(`${domain}/${LABEL}`);
     const env = [['PATH', servicePath()], ['HOME', homedir()], ...passEnv()].map(([k, v]) => `    <key>${esc(k)}</key><string>${esc(v)}</string>`).join('\n');
     mkdirSync(dirname(PLIST), { recursive: true });
     mkdirSync(dirname(LOG), { recursive: true });
@@ -170,8 +186,8 @@ ${env}
 </plist>
 `,
     );
-    const r = quiet('launchctl', ['bootstrap', domain, PLIST]);
-    if (r.status !== 0) fail(`launchctl could not start the service: ${r.stderr}`);
+    const r = launchdLoad(domain, PLIST);
+    if (r.status !== 0) fail(`launchctl could not start the service: ${r.stderr.trim()}. Try: piu-piu start`);
   } else {
     if (quiet('systemctl', ['--user', '--version']).status !== 0) fail('No systemd user session here. Run the office in the foreground instead: piu-piu run');
     mkdirSync(dirname(UNIT), { recursive: true });
@@ -204,7 +220,7 @@ WantedBy=default.target
 
 function serviceUninstall() {
   if (MAC) {
-    quiet('launchctl', ['bootout', `gui/${process.getuid()}/${LABEL}`]);
+    launchdUnload(`gui/${process.getuid()}/${LABEL}`);
     rmSync(PLIST, { force: true });
   } else {
     quiet('systemctl', ['--user', 'disable', '--now', 'piu-piu.service']);
@@ -231,7 +247,7 @@ function open() {
 async function start() {
   if (await state()) return say(c.ok('✓'), `piu-piu is running at ${c.b(URL)}`);
   if (!serviceInstalled()) serviceInstall();
-  else if (MAC) quiet('launchctl', ['bootstrap', `gui/${process.getuid()}`, PLIST]);
+  else if (MAC) launchdLoad(`gui/${process.getuid()}`, PLIST);
   else quiet('systemctl', ['--user', 'start', 'piu-piu.service']);
   if (!(await waitUp())) fail(`piu-piu didn't come up. Check the logs: piu-piu logs`);
   say(c.ok('✓'), `piu-piu is running at ${c.b(URL)}`);
@@ -239,7 +255,7 @@ async function start() {
 
 async function stop() {
   await guardBusy('Stopping');
-  if (MAC) quiet('launchctl', ['bootout', `gui/${process.getuid()}/${LABEL}`]);
+  if (MAC) launchdUnload(`gui/${process.getuid()}/${LABEL}`);
   else quiet('systemctl', ['--user', 'stop', 'piu-piu.service']);
   say(c.ok('✓'), 'piu-piu stopped. Start it again with: piu-piu start');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "piu-piu-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A 3D office for your Claude Code agents: watch every session work, talk to them, approve, resume, and drive the real Claude Code from one place.",
   "type": "module",
   "bin": {