itwillsync 1.2.0 → 1.3.0

package/dist/hub/dashboard/assets/index-DgUZUPW_.js

@@ -0,0 +1,2 @@
+(function(){const t=document.createElement("link").relList;if(t&&t.supports&&t.supports("modulepreload"))return;for(const a of document.querySelectorAll('link[rel="modulepreload"]'))o(a);new MutationObserver(a=>{for(const s of a)if(s.type==="childList")for(const i of s.addedNodes)i.tagName==="LINK"&&i.rel==="modulepreload"&&o(i)}).observe(document,{childList:!0,subtree:!0});function n(a){const s={};return a.integrity&&(s.integrity=a.integrity),a.referrerPolicy&&(s.referrerPolicy=a.referrerPolicy),a.crossOrigin==="use-credentials"?s.credentials="include":a.crossOrigin==="anonymous"?s.credentials="omit":s.credentials="same-origin",s}function o(a){if(a.ep)return;a.ep=!0;const s=n(a);fetch(a.href,s)}})();function B(e){const t=Math.floor(e/1e3);if(t<60)return`${t}s`;const n=Math.floor(t/60);if(n<60)return`${n}m`;const o=Math.floor(n/60),a=n%60;return`${o}h ${a}m`}function z(e){const t=e.match(/^\/(?:Users|home)\/[^/]+/)?.[0];return t?"~"+e.slice(t.length):e}function X(e){return e<1024?`${e} KB`:`${(e/1024).toFixed(1)} MB`}function H(e,t,n){const o=document.createElement("div");o.className=`session-card${e.status==="attention"?" attention":""}`,o.dataset.sessionId=e.id;const a=B(Date.now()-e.connectedAt),s=z(e.cwd),i=document.createElement("div");i.className="card-header";const c=document.createElement("div");c.className="card-agent";const p=document.createElement("div");p.className=`agent-dot ${e.status}`;const P=document.createElement("span");P.className="agent-name",P.textContent=e.name||e.agent,c.appendChild(p),c.appendChild(P);const k=document.createElement("span");k.className="card-uptime",k.textContent=a,i.appendChild(c),i.appendChild(k);const I=document.createElement("div");I.className="card-cwd",I.textContent=s;const h=document.createElement("div");h.className="card-preview";const $=document.createElement("pre");$.className="card-preview-text",$.textContent="Waiting for output...",h.appendChild($),h.addEventListener("click",l=>{l.stopPropagation(),n.onOpen(e)});const g=document.createElement("div");g.className="card-status";const E=document.createElement("span");E.className=`status-badge ${e.status}`,E.textContent=e.status,e.status==="attention"&&(E.style.display="none");const v=document.createElement("span");v.className="attention-badge",v.textContent="Needs your attention",e.status!=="attention"&&(v.style.display="none"),g.appendChild(E),g.appendChild(v);const f=document.createElement("div");f.className="card-actions";const C=document.createElement("button");C.className="action-btn stop",C.textContent="Stop",C.addEventListener("click",l=>{l.stopPropagation(),Q(o,e.id,n.onStop)});const w=document.createElement("button");w.className="action-btn rename",w.textContent="Rename",w.addEventListener("click",l=>{l.stopPropagation(),Z(o,e.id,n.onRename)});const N=document.createElement("button");N.className="action-btn info",N.textContent="Info",N.addEventListener("click",l=>{l.stopPropagation(),n.onInfo(e.id)});const b=document.createElement("button");b.className="action-btn open",b.textContent="Open",b.addEventListener("click",l=>{l.stopPropagation(),n.onOpen(e)}),f.appendChild(b),f.appendChild(w),f.appendChild(N),f.appendChild(C);const R=document.createElement("div");return R.className="card-metadata hidden",o.addEventListener("click",()=>{n.onOpen(e)}),o.appendChild(i),o.appendChild(I),o.appendChild(h),o.appendChild(g),o.appendChild(f),o.appendChild(R),o}function Q(e,t,n){e.querySelector(".confirm-overlay")?.remove();const o=document.createElement("div");o.className="confirm-overlay";const a=document.createElement("span");a.className="confirm-msg",a.textContent="Stop this session?";const s=document.createElement("button");s.className="confirm-btn yes",s.textContent="Yes",s.addEventListener("click",c=>{c.stopPropagation(),n(t),o.remove()});const i=document.createElement("button");i.className="confirm-btn no",i.textContent="No",i.addEventListener("click",c=>{c.stopPropagation(),o.remove()}),o.addEventListener("click",c=>c.stopPropagation()),o.appendChild(a),o.appendChild(s),o.appendChild(i),e.appendChild(o)}function Z(e,t,n){const o=e.querySelector(".agent-name");if(!o)return;const a=o.textContent||"",s=document.createElement("input");s.className="rename-input",s.type="text",s.value=a;const i=()=>{const c=s.value.trim();c&&c!==a&&n(t,c),o.textContent=c||a,o.style.display="",s.remove()};s.addEventListener("keydown",c=>{c.stopPropagation(),c.key==="Enter"?i():c.key==="Escape"&&(o.textContent=a,o.style.display="",s.remove())}),s.addEventListener("blur",i),s.addEventListener("click",c=>c.stopPropagation()),o.style.display="none",o.parentElement?.insertBefore(s,o.nextSibling),s.focus(),s.select()}function G(e,t){const n=e.querySelector(".agent-dot"),o=e.querySelector(".status-badge"),a=e.querySelector(".card-uptime"),s=e.querySelector(".agent-name");n&&(n.className=`agent-dot ${t.status}`),o&&(o.className=`status-badge ${t.status}`,o.textContent=t.status),a&&(a.textContent=B(Date.now()-t.connectedAt)),s&&!s.style.display&&(s.textContent=t.name||t.agent);const i=t.status==="attention";o&&(o.style.display=i?"none":"");const c=e.querySelector(".attention-badge");c&&(c.style.display=i?"":"none"),t.status==="attention"?e.classList.add("attention"):e.classList.remove("attention")}function ee(e,t){const n=e.querySelector(".card-preview-text");n&&(t.length>0?(n.textContent=t.join(`
+`),n.classList.remove("empty")):(n.textContent="Waiting for output...",n.classList.add("empty")))}function te(e,t){const n=e.querySelector(".card-metadata");if(!n)return;for(;n.firstChild;)n.removeChild(n.firstChild);const o=[["PID",String(t.pid)],["Agent",t.agent],["Port",String(t.port)],["Directory",t.cwd],["Memory",X(t.memoryKB)],["Uptime",B(t.uptimeMs)]];for(const[a,s]of o){const i=document.createElement("div");i.className="meta-row";const c=document.createElement("span");c.className="meta-label",c.textContent=a;const p=document.createElement("span");p.className="meta-value",p.textContent=s,i.appendChild(c),i.appendChild(p),n.appendChild(i)}n.classList.toggle("hidden")}let r=null,q=!1;function ne(){if(!q){q=!0;try{r=new AudioContext,r.state==="suspended"&&r.resume()}catch{}}}function U(){if(!r)return;r.state==="suspended"&&r.resume();const e=r.currentTime,t=r.createOscillator(),n=r.createGain();t.frequency.value=587.33,t.type="sine",n.gain.setValueAtTime(.3,e),n.gain.exponentialRampToValueAtTime(.01,e+.3),t.connect(n),n.connect(r.destination),t.start(e),t.stop(e+.3);const o=r.createOscillator(),a=r.createGain();o.frequency.value=880,o.type="sine",a.gain.setValueAtTime(.3,e+.15),a.gain.exponentialRampToValueAtTime(.01,e+.45),o.connect(a),a.connect(r.destination),o.start(e+.15),o.stop(e+.45)}const D=120*1e3,u=new Map;function _(e){if(u.has(e))return;U();const t=setTimeout(function n(){U();const o=u.get(e);o&&(o.timerId=setTimeout(n,D))},D);u.set(e,{timerId:t})}function A(e){const t=u.get(e);t&&(clearTimeout(t.timerId),u.delete(e))}function V(){for(const e of u.values())clearTimeout(e.timerId);u.clear()}const oe=new URLSearchParams(window.location.search),J=oe.get("token");if(!J)throw document.body.textContent="Missing authentication token.",new Error("No token in URL");const ae=window.location.protocol==="https:"?"wss:":"ws:",se=`${ae}//${window.location.host}?token=${J}`,Y=window.location.hostname,y=new Map,m=new Map,ce=document.getElementById("session-list"),O=document.getElementById("empty-state"),ie=document.getElementById("session-count"),W=document.getElementById("status-dot");let M=null;function x(){ne(),document.removeEventListener("click",x),document.removeEventListener("touchstart",x)}document.addEventListener("click",x);document.addEventListener("touchstart",x);function S(e){d&&d.readyState===WebSocket.OPEN&&d.send(JSON.stringify(e))}const re={onOpen(e){const t=y.get(e.id)||e;t.status==="attention"&&(S({type:"clear-attention",sessionId:t.id}),A(t.id));const n=window.location.href,o=`http://${Y}:${t.port}?token=${t.token}&hub=${encodeURIComponent(n)}`;window.open(o,"_blank")},onStop(e){S({type:"stop-session",sessionId:e})},onRename(e,t){S({type:"rename-session",sessionId:e,name:t})},onInfo(e){S({type:"get-metadata",sessionId:e})}};function j(){const e=y.size;ie.textContent=`${e} session${e!==1?"s":""}`,e===0?O.style.display="flex":O.style.display="none"}function F(e){y.set(e.id,e);const t=H(e,Y,re);m.set(e.id,t),ce.insertBefore(t,O),j()}function K(e){y.delete(e);const t=m.get(e);t&&(t.remove(),m.delete(e)),j()}function de(e){y.set(e.id,e);const t=m.get(e.id);t&&G(t,e)}function le(){for(const[e,t]of y){const n=m.get(e);n&&G(n,t)}}let d=null,L=0;const me=1e4;function T(){d=new WebSocket(se),d.onopen=()=>{W.className="connected",L=0,M&&clearInterval(M),M=setInterval(le,1e4)},d.onmessage=e=>{try{const t=JSON.parse(e.data);switch(t.type){case"sessions":{V();for(const n of m.keys())K(n);for(const n of t.sessions)F(n),n.status==="attention"&&_(n.id);break}case"session-added":{F(t.session);break}case"session-removed":{const n=t.sessionId;A(n),K(n);break}case"session-updated":{const n=t.session;de(n),n.status==="attention"?_(n.id):A(n.id);break}case"preview":{const n=m.get(t.sessionId);n&&ee(n,t.lines);break}case"metadata":{const n=m.get(t.sessionId);n&&te(n,t.metadata);break}case"operation-error":{console.warn(`Operation "${t.operation}" failed for session ${t.sessionId}: ${t.error}`);break}}}catch{}},d.onclose=()=>{W.className="reconnecting",V(),ue()},d.onerror=()=>{d?.close()}}function ue(){const e=Math.min(1e3*Math.pow(1.5,L),me);L++,setTimeout(T,e)}document.addEventListener("visibilitychange",()=>{document.visibilityState==="visible"&&d?.readyState!==WebSocket.OPEN&&(L=0,T())});T();

