@jamiexiongr/panda 0.1.19 → 0.1.20

package/README.md

@@ -21,20 +21,45 @@ For the complete Chinese install and usage guide in this repository, see `docs/p
 npm install -g @jamiexiongr/panda@latest --registry=https://registry.npmjs.org/
 ```
 
-## Usage
-
-```bash
-panda hub
-panda hub tailscareserv
-
-panda agent
-panda agent tailscareserv
-```
-
-`tailscareserv` and `--tailscale-serve` both enable automatic `tailscale serve` publishing.
-
-## Notes
-
-- `panda hub tailscareserv` is the quickest path to a mobile-installable HTTPS PWA inside your tailnet.
-- `panda agent tailscareserv` makes the agent register `https/wss` direct URLs when no explicit direct URL env vars are set.
+## Usage
+
+```bash
+panda hub
+panda hub tailscareserv
+
+panda agent
+panda agent tailscareserv
+```
+
+`tailscareserv` and `--tailscale-serve` both enable automatic `tailscale serve` publishing.
+
+## Windows Service
+
+Windows only:
+
+```powershell
+panda hub service install --name=PandaHub tailscareserv
+panda agent service install --name=PandaAgent --hub-url=http://127.0.0.1:4343
+
+panda hub service status
+panda agent service status
+
+panda hub service restart
+panda agent service restart
+
+panda hub service uninstall
+panda agent service uninstall
+```
+
+Notes:
+
+- `service install` registers the service for automatic startup.
+- Extra startup args after `install` are remembered by the service and reused on restart.
+- The current `PANDA_*` environment variables are captured when you run `service install`.
+- If you change startup args or `PANDA_*` values later, run `service install` again to update the service definition.
+
+## Notes
+
+- `panda hub tailscareserv` is the quickest path to a mobile-installable HTTPS PWA inside your tailnet.
+- `panda agent tailscareserv` makes the agent register `https/wss` direct URLs when no explicit direct URL env vars are set.
 - If `tailscale serve` says it is not enabled on your tailnet, open the approval link printed by the CLI and enable Serve for that node.

package/dist/cli.mjs

@@ -104,6 +104,10 @@ var printUsage = () => {
 Commands:
   agent [tailscareserv|tailscareserv-pub] [--hub-url=<url>]    Start the Panda agent service
   hub [tailscareserv|tailscareserv-pub]      Start the Panda hub service with the bundled web UI
+  agent service <install|start|stop|restart|status|uninstall> [args...]
+                                                Manage the Panda Agent Windows service
+  hub service <install|start|stop|restart|status|uninstall> [args...]
+                                                Manage the Panda Hub Windows service
   tip      Set PANDA_GROUP_IP=<lan-ip> to auto-fill hub/direct/ws URLs for agent startup
   help     Show this message`);
 };
@@ -138,7 +142,13 @@ var main = async () => {
     return;
   }
   if (command === "agent") {
-    const { startJamiexiongrAgent } = await import("@jamiexiongr/panda-agent");
+    const { manageJamiexiongrAgentService, startJamiexiongrAgent } = await import("@jamiexiongr/panda-agent");
+    if (commandArgs[0]?.trim().toLowerCase() === "service") {
+      await manageJamiexiongrAgentService({
+        argv: commandArgs.slice(1)
+      });
+      return;
+    }
     await startJamiexiongrAgent({
       tailscalePublicationMode: agentPublicationMode,
       hubUrl: resolveCliOptionValue(commandArgs, [
@@ -154,7 +164,13 @@ var main = async () => {
     return;
   }
   if (command === "hub") {
-    const { startJamiexiongrHub } = await import("@jamiexiongr/panda-hub");
+    const { manageJamiexiongrHubService, startJamiexiongrHub } = await import("@jamiexiongr/panda-hub");
+    if (commandArgs[0]?.trim().toLowerCase() === "service") {
+      await manageJamiexiongrHubService({
+        argv: commandArgs.slice(1)
+      });
+      return;
+    }
     await startJamiexiongrHub({
       tailscalePublicationMode: hubPublicationMode
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jamiexiongr/panda",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "type": "module",
   "private": false,
   "description": "Panda combined installer",
@@ -8,8 +8,8 @@
     "panda": "./bin/panda.cjs"
   },
   "dependencies": {
-    "@jamiexiongr/panda-agent": "0.1.19",
-    "@jamiexiongr/panda-hub": "0.1.19"
+    "@jamiexiongr/panda-agent": "0.1.20",
+    "@jamiexiongr/panda-hub": "0.1.20"
   },
   "files": [
     "bin",