loopable-cli 0.2.0 → 0.2.1

package/.output/server/index.mjs

@@ -14,252 +14,259 @@ var public_assets_data_default = {
 	"/apple-touch-icon.png": {
 		"type": "image/png",
 		"etag": "\"6e2-DpcPkINR92ffme+04R4KBRmf4jE\"",
-		"mtime": "2026-09-18T01:57:05.242Z",
+		"mtime": "2026-09-18T06:00:41.671Z",
 		"size": 1762,
 		"path": "../public/apple-touch-icon.png"
 	},
 	"/favicon.svg": {
 		"type": "image/svg+xml",
 		"etag": "\"1b3-uNgdb2Q4nmFEpsmW/cpMJbfKeng\"",
-		"mtime": "2026-09-18T01:57:05.242Z",
+		"mtime": "2026-09-18T06:00:41.671Z",
 		"size": 435,
 		"path": "../public/favicon.svg"
 	},
-	"/assets/_taskId-eCKkcVOx.js": {
+	"/assets/_connectorId-CkygNLny.js": {
 		"type": "text/javascript; charset=utf-8",
-		"etag": "\"19fb-Z2KGDYJ6HLgyI9vP4IN5y+LPE0I\"",
-		"mtime": "2026-09-18T01:57:04.912Z",
-		"size": 6651,
-		"path": "../public/assets/_taskId-eCKkcVOx.js"
-	},
-	"/assets/_connectorId-m67WbiJ8.js": {
-		"type": "text/javascript; charset=utf-8",
-		"etag": "\"3038-B0yGvA3w6xDB3cBG5OwpqN6owIE\"",
-		"mtime": "2026-09-18T01:57:04.911Z",
-		"size": 12344,
-		"path": "../public/assets/_connectorId-m67WbiJ8.js"
+		"etag": "\"352c-zFynWi8xF9nWUk+DQMFFE4tIwr0\"",
+		"mtime": "2026-09-18T06:00:41.319Z",
+		"size": 13612,
+		"path": "../public/assets/_connectorId-CkygNLny.js"
 	},
 	"/assets/alert-BT2EVMJP.js": {
 		"type": "text/javascript; charset=utf-8",
 		"etag": "\"518-O5UdHKN5UMK7ObJJfTGdkF6Ce2Y\"",
-		"mtime": "2026-09-18T01:57:04.912Z",
+		"mtime": "2026-09-18T06:00:41.320Z",
 		"size": 1304,
 		"path": "../public/assets/alert-BT2EVMJP.js"
 	},
 	"/assets/arrow-left-CWUZt6k2.js": {
 		"type": "text/javascript; charset=utf-8",
 		"etag": "\"a3-m5hDdztvA9zAbs7sHlKigsZ1zhI\"",
-		"mtime": "2026-09-18T01:57:04.912Z",
+		"mtime": "2026-09-18T06:00:41.320Z",
 		"size": 163,
 		"path": "../public/assets/arrow-left-CWUZt6k2.js"
 	},
-	"/assets/arrow-right-dy_oOg_c.js": {
+	"/assets/_loopId-Cshlc5Ja.js": {
 		"type": "text/javascript; charset=utf-8",
-		"etag": "\"a3-7KoKsSsK6/3kMyHB+xQq/+3ZuYI\"",
-		"mtime": "2026-09-18T01:57:04.912Z",
-		"size": 163,
-		"path": "../public/assets/arrow-right-dy_oOg_c.js"
+		"etag": "\"4c7f-vl0h8RZxNI2m547/Ul6ryBDNvnw\"",
+		"mtime": "2026-09-18T06:00:41.319Z",
+		"size": 19583,
+		"path": "../public/assets/_loopId-Cshlc5Ja.js"
+	},
+	"/assets/_taskId-BKDIJ_Fg.js": {
+		"type": "text/javascript; charset=utf-8",
+		"etag": "\"19f6-bk4pwe6A6IGpoc9WlvluE3UtWEE\"",
+		"mtime": "2026-09-18T06:00:41.319Z",
+		"size": 6646,
+		"path": "../public/assets/_taskId-BKDIJ_Fg.js"
 	},
 	"/assets/connection-status-DCqqmY_6.js": {
 		"type": "text/javascript; charset=utf-8",
 		"etag": "\"17c-sqOdQ5h8t+NrtNGo4gNUn47RJ5U\"",
-		"mtime": "2026-09-18T01:57:04.912Z",
+		"mtime": "2026-09-18T06:00:41.320Z",
 		"size": 380,
 		"path": "../public/assets/connection-status-DCqqmY_6.js"
 	},
-	"/assets/_loopId-Bf4K5sdd.js": {
+	"/assets/arrow-right-dy_oOg_c.js": {
 		"type": "text/javascript; charset=utf-8",
-		"etag": "\"49d5-LFWuAYujZPtlfin5QFhXi9wzM6U\"",
-		"mtime": "2026-09-18T01:57:04.912Z",
-		"size": 18901,
-		"path": "../public/assets/_loopId-Bf4K5sdd.js"
+		"etag": "\"a3-7KoKsSsK6/3kMyHB+xQq/+3ZuYI\"",
+		"mtime": "2026-09-18T06:00:41.320Z",
+		"size": 163,
+		"path": "../public/assets/arrow-right-dy_oOg_c.js"
 	},
-	"/assets/external-link-DC11orFA.js": {
+	"/assets/connector-icon-BUoK6Cru.js": {
 		"type": "text/javascript; charset=utf-8",
-		"etag": "\"f9-Hk5Mt6w6TLri3QHcB8yNexVi7wU\"",
-		"mtime": "2026-09-18T01:57:04.912Z",
-		"size": 249,
-		"path": "../public/assets/external-link-DC11orFA.js"
+		"etag": "\"266c-r9XAEg0at7HpSKzgEFAqgNewEJw\"",
+		"mtime": "2026-09-18T06:00:41.320Z",
+		"size": 9836,
+		"path": "../public/assets/connector-icon-BUoK6Cru.js"
 	},
-	"/assets/connector-icon-qGpNsPgH.js": {
+	"/assets/connectors-CeLBtEtg.js": {
 		"type": "text/javascript; charset=utf-8",
-		"etag": "\"a36-Rylw68kFhEusDW1xHh1q7BKNQnM\"",
-		"mtime": "2026-09-18T01:57:04.912Z",
-		"size": 2614,
-		"path": "../public/assets/connector-icon-qGpNsPgH.js"
+		"etag": "\"954-fD1AFysaAcDpkRyyJo+exIQCOtI\"",
+		"mtime": "2026-09-18T06:00:41.320Z",
+		"size": 2388,
+		"path": "../public/assets/connectors-CeLBtEtg.js"
 	},
-	"/assets/connectors-DxXlc9zF.js": {
+	"/assets/gaps-BtFoD7mF.js": {
 		"type": "text/javascript; charset=utf-8",
-		"etag": "\"94c-zF7UvjbwGoHBqmurc1jz9vIUIGc\"",
-		"mtime": "2026-09-18T01:57:04.912Z",
-		"size": 2380,
-		"path": "../public/assets/connectors-DxXlc9zF.js"
+		"etag": "\"5ad-2XESYTVUINlJ6ulDlIg9Jz2qx40\"",
+		"mtime": "2026-09-18T06:00:41.320Z",
+		"size": 1453,
+		"path": "../public/assets/gaps-BtFoD7mF.js"
 	},
-	"/assets/gaps-CoTA-PzA.js": {
+	"/assets/external-link-DC11orFA.js": {
 		"type": "text/javascript; charset=utf-8",
-		"etag": "\"5ac-iGQjB0QT5cfADx9ohYAGXEOQk2c\"",
-		"mtime": "2026-09-18T01:57:04.912Z",
-		"size": 1452,
-		"path": "../public/assets/gaps-CoTA-PzA.js"
+		"etag": "\"f9-Hk5Mt6w6TLri3QHcB8yNexVi7wU\"",
+		"mtime": "2026-09-18T06:00:41.320Z",
+		"size": 249,
+		"path": "../public/assets/external-link-DC11orFA.js"
+	},
+	"/assets/geist-cyrillic-wght-normal-BEAKL7Jp.woff2": {
+		"type": "font/woff2",
+		"etag": "\"3aec-5kpQSZEtAzzU5kdiuro3Zr2YR54\"",
+		"mtime": "2026-09-18T06:00:41.322Z",
+		"size": 15084,
+		"path": "../public/assets/geist-cyrillic-wght-normal-BEAKL7Jp.woff2"
+	},
+	"/assets/geist-latin-ext-wght-normal-DC-KSUi6.woff2": {
+		"type": "font/woff2",
+		"etag": "\"4080-mZu3Z7sOWqglha+kefNbUA9Pp+Q\"",
+		"mtime": "2026-09-18T06:00:41.322Z",
+		"size": 16512,
+		"path": "../public/assets/geist-latin-ext-wght-normal-DC-KSUi6.woff2"
 	},
 	"/assets/geist-cyrillic-ext-wght-normal-DjL33-gN.woff2": {
 		"type": "font/woff2",
 		"etag": "\"1cfc-yYSDXNlt/tTRaj6rJo8ZMqvY7pQ\"",
-		"mtime": "2026-09-18T01:57:04.913Z",
+		"mtime": "2026-09-18T06:00:41.322Z",
 		"size": 7420,
 		"path": "../public/assets/geist-cyrillic-ext-wght-normal-DjL33-gN.woff2"
 	},
-	"/assets/geist-cyrillic-wght-normal-BEAKL7Jp.woff2": {
+	"/assets/geist-latin-wght-normal-BgDaEnEv.woff2": {
 		"type": "font/woff2",
-		"etag": "\"3aec-5kpQSZEtAzzU5kdiuro3Zr2YR54\"",
-		"mtime": "2026-09-18T01:57:04.913Z",
-		"size": 15084,
-		"path": "../public/assets/geist-cyrillic-wght-normal-BEAKL7Jp.woff2"
+		"etag": "\"72d8-9J+D7/6th5UzRxIgoFX9awJv47A\"",
+		"mtime": "2026-09-18T06:00:41.322Z",
+		"size": 29400,
+		"path": "../public/assets/geist-latin-wght-normal-BgDaEnEv.woff2"
 	},
 	"/assets/geist-vietnamese-wght-normal-6IgcOCM7.woff2": {
 		"type": "font/woff2",
 		"etag": "\"1f44-6MZ7/PEEOeDVF0eHI650KpwKQV8\"",
-		"mtime": "2026-09-18T01:57:04.914Z",
+		"mtime": "2026-09-18T06:00:41.322Z",
 		"size": 8004,
 		"path": "../public/assets/geist-vietnamese-wght-normal-6IgcOCM7.woff2"
 	},
-	"/assets/geist-latin-ext-wght-normal-DC-KSUi6.woff2": {
-		"type": "font/woff2",
-		"etag": "\"4080-mZu3Z7sOWqglha+kefNbUA9Pp+Q\"",
-		"mtime": "2026-09-18T01:57:04.914Z",
-		"size": 16512,
-		"path": "../public/assets/geist-latin-ext-wght-normal-DC-KSUi6.woff2"
+	"/assets/inbox-BYNjkNDJ.js": {
+		"type": "text/javascript; charset=utf-8",
+		"etag": "\"af6-MTB/xkyur8KgiPetiOnxbQbYs6M\"",
+		"mtime": "2026-09-18T06:00:41.320Z",
+		"size": 2806,
+		"path": "../public/assets/inbox-BYNjkNDJ.js"
 	},
 	"/assets/loader-B4Epchm_.js": {
 		"type": "text/javascript; charset=utf-8",
 		"etag": "\"199-3kmluGVUQQj/qxW5n5mcbXA3Z/0\"",
-		"mtime": "2026-09-18T01:57:04.912Z",
+		"mtime": "2026-09-18T06:00:41.320Z",
 		"size": 409,
 		"path": "../public/assets/loader-B4Epchm_.js"
 	},
-	"/assets/loop-form-BvizlZdR.js": {
+	"/assets/loops-1CvbqO6m.js": {
 		"type": "text/javascript; charset=utf-8",
-		"etag": "\"2a3d-th5nQjNmPPTjVpRO45NjOMt9Ctk\"",
-		"mtime": "2026-09-18T01:57:04.912Z",
-		"size": 10813,
-		"path": "../public/assets/loop-form-BvizlZdR.js"
+		"etag": "\"13a7-cm8GZK27hxhqmzsWZMI5QH2US4c\"",
+		"mtime": "2026-09-18T06:00:41.320Z",
+		"size": 5031,
+		"path": "../public/assets/loops-1CvbqO6m.js"
 	},
-	"/assets/inbox-CLEXUXCI.js": {
+	"/assets/index-0yP3Jn_G.js": {
 		"type": "text/javascript; charset=utf-8",
-		"etag": "\"af6-+Y3pLzim7gzbWl3qF1wDqYCvIOI\"",
-		"mtime": "2026-09-18T01:57:04.912Z",
-		"size": 2806,
-		"path": "../public/assets/inbox-CLEXUXCI.js"
+		"etag": "\"50659-m9Q2/jKlnvBcUKitIphuane0WM8\"",
+		"mtime": "2026-09-18T06:00:41.319Z",
+		"size": 329305,
+		"path": "../public/assets/index-0yP3Jn_G.js"
 	},
-	"/assets/geist-latin-wght-normal-BgDaEnEv.woff2": {
-		"type": "font/woff2",
-		"etag": "\"72d8-9J+D7/6th5UzRxIgoFX9awJv47A\"",
-		"mtime": "2026-09-18T01:57:04.914Z",
-		"size": 29400,
-		"path": "../public/assets/geist-latin-wght-normal-BgDaEnEv.woff2"
-	},
-	"/assets/index-Cndsw84p.js": {
-		"type": "text/javascript; charset=utf-8",
-		"etag": "\"4f15c-FwR8sodSOPSkc8JjlnY8zhtEYwg\"",
-		"mtime": "2026-09-18T01:57:04.911Z",
-		"size": 323932,
-		"path": "../public/assets/index-Cndsw84p.js"
-	},
-	"/assets/loops-Dbe_mf5T.js": {
-		"type": "text/javascript; charset=utf-8",
-		"etag": "\"13a2-sLRxrcCS5txEO/d9gR66iYDY9sA\"",
-		"mtime": "2026-09-18T01:57:04.912Z",
-		"size": 5026,
-		"path": "../public/assets/loops-Dbe_mf5T.js"
-	},
-	"/assets/new-DPEaXKAY.js": {
+	"/assets/new-m5NlqYQT.js": {
 		"type": "text/javascript; charset=utf-8",
-		"etag": "\"ca3-E+1vh2N3bwxNaprUu4qe3PpypEo\"",
-		"mtime": "2026-09-18T01:57:04.913Z",
+		"etag": "\"ca3-6Xz/VexiTbfexiPEUQtUJV5c/pc\"",
+		"mtime": "2026-09-18T06:00:41.321Z",
 		"size": 3235,
-		"path": "../public/assets/new-DPEaXKAY.js"
+		"path": "../public/assets/new-m5NlqYQT.js"
 	},
 	"/assets/play-DD4xQgvi.js": {
 		"type": "text/javascript; charset=utf-8",
 		"etag": "\"bc-alsbjWPSyChVi7eXGM6zPUOzF28\"",
-		"mtime": "2026-09-18T01:57:04.913Z",
+		"mtime": "2026-09-18T06:00:41.321Z",
 		"size": 188,
 		"path": "../public/assets/play-DD4xQgvi.js"
 	},
-	"/assets/preload-helper-CfdAYKD7.js": {
+	"/assets/loop-form-DnSJNc1k.js": {
 		"type": "text/javascript; charset=utf-8",
-		"etag": "\"25e66-CtN8yTaaHYxIKlY6y6/HKCvmwm0\"",
-		"mtime": "2026-09-18T01:57:04.913Z",
-		"size": 155238,
-		"path": "../public/assets/preload-helper-CfdAYKD7.js"
+		"etag": "\"2a42-94+05ar0+LKjXi8noetvd0Nurn0\"",
+		"mtime": "2026-09-18T06:00:41.320Z",
+		"size": 10818,
+		"path": "../public/assets/loop-form-DnSJNc1k.js"
+	},
+	"/assets/refresh-cw-C3xBnKfy.js": {
+		"type": "text/javascript; charset=utf-8",
+		"etag": "\"13f-KJk+UjZqybh/n0vhbr9wwM57LJo\"",
+		"mtime": "2026-09-18T06:00:41.321Z",
+		"size": 319,
+		"path": "../public/assets/refresh-cw-C3xBnKfy.js"
 	},
 	"/assets/rolldown-runtime-CbXtAM7H.js": {
 		"type": "text/javascript; charset=utf-8",
 		"etag": "\"24d-+aXgvbJ1Wwcp2A8AXKIBByksYC8\"",
-		"mtime": "2026-09-18T01:57:04.913Z",
+		"mtime": "2026-09-18T06:00:41.321Z",
 		"size": 589,
 		"path": "../public/assets/rolldown-runtime-CbXtAM7H.js"
 	},
-	"/assets/runners-BVBggS5B.js": {
+	"/assets/preload-helper-CfdAYKD7.js": {
 		"type": "text/javascript; charset=utf-8",
-		"etag": "\"af4-SEWDdnE8+QpWfX/ex/tT1I43knY\"",
-		"mtime": "2026-09-18T01:57:04.913Z",
-		"size": 2804,
-		"path": "../public/assets/runners-BVBggS5B.js"
+		"etag": "\"25e66-CtN8yTaaHYxIKlY6y6/HKCvmwm0\"",
+		"mtime": "2026-09-18T06:00:41.321Z",
+		"size": 155238,
+		"path": "../public/assets/preload-helper-CfdAYKD7.js"
 	},
-	"/assets/select-Cppu-hti.js": {
+	"/assets/runners-D8QVl-Y6.js": {
 		"type": "text/javascript; charset=utf-8",
-		"etag": "\"1b2f4-3YBJAy4lzk0epih6EODEaDeMaE4\"",
-		"mtime": "2026-09-18T01:57:04.913Z",
-		"size": 111348,
-		"path": "../public/assets/select-Cppu-hti.js"
+		"etag": "\"af4-OC+GxgY5UDW9zPbdNUX7ntntR4Q\"",
+		"mtime": "2026-09-18T06:00:41.321Z",
+		"size": 2804,
+		"path": "../public/assets/runners-D8QVl-Y6.js"
 	},
-	"/assets/setting-fields-BT1naVJX.js": {
+	"/assets/setting-fields-bJ_gTG7Q.js": {
 		"type": "text/javascript; charset=utf-8",
-		"etag": "\"749-SkARcPuYJEMTjRGzy1jJuljGvtM\"",
-		"mtime": "2026-09-18T01:57:04.913Z",
+		"etag": "\"749-LzR3qNTHmp9E39HhyA1rWQx3gCk\"",
+		"mtime": "2026-09-18T06:00:41.321Z",
 		"size": 1865,
-		"path": "../public/assets/setting-fields-BT1naVJX.js"
-	},
-	"/assets/styles-D3sonCfX.css": {
-		"type": "text/css; charset=utf-8",
-		"etag": "\"14d2a-lZ7x63AXhmJmu8JxOKzNT0a9hrg\"",
-		"mtime": "2026-09-18T01:57:04.914Z",
-		"size": 85290,
-		"path": "../public/assets/styles-D3sonCfX.css"
+		"path": "../public/assets/setting-fields-bJ_gTG7Q.js"
 	},
 	"/assets/switch-hRIbNGOj.js": {
 		"type": "text/javascript; charset=utf-8",
 		"etag": "\"1143-+VR0qSRiJugwgpkRWB7lzVYpJVY\"",
-		"mtime": "2026-09-18T01:57:04.913Z",
+		"mtime": "2026-09-18T06:00:41.321Z",
 		"size": 4419,
 		"path": "../public/assets/switch-hRIbNGOj.js"
 	},
-	"/assets/task-list-CrptnI1N.js": {
+	"/assets/task-list-BAxjcVgr.js": {
 		"type": "text/javascript; charset=utf-8",
-		"etag": "\"1074-SkNQfO3Mw+7OIztA59crAb0hh2o\"",
-		"mtime": "2026-09-18T01:57:04.913Z",
+		"etag": "\"1074-5XugvUBT/qv6nPfGfSQ9Qt/7hGw\"",
+		"mtime": "2026-09-18T06:00:41.321Z",
 		"size": 4212,
-		"path": "../public/assets/task-list-CrptnI1N.js"
+		"path": "../public/assets/task-list-BAxjcVgr.js"
+	},
+	"/assets/styles-ClTGaXU0.css": {
+		"type": "text/css; charset=utf-8",
+		"etag": "\"14da9-b2Qt40ffRWPdYuZrfm/4MJhYLXE\"",
+		"mtime": "2026-09-18T06:00:41.323Z",
+		"size": 85417,
+		"path": "../public/assets/styles-ClTGaXU0.css"
 	},
 	"/assets/textarea-Fyuzi6Vp.js": {
 		"type": "text/javascript; charset=utf-8",
 		"etag": "\"306-vcm/L91/XPEkHVNl2yk2Lp05ZG8\"",
-		"mtime": "2026-09-18T01:57:04.913Z",
+		"mtime": "2026-09-18T06:00:41.321Z",
 		"size": 774,
 		"path": "../public/assets/textarea-Fyuzi6Vp.js"
 	},
+	"/assets/select-Cppu-hti.js": {
+		"type": "text/javascript; charset=utf-8",
+		"etag": "\"1b2f4-3YBJAy4lzk0epih6EODEaDeMaE4\"",
+		"mtime": "2026-09-18T06:00:41.321Z",
+		"size": 111348,
+		"path": "../public/assets/select-Cppu-hti.js"
+	},
 	"/assets/trash-2-BXZzBsoV.js": {
 		"type": "text/javascript; charset=utf-8",
 		"etag": "\"146-hW/6t3H21wnW0twJKNkEJlNp/Gk\"",
-		"mtime": "2026-09-18T01:57:04.913Z",
+		"mtime": "2026-09-18T06:00:41.321Z",
 		"size": 326,
 		"path": "../public/assets/trash-2-BXZzBsoV.js"
 	},
 	"/assets/useValueChanged-VVyq4hb9.js": {
 		"type": "text/javascript; charset=utf-8",
 		"etag": "\"dd8-Te7VI1t9EEvBsgN9Wq88UqStSY4\"",
-		"mtime": "2026-09-18T01:57:04.913Z",
+		"mtime": "2026-09-18T06:00:41.321Z",
 		"size": 3544,
 		"path": "../public/assets/useValueChanged-VVyq4hb9.js"
 	}

package/README.md

@@ -1,45 +1,48 @@
 # Loopable
 
-Loopable watches the tools a team already uses and finishes the work with a coding agent. It picks up a signal, does what the loop says, and writes the result back. Loops run on their own. Every run is recorded.
+Loopable is the team’s always-on agent for shared-knowledge work — review, cases, monitors. A lot of work should not depend on one person. People assign work in Slack, GitHub, and on a schedule. Codex and Claude finish it on a shared computer.
 
-Connect GitHub or Gmail, write a loop, leave a runner on. Pull requests get reviewed, mail gets triaged, assigned issues get a draft. You see what happened in the inbox.
+It picks up a signal, does what the loop says, and writes the result back. Loops run on their own. Every run is recorded in the inbox.
 
-The words for the parts — loop, workflow, runner, and the rest — are in [docs/concepts.md](docs/concepts.md).
+Connect GitHub, a Slack bot, a Feishu / Lark bot, Gmail, or WeChat. Write a loop. Leave the machine on. Pull requests get reviewed, assigned issues get a draft, a scheduled job runs at 9am. The team does not have to open Codex.
+
+The story is in [docs/narrative.md](docs/narrative.md). The words for the parts — loop, workflow, runner, and the rest — are in [docs/concepts.md](docs/concepts.md).
 
 ## Architecture
 
 Three processes. The agent always runs on a Runner, never on the App or Dispatcher.
 
-```text
-Signal → Loop → Task
-              → Dispatcher prepares context, picks a Runner
-              → Runner runs the Agent
-              → Dispatcher writes back
-```
+<p align="center">
+  <img src="docs/architecture.svg" alt="Slack bot, GitHub, and Lark bot into Loopable. A runner pulls the job. Loopable writes back to the same three." width="920" />
+</p>
+
+Slack bot, GitHub, and Lark bot send work in. Loopable watches, matches a loop, and queues the job. A Runner pulls it, runs Codex or Claude, and Loopable writes the result back.
 
 ```text
-Loopable  ──HTTP──  Runner  ──  Agent CLI
+Loopable  ──HTTP pull──  Runner  ──  Agent CLI
 (App + Dispatcher)
 ```
 
 | Process | Does |
 | --- | --- |
 | **App** | UI, HTTP API, OAuth, the interface runners pull from |
-| **Dispatcher** | Watches for signals, prepares tasks, writes back |
-| **Runner** | Runs the agent CLI |
+| **Dispatcher** | Watches for signals, matches loops, queues jobs, writes back |
+| **Runner** | Pulls a job over HTTP, runs the agent CLI |
 
-App and Dispatcher share one database and stay on the same host. Only one Dispatcher may run against that database. Runners join over HTTP: this machine, or others. Extra machines are in [docs/deploy.md](docs/deploy.md).
+App and Dispatcher share one database and stay on the same host. Only one Dispatcher may run against that database. Runners join over HTTP from that host or other machines. Extra runners are in [docs/deploy.md](docs/deploy.md).
 
-## Use it locally
+## Run it
 
-You need Node 22+ and an agent CLI signed in on the runner host (Codex or Cursor Agent).
+The usual setup is one computer that stays on — a Mac in the office is enough. App, Dispatcher, and a Runner all live there. It looks like a spare machine on a desk. For a small team, that is the product.
+
+You need Node 22+ and an agent CLI signed in on that machine (Codex or Cursor Agent / Claude).
 
 ```bash
 npm install -g loopable-cli
 loopable start                # App + Dispatcher, bound on all interfaces
 ```
 
-Open `http://127.0.0.1:4321`. Connect an account. Write a loop. On Runners, copy the join command (LAN IP, not 127.0.0.1):
+On the same computer, open `http://127.0.0.1:4321`. Connect GitHub from that address. Write a loop. On Runners, copy the join command and start a runner (this machine is fine):
 
 ```bash
 loopable runner --url http://<LAN-IP>:4321 --token <from Runners>
@@ -47,13 +50,13 @@ loopable runner --url http://<LAN-IP>:4321 --token <from Runners>
 
 If the dispatcher is not running, the app says so. If no runner has joined, tasks wait.
 
-Connect GitHub from `http://127.0.0.1:4321` on this machine. Extra runners on other machines are in [docs/deploy.md](docs/deploy.md).
-
 State lives in `~/.loopable/`. Credentials stay in the OS keychain.
 
+Another always-on runner, or opening the UI from a second computer, is in [docs/deploy.md](docs/deploy.md). A company VM is optional later, only if this box is not enough.
+
 ## Develop
 
-This section is only for working on the code. Running Loopable as a product is the CLI above, not pnpm. Dev uses `~/.loopable-dev/` and a separate keychain namespace, so it does not touch the local deploy database.
+This section is only for working on the code. Running Loopable as a product is the CLI above, not pnpm. Dev uses `~/.loopable-dev/` and a separate keychain namespace, so it does not touch the team database.
 
 TanStack Start (React + Vite), SQLite, Tailwind. Tests are Vitest.
 
@@ -68,6 +71,8 @@ pnpm db:studio
 
 `pnpm runner` is only for a second machine while `pnpm dev` is already running.
 
+The public site is `site/` (static HTML, Vite). `pnpm site:dev` to preview. `pnpm site:build` writes `site/dist` for a Cloudflare Worker with assets only. `pnpm site:deploy` when you are ready to publish it.
+
 | Path | Contents |
 | --- | --- |
 | `src/connectors/` | One folder per connector: `manifest.ts` (browser-safe) and `runtime.ts` (server) |

package/dist/cli.mjs

@@ -14,68 +14,17 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
-// src/lib/callback.ts
-var callback_exports = {};
-__export(callback_exports, {
-  appOrigin: () => appOrigin,
-  callbackUrl: () => callbackUrl,
-  isLoopbackHost: () => isLoopbackHost,
+// src/lib/lan.ts
+var lan_exports = {};
+__export(lan_exports, {
   lanIPv4: () => lanIPv4,
-  loopableOrigin: () => loopableOrigin,
-  registrableCallbackUrl: () => registrableCallbackUrl
+  loopableOrigin: () => loopableOrigin
 });
 import { networkInterfaces } from "node:os";
 function configuredOrigin() {
   const base = process.env.LOOPABLE_BASE_URL?.replace(/\/$/, "");
   return base || null;
 }
-function isLoopbackHost(hostname) {
-  return hostname === "127.0.0.1" || hostname === "localhost" || hostname === "::1";
-}
-function isPrivateHostname(hostname) {
-  if (isLoopbackHost(hostname)) return true;
-  const v4 = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(hostname);
-  if (v4) {
-    const a = Number(v4[1]);
-    const b = Number(v4[2]);
-    if (a === 10) return true;
-    if (a === 127) return true;
-    if (a === 192 && b === 168) return true;
-    if (a === 172 && b >= 16 && b <= 31) return true;
-    if (a === 169 && b === 254) return true;
-    return false;
-  }
-  const host = hostname.toLowerCase();
-  if (host.includes(":")) {
-    if (host.startsWith("fe80:") || host.startsWith("fc") || host.startsWith("fd")) return true;
-  }
-  return false;
-}
-function publicConfiguredOrigin() {
-  const base = configuredOrigin();
-  if (!base) return null;
-  try {
-    const url = new URL(base);
-    if (isPrivateHostname(url.hostname)) return null;
-    return base;
-  } catch {
-    return null;
-  }
-}
-function appOrigin(requestUrl) {
-  const hosted = publicConfiguredOrigin();
-  if (hosted) return hosted;
-  const url = new URL(requestUrl);
-  return `http://127.0.0.1${url.port ? `:${url.port}` : ""}`;
-}
-function callbackUrl(requestUrl, connectorId) {
-  return `${appOrigin(requestUrl)}/api/connectors/${connectorId}/callback`;
-}
-function registrableCallbackUrl(connectorId) {
-  const hosted = publicConfiguredOrigin();
-  if (hosted) return `${hosted}/api/connectors/${connectorId}/callback`;
-  return `http://127.0.0.1/api/connectors/${connectorId}/callback`;
-}
 function lanIPv4(nics = networkInterfaces()) {
   const found = [];
   for (const addrs of Object.values(nics)) {
@@ -96,8 +45,8 @@ function loopableOrigin(nics = networkInterfaces()) {
   const port = process.env.PORT ?? process.env.NITRO_PORT ?? "4321";
   return `http://${lanIPv4(nics) ?? "127.0.0.1"}:${port}`;
 }
-var init_callback = __esm({
-  "src/lib/callback.ts"() {
+var init_lan = __esm({
+  "src/lib/lan.ts"() {
     "use strict";
   }
 });
@@ -7122,7 +7071,7 @@ var init_runners = __esm({
 
 // src/cli.ts
 import { spawn } from "node:child_process";
-import { existsSync as existsSync2 } from "node:fs";
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
 import { dirname, join as join3 } from "node:path";
 import { createInterface } from "node:readline";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
@@ -7141,8 +7090,18 @@ function usage() {
 
   loopable dispatcher
       Dispatcher only.
+
+  loopable --version
 `;
 }
+function cliVersion() {
+  try {
+    const pkg = JSON.parse(readFileSync2(join3(root, "package.json"), "utf8"));
+    return pkg.version;
+  } catch {
+    return "unknown";
+  }
+}
 function fail(message) {
   process.stderr.write(`${message}
 `);
@@ -7162,6 +7121,7 @@ function parse(argv) {
       return value;
     };
     if (arg === "-h" || arg === "--help") return { command: "help", flags };
+    if (arg === "-v" || arg === "--version") return { command: "version", flags };
     if (arg === "--host") flags.host = next();
     else if (arg === "--port") flags.port = next();
     else if (arg === "--url") flags.url = next();
@@ -7248,7 +7208,7 @@ async function waitForApp(port) {
 }
 async function printRunnerHint(flags) {
   await waitForApp(flags.port);
-  const { lanIPv4: lanIPv42 } = await Promise.resolve().then(() => (init_callback(), callback_exports));
+  const { lanIPv4: lanIPv42 } = await Promise.resolve().then(() => (init_lan(), lan_exports));
   const { getJoinToken: getJoinToken2 } = await Promise.resolve().then(() => (init_runners(), runners_exports));
   const ip = lanIPv42() ?? "127.0.0.1";
   const url = `http://${ip}:${flags.port}`;
@@ -7279,6 +7239,11 @@ async function main() {
     process.stdout.write(usage());
     return;
   }
+  if (command === "version") {
+    process.stdout.write(`${cliVersion()}
+`);
+    return;
+  }
   if (command === "runner") {
     if (flags.url) process.env.LOOPABLE_URL = flags.url;
     if (flags.token) process.env.LOOPABLE_RUNNER_TOKEN = flags.token;