package/dist/hub/dashboard/assets/index-Erqx_a0N.css

@@ -0,0 +1 @@
+*{margin:0;padding:0;box-sizing:border-box}html,body{height:100%;width:100%;background:#1a1a2e;font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,sans-serif;color:#e0e0e0;overflow-x:hidden;-webkit-overflow-scrolling:touch}#header{display:flex;align-items:center;justify-content:space-between;padding:12px 16px;background:#16213e;border-bottom:1px solid #0f3460;position:sticky;top:0;z-index:10}.header-left{display:flex;align-items:center;gap:10px}.logo{font-size:16px;font-weight:700;color:#e94560;letter-spacing:-.5px}#status-dot{width:8px;height:8px;border-radius:50%;background:#e74c3c;transition:background .3s ease}#status-dot.connected{background:#2ecc71}#status-dot.reconnecting{background:#f39c12;animation:pulse 1s infinite}#session-count{font-size:13px;color:#a0a0b0}#session-list{padding:12px 12px 80px;display:flex;flex-direction:column;gap:12px}#empty-state{display:flex;flex-direction:column;align-items:center;justify-content:center;min-height:60vh;color:#606080;text-align:center;gap:8px}#empty-state .empty-icon{font-size:48px;margin-bottom:8px;opacity:.5}#empty-state p{font-size:16px}#empty-state .empty-hint{font-size:13px;color:#505070}#empty-state code{background:#252540;padding:2px 8px;border-radius:4px;font-family:Cascadia Code,Fira Code,JetBrains Mono,monospace;font-size:12px;color:#e94560}.session-card{background:#16213e;border:1px solid #0f3460;border-radius:12px;padding:14px 16px;cursor:pointer;transition:transform .15s ease,border-color .2s ease;-webkit-tap-highlight-color:transparent}.session-card:active{transform:scale(.98)}.session-card:hover{border-color:#e94560}.session-card.attention{border-color:#e94560;animation:attention-glow 2s ease-in-out infinite}@keyframes attention-glow{0%,to{box-shadow:0 0 #e9456000}50%{box-shadow:0 0 12px 2px #e945604d}}.card-header{display:flex;align-items:center;justify-content:space-between;margin-bottom:8px}.card-agent{display:flex;align-items:center;gap:8px}.agent-dot{width:10px;height:10px;border-radius:50%;flex-shrink:0}.agent-dot.active{background:#2ecc71}.agent-dot.idle{background:#f39c12}.agent-dot.attention{background:#e94560;animation:pulse 1s infinite}.agent-name{font-size:15px;font-weight:600;color:#f0f0f0}.card-uptime{font-size:12px;color:#707090;font-variant-numeric:tabular-nums}.card-cwd{font-size:12px;color:#808098;margin-bottom:10px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;font-family:Cascadia Code,Fira Code,JetBrains Mono,monospace}.card-preview{background:#112;border-radius:6px;padding:8px 10px;margin-bottom:10px;overflow:hidden;min-height:24px;max-height:90px}.card-preview-text{font-family:Cascadia Code,Fira Code,JetBrains Mono,monospace;font-size:11px;line-height:1.4;color:#a0a0b0;white-space:pre;overflow:hidden;text-overflow:ellipsis;margin:0}.card-preview-text.empty{color:#505070;font-style:italic}.card-status{display:flex;align-items:center;gap:6px;font-size:12px;color:#a0a0b0}.status-badge{padding:2px 8px;border-radius:10px;font-size:11px;font-weight:500;text-transform:uppercase;letter-spacing:.5px}.status-badge.active{background:#2ecc7126;color:#2ecc71}.status-badge.idle{background:#f39c1226;color:#f39c12}.status-badge.attention{background:#e9456026;color:#e94560}.attention-badge{padding:2px 8px;border-radius:10px;font-size:11px;font-weight:600;background:#e9456033;color:#e94560;animation:attention-pulse 2s ease-in-out infinite}@keyframes attention-pulse{0%,to{opacity:1}50%{opacity:.6}}.card-actions{display:flex;gap:6px;margin-top:10px;padding-top:10px;border-top:1px solid #0f3460}.action-btn{flex:1;padding:6px 0;border:1px solid #2a2a44;border-radius:6px;background:#1e1e36;color:#a0a0b0;font-size:12px;font-weight:500;font-family:inherit;cursor:pointer;-webkit-tap-highlight-color:transparent;transition:background .15s,color .15s}.action-btn:active{background:#2a2a44}.action-btn.open{color:#2ecc71;border-color:#2ecc714d}.action-btn.stop{color:#e94560;border-color:#e945604d}.action-btn.stop:active{background:#e9456026}.confirm-overlay{display:flex;align-items:center;justify-content:center;gap:10px;padding:10px;margin-top:8px;background:#2d1810;border:1px solid #e94560;border-radius:8px;animation:fadeIn .15s ease}.confirm-msg{font-size:13px;color:#f0f0f0;flex:1}.confirm-btn{padding:5px 14px;border:none;border-radius:5px;font-size:12px;font-weight:600;font-family:inherit;cursor:pointer}.confirm-btn.yes{background:#e94560;color:#fff}.confirm-btn.no{background:#2a2a44;color:#a0a0b0}.rename-input{background:#112;border:1px solid #e94560;border-radius:4px;color:#f0f0f0;font-size:15px;font-weight:600;font-family:inherit;padding:2px 6px;outline:none;width:120px}.card-metadata{margin-top:8px;padding:8px 10px;background:#112;border-radius:6px;animation:fadeIn .2s ease}.card-metadata.hidden{display:none}.meta-row{display:flex;justify-content:space-between;padding:3px 0;font-size:11px}.meta-label{color:#707090;font-weight:500}.meta-value{color:#c0c0d0;font-family:Cascadia Code,Fira Code,JetBrains Mono,monospace;font-size:11px;text-align:right;max-width:200px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}@media(min-width:768px){#session-list{max-width:600px;margin:0 auto}}@keyframes pulse{0%,to{opacity:1}50%{opacity:.4}}@keyframes fadeIn{0%{opacity:0;transform:translateY(8px)}to{opacity:1;transform:translateY(0)}}.session-card{animation:fadeIn .3s ease}#reconnect-overlay{position:fixed;top:0;left:0;width:100%;height:100%;background:#1a1a2ef2;display:flex;flex-direction:column;align-items:center;justify-content:center;z-index:100;color:#e0e0e0;font-size:16px;gap:12px}#reconnect-overlay .spinner{width:32px;height:32px;border:3px solid #0f3460;border-top-color:#e94560;border-radius:50%;animation:spin .8s linear infinite}@keyframes spin{to{transform:rotate(360deg)}}

package/dist/hub/dashboard/index.html

@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover, user-scalable=no" />
+  <meta name="apple-mobile-web-app-capable" content="yes" />
+  <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
+  <meta name="theme-color" content="#1a1a2e" />
+  <title>itwillsync Dashboard</title>
+  <script type="module" crossorigin src="/assets/index-DgUZUPW_.js"></script>
+  <link rel="stylesheet" crossorigin href="/assets/index-Erqx_a0N.css">
+</head>
+<body>
+  <header id="header">
+    <div class="header-left">
+      <span class="logo">itwillsync</span>
+      <span id="status-dot"></span>
+    </div>
+    <span id="session-count">0 sessions</span>
+  </header>
+
+  <main id="session-list">
+    <div id="empty-state">
+      <div class="empty-icon">&#x1F4BB;</div>
+      <p>No active sessions</p>
+      <p class="empty-hint">Start an agent with <code>itwillsync -- claude</code></p>
+    </div>
+  </main>
+
+</body>
+</html>

package/dist/index.js

@@ -2766,7 +2766,7 @@ var require_websocket = __commonJS({
       }
       const defaultPort = isSecure ? 443 : 80;
       const key = randomBytes2(16).toString("base64");
-      const request = isSecure ? https.request : http.request;
+      const request2 = isSecure ? https.request : http.request;
       const protocolSet = /* @__PURE__ */ new Set();
       let perMessageDeflate;
       opts.createConnection = opts.createConnection || (isSecure ? tlsConnect : netConnect);
@@ -2843,12 +2843,12 @@ var require_websocket = __commonJS({
         if (opts.auth && !options.headers.authorization) {
           options.headers.authorization = "Basic " + Buffer.from(opts.auth).toString("base64");
         }
-        req = websocket._req = request(opts);
+        req = websocket._req = request2(opts);
         if (websocket._redirects) {
           websocket.emit("redirect", websocket.url, req);
         }
       } else {
-        req = websocket._req = request(opts);
+        req = websocket._req = request2(opts);
       }
       if (opts.timeout) {
         req.on("timeout", () => {
@@ -3933,6 +3933,7 @@ function createSyncServer(options) {
   const clients = /* @__PURE__ */ new Set();
   const aliveMap = /* @__PURE__ */ new WeakMap();
   let scrollbackBuffer = "";
+  let seq = 0;
   const httpServer = createServer2(async (req, res) => {
     const url = new URL(req.url || "/", `http://${req.headers.host}`);
     let pathname = url.pathname;
@@ -3969,7 +3970,7 @@ function createSyncServer(options) {
     clients.add(ws);
     aliveMap.set(ws, true);
     if (scrollbackBuffer.length > 0) {
-      ws.send(scrollbackBuffer);
+      ws.send(JSON.stringify({ type: "data", data: scrollbackBuffer, seq }));
     }
     ws.on("pong", () => {
       aliveMap.set(ws, true);
@@ -3981,6 +3982,12 @@ function createSyncServer(options) {
           ptyManager.write(message.data);
         } else if (message.type === "resize" && typeof message.cols === "number" && typeof message.rows === "number") {
           ptyManager.resize(message.cols, message.rows);
+        } else if (message.type === "resume" && typeof message.lastSeq === "number") {
+          const missed = seq - message.lastSeq;
+          if (missed > 0 && scrollbackBuffer.length > 0) {
+            const delta = missed <= scrollbackBuffer.length ? scrollbackBuffer.slice(-missed) : scrollbackBuffer;
+            ws.send(JSON.stringify({ type: "data", data: delta, seq }));
+          }
         }
       } catch {
       }
@@ -3993,13 +4000,15 @@ function createSyncServer(options) {
     });
   });
   ptyManager.onData((data) => {
+    seq += data.length;
     scrollbackBuffer += data;
     if (scrollbackBuffer.length > SCROLLBACK_BUFFER_SIZE) {
       scrollbackBuffer = scrollbackBuffer.slice(-SCROLLBACK_BUFFER_SIZE);
     }
+    const msg = JSON.stringify({ type: "data", data, seq });
     for (const client of clients) {
       if (client.readyState === client.OPEN) {
-        client.send(data);
+        client.send(msg);
       }
     }
   });
@@ -4140,8 +4149,233 @@ async function runSetupWizard() {
   return config;
 }
 
+// src/hub-client.ts
+import { spawn as spawn2 } from "child_process";
+import { readFileSync as readFileSync2, existsSync as existsSync2 } from "fs";
+import { homedir as homedir2 } from "os";
+import { join as join4, dirname as dirname2 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import { request } from "http";
+var HUB_INTERNAL_PORT = 7963;
+var HUB_EXTERNAL_PORT = 7962;
+var SESSION_PORT_START = 7964;
+function getHubDir() {
+  return process.env.ITWILLSYNC_CONFIG_DIR || join4(homedir2(), ".itwillsync");
+}
+function getHubConfigPath() {
+  return join4(getHubDir(), "hub.json");
+}
+async function discoverHub() {
+  return new Promise((resolve) => {
+    const req = request(
+      {
+        hostname: "127.0.0.1",
+        port: HUB_INTERNAL_PORT,
+        path: "/api/health",
+        method: "GET",
+        timeout: 2e3
+      },
+      (res) => {
+        let data = "";
+        res.on("data", (chunk) => {
+          data += chunk;
+        });
+        res.on("end", () => {
+          try {
+            const json = JSON.parse(data);
+            resolve(json.status === "ok");
+          } catch {
+            resolve(false);
+          }
+        });
+      }
+    );
+    req.on("error", () => resolve(false));
+    req.on("timeout", () => {
+      req.destroy();
+      resolve(false);
+    });
+    req.end();
+  });
+}
+async function spawnHub() {
+  const __dirname = dirname2(fileURLToPath2(import.meta.url));
+  const hubPath = join4(__dirname, "hub", "daemon.js");
+  return new Promise((resolve, reject) => {
+    const child = spawn2("node", [hubPath], {
+      detached: true,
+      stdio: ["ignore", "pipe", "ignore"],
+      env: {
+        ...process.env,
+        // Pass config dir to hub
+        ITWILLSYNC_CONFIG_DIR: process.env.ITWILLSYNC_CONFIG_DIR || ""
+      }
+    });
+    child.unref();
+    let output = "";
+    const timeout = setTimeout(() => {
+      reject(new Error("Hub daemon startup timed out"));
+    }, 1e4);
+    child.stdout?.on("data", (data) => {
+      output += data.toString();
+      if (output.includes("hub:ready:")) {
+        clearTimeout(timeout);
+        child.stdout?.destroy();
+        resolve();
+      }
+    });
+    child.on("error", (err) => {
+      clearTimeout(timeout);
+      reject(new Error(`Failed to spawn hub daemon: ${err.message}`));
+    });
+    child.on("exit", (code) => {
+      clearTimeout(timeout);
+      if (code !== null && code !== 0) {
+        reject(new Error(`Hub daemon exited with code ${code}`));
+      }
+    });
+  });
+}
+function getHubConfig() {
+  const configPath = getHubConfigPath();
+  if (!existsSync2(configPath)) {
+    return null;
+  }
+  try {
+    const raw = readFileSync2(configPath, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+async function registerSession(registration) {
+  const body = JSON.stringify(registration);
+  return new Promise((resolve, reject) => {
+    const req = request(
+      {
+        hostname: "127.0.0.1",
+        port: HUB_INTERNAL_PORT,
+        path: "/api/sessions",
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Content-Length": Buffer.byteLength(body)
+        },
+        timeout: 5e3
+      },
+      (res) => {
+        let data = "";
+        res.on("data", (chunk) => {
+          data += chunk;
+        });
+        res.on("end", () => {
+          try {
+            const json = JSON.parse(data);
+            if (res.statusCode === 201 && json.session) {
+              resolve(json.session);
+            } else {
+              reject(new Error(`Registration failed: ${json.error || "Unknown error"}`));
+            }
+          } catch {
+            reject(new Error("Invalid response from hub"));
+          }
+        });
+      }
+    );
+    req.on("error", (err) => reject(new Error(`Failed to register with hub: ${err.message}`)));
+    req.on("timeout", () => {
+      req.destroy();
+      reject(new Error("Registration request timed out"));
+    });
+    req.end(body);
+  });
+}
+async function unregisterSession(sessionId) {
+  return new Promise((resolve) => {
+    const req = request(
+      {
+        hostname: "127.0.0.1",
+        port: HUB_INTERNAL_PORT,
+        path: `/api/sessions/${sessionId}`,
+        method: "DELETE",
+        timeout: 3e3
+      },
+      () => resolve()
+    );
+    req.on("error", () => resolve());
+    req.on("timeout", () => {
+      req.destroy();
+      resolve();
+    });
+    req.end();
+  });
+}
+async function listSessions() {
+  return new Promise((resolve) => {
+    const req = request(
+      {
+        hostname: "127.0.0.1",
+        port: HUB_INTERNAL_PORT,
+        path: "/api/sessions",
+        method: "GET",
+        timeout: 3e3
+      },
+      (res) => {
+        let data = "";
+        res.on("data", (chunk) => {
+          data += chunk;
+        });
+        res.on("end", () => {
+          try {
+            const json = JSON.parse(data);
+            resolve(json.sessions || []);
+          } catch {
+            resolve([]);
+          }
+        });
+      }
+    );
+    req.on("error", () => resolve([]));
+    req.on("timeout", () => {
+      req.destroy();
+      resolve([]);
+    });
+    req.end();
+  });
+}
+function stopHub() {
+  const config = getHubConfig();
+  if (!config) return false;
+  try {
+    process.kill(config.pid, "SIGTERM");
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function sendHeartbeat(sessionId) {
+  return new Promise((resolve) => {
+    const req = request(
+      {
+        hostname: "127.0.0.1",
+        port: HUB_INTERNAL_PORT,
+        path: `/api/sessions/${sessionId}/heartbeat`,
+        method: "PUT",
+        timeout: 2e3
+      },
+      () => resolve()
+    );
+    req.on("error", () => resolve());
+    req.on("timeout", () => {
+      req.destroy();
+      resolve();
+    });
+    req.end();
+  });
+}
+
 // src/cli-options.ts
-var DEFAULT_PORT = 3456;
+var DEFAULT_PORT = SESSION_PORT_START;
 function parseArgs(argv) {
   const options = {
     port: DEFAULT_PORT,
@@ -4150,13 +4384,24 @@ function parseArgs(argv) {
     command: [],
     subcommand: null,
     tailscale: false,
-    local: false
+    local: false,
+    hubInfo: false,
+    hubStop: false,
+    hubStatus: false
   };
   const args = argv.slice(2);
   if (args.length > 0 && args[0] === "setup") {
     options.subcommand = "setup";
     return options;
   }
+  if (args.length > 0 && args[0] === "hub") {
+    const hubAction = args[1] || "info";
+    if (hubAction === "info") options.hubInfo = true;
+    else if (hubAction === "stop") options.hubStop = true;
+    else if (hubAction === "status") options.hubStatus = true;
+    else options.hubInfo = true;
+    return options;
+  }
   let i = 0;
   while (i < args.length) {
     const arg = args[i];
@@ -4178,6 +4423,15 @@ function parseArgs(argv) {
     } else if (arg === "--no-qr") {
       options.noQr = true;
       i++;
+    } else if (arg === "--hub-info") {
+      options.hubInfo = true;
+      i++;
+    } else if (arg === "--hub-stop") {
+      options.hubStop = true;
+      i++;
+    } else if (arg === "--hub-status") {
+      options.hubStatus = true;
+      i++;
     } else if (arg === "--help" || arg === "-h") {
       printHelp();
       process.exit(0);
@@ -4199,6 +4453,7 @@ Usage:
   itwillsync [options] -- <command> [args...]
   itwillsync [options] <command> [args...]
   itwillsync setup
+  itwillsync hub [info|stop|status]
 
 Examples:
   itwillsync -- claude
@@ -4207,9 +4462,14 @@ Examples:
   itwillsync --port 8080 -- claude
   itwillsync --tailscale -- claude
   itwillsync setup
+  itwillsync hub info
+  itwillsync hub stop
 
 Commands:
   setup              Run the setup wizard (configure networking mode)
+  hub info           Show dashboard URL, QR code, and hub status
+  hub stop           Stop the hub daemon and all sessions
+  hub status         List all active sessions
 
 Options:
   --port <number>    Port to listen on (default: ${DEFAULT_PORT})
@@ -4219,24 +4479,29 @@ Options:
   --no-qr            Don't display QR code
   -h, --help         Show this help
   -v, --version      Show version
+
+Hub Management:
+  --hub-info         Show dashboard URL, QR code, and hub status
+  --hub-stop         Stop the hub daemon and all sessions
+  --hub-status       List all active sessions
 `);
 }
 
 // src/index.ts
-import { fileURLToPath as fileURLToPath2 } from "url";
-import { join as join4, dirname as dirname2 } from "path";
-import { spawn as spawn2 } from "child_process";
+import { fileURLToPath as fileURLToPath3 } from "url";
+import { join as join5, dirname as dirname3 } from "path";
+import { spawn as spawn3 } from "child_process";
 function preventSleep() {
   try {
     if (process.platform === "darwin") {
-      const child = spawn2("caffeinate", ["-i", "-w", String(process.pid)], {
+      const child = spawn3("caffeinate", ["-i", "-w", String(process.pid)], {
         stdio: "ignore",
         detached: true
       });
       child.unref();
       return child;
     } else if (process.platform === "linux") {
-      return spawn2("systemd-inhibit", [
+      return spawn3("systemd-inhibit", [
         "--what=idle",
         "--who=itwillsync",
         "--why=Terminal sync session active",
@@ -4248,12 +4513,96 @@ function preventSleep() {
   }
   return null;
 }
+async function ensureHub() {
+  const hubRunning = await discoverHub();
+  if (hubRunning) {
+    return false;
+  }
+  try {
+    await spawnHub();
+    await new Promise((resolve) => setTimeout(resolve, 500));
+    return true;
+  } catch (err) {
+    console.warn(`
+  Warning: Could not start hub daemon: ${err.message}`);
+    console.warn("  Running in standalone mode (no dashboard).\n");
+    return true;
+  }
+}
+async function handleHubCommand(options) {
+  const hubConfig = getHubConfig();
+  const hubRunning = await discoverHub();
+  if (options.hubStop) {
+    if (!hubRunning || !hubConfig) {
+      console.log("\n  No hub daemon is running.\n");
+      return;
+    }
+    const stopped = stopHub();
+    if (stopped) {
+      console.log("\n  Hub daemon stopped.\n");
+    } else {
+      console.log("\n  Failed to stop hub daemon.\n");
+    }
+    return;
+  }
+  if (options.hubStatus) {
+    if (!hubRunning) {
+      console.log("\n  No hub daemon is running.\n");
+      return;
+    }
+    const sessions = await listSessions();
+    console.log(`
+  Hub is running. ${sessions.length} active session(s).
+`);
+    if (sessions.length > 0) {
+      for (const s of sessions) {
+        const uptime = Math.floor((Date.now() - s.connectedAt) / 6e4);
+        console.log(`    ${s.name || s.agent}  (${s.status}, ${uptime}m, port ${s.port})`);
+      }
+      console.log("");
+    }
+    return;
+  }
+  if (options.hubInfo) {
+    if (!hubRunning || !hubConfig) {
+      console.log("\n  No hub daemon is running.");
+      console.log("  Start a session with: itwillsync -- <agent>\n");
+      return;
+    }
+    let networkingMode = "local";
+    if (options.tailscale) {
+      networkingMode = "tailscale";
+    } else if (options.local) {
+      networkingMode = "local";
+    } else if (configExists()) {
+      networkingMode = loadConfig().networkingMode;
+    }
+    const ip = await resolveSessionIP(networkingMode, false);
+    const dashboardUrl = `http://${ip}:${HUB_EXTERNAL_PORT}?token=${hubConfig.masterToken}`;
+    displayQR(dashboardUrl);
+    console.log(`  Dashboard: ${dashboardUrl}`);
+    const sessions = await listSessions();
+    console.log(`  Sessions: ${sessions.length} active`);
+    if (sessions.length > 0) {
+      for (const s of sessions) {
+        const uptime = Math.floor((Date.now() - s.connectedAt) / 6e4);
+        console.log(`    ${s.name || s.agent}  (${s.status}, ${uptime}m)`);
+      }
+    }
+    console.log("");
+    return;
+  }
+}
 async function main() {
   const options = parseArgs(process.argv);
   if (options.subcommand === "setup") {
     await runSetupWizard();
     return;
   }
+  if (options.hubInfo || options.hubStop || options.hubStatus) {
+    await handleHubCommand(options);
+    return;
+  }
   if (options.tailscale && options.local) {
     console.error("Error: Cannot use both --tailscale and --local.\n");
     process.exit(1);
@@ -4276,13 +4625,14 @@ async function main() {
     networkingMode = config.networkingMode;
   }
   const [cmd, ...cmdArgs] = options.command;
+  const isFirstSession = await ensureHub();
+  const hubConfig = getHubConfig();
   const token = generateToken();
   const port = await findAvailablePort(options.port);
   const host = options.localhost ? "127.0.0.1" : "0.0.0.0";
   const ip = await resolveSessionIP(networkingMode, options.localhost);
-  const url = `http://${ip}:${port}?token=${token}`;
-  const __dirname = dirname2(fileURLToPath2(import.meta.url));
-  const webClientPath = join4(__dirname, "web-client");
+  const __dirname = dirname3(fileURLToPath3(import.meta.url));
+  const webClientPath = join5(__dirname, "web-client");
   const ptyManager = new PtyManager(cmd, cmdArgs);
   const server = createSyncServer({
     ptyManager,
@@ -4291,12 +4641,42 @@ async function main() {
     host,
     port
   });
-  if (!options.noQr) {
-    displayQR(url);
-  } else {
+  let registeredSession = null;
+  let heartbeatInterval = null;
+  if (hubConfig) {
+    try {
+      registeredSession = await registerSession({
+        name: cmd,
+        port,
+        token,
+        agent: cmd,
+        cwd: process.cwd(),
+        pid: ptyManager.pid
+      });
+      heartbeatInterval = setInterval(() => {
+        if (registeredSession) {
+          sendHeartbeat(registeredSession.id);
+        }
+      }, 1e4);
+    } catch (err) {
+      console.warn(`  Warning: Failed to register with hub: ${err.message}`);
+    }
+  }
+  const dashboardUrl = hubConfig ? `http://${ip}:${HUB_EXTERNAL_PORT}?token=${hubConfig.masterToken}` : null;
+  if (isFirstSession && dashboardUrl && !options.noQr) {
+    displayQR(dashboardUrl);
+    console.log(`  Dashboard: ${dashboardUrl}`);
+  } else if (isFirstSession && !options.noQr) {
+    const directUrl = `http://${ip}:${port}?token=${token}`;
+    displayQR(directUrl);
+  } else if (dashboardUrl) {
     console.log(`
-  Connect at: ${url}
-`);
+  Session "${cmd}" registered with hub.`);
+    console.log(`  Dashboard: ${dashboardUrl}`);
+    console.log("");
+  } else if (!options.noQr) {
+    const directUrl = `http://${ip}:${port}?token=${token}`;
+    displayQR(directUrl);
   }
   const sleepGuard = preventSleep();
   console.log(`  Server listening on ${host}:${port}`);
@@ -4322,26 +4702,32 @@ async function main() {
   }
   process.stdout.on("resize", handleResize);
   handleResize();
-  function cleanup() {
+  async function cleanup() {
     if (process.stdin.isTTY) {
       process.stdin.setRawMode(false);
     }
+    if (heartbeatInterval) {
+      clearInterval(heartbeatInterval);
+    }
+    if (registeredSession) {
+      await unregisterSession(registeredSession.id);
+    }
     sleepGuard?.kill();
     server.close();
     ptyManager.kill();
   }
-  ptyManager.onExit((exitCode) => {
+  ptyManager.onExit(async (exitCode) => {
     console.log(`
   Agent exited with code ${exitCode}`);
-    cleanup();
+    await cleanup();
     process.exit(exitCode);
   });
-  process.on("SIGINT", () => {
-    cleanup();
+  process.on("SIGINT", async () => {
+    await cleanup();
     process.exit(0);
   });
-  process.on("SIGTERM", () => {
-    cleanup();
+  process.on("SIGTERM", async () => {
+    await cleanup();
     process.exit(0);
   });
 }