gohere 0.5.0 → 0.6.0

package/README.md

@@ -53,6 +53,14 @@ Run multiple server scripts:
 gohere dev:web dev:api
 ```
 
+When one `gohere` run starts multiple services, each service can discover the others through env vars. For example, a web dev server can proxy API requests to a worker without hardcoding a port:
+
+```ts
+target: process.env.GOHERE_WORKER_URL
+```
+
+Use `GOHERE_<NAME>_URL` for app config. `GOHERE_<NAME>_PORT`, `GOHERE_<NAME>_TARGET`, and `GOHERE_SERVICES_JSON` are also available when multiple managed services start together. `PORT` and `TARGET` are advanced values and are only set when `gohere` controls that service port.
+
 Run any current package script exactly as written by naming it explicitly:
 
 ```bash
@@ -61,6 +69,19 @@ gohere build
 gohere preview
 ```
 
+Run an explicit filesystem target:
+
+```bash
+gohere ./dist
+gohere ./apps/web
+```
+
+Auto-refresh static pages while editing:
+
+```bash
+gohere --live
+```
+
 Run a raw command:
 
 ```bash
@@ -79,6 +100,12 @@ Route to a known target port:
 gohere --target 5173 -- npm run dev
 ```
 
+Use a custom port flag for tools that do not use `--port`:
+
+```bash
+gohere --port-flag --local-port dev
+```
+
 Open the project URL in your browser:
 
 ```bash
@@ -94,7 +121,8 @@ CSS, images, and scripts are served normally.
 ```text
 myproject      -> http://myproject.localhost
 @scope/web     -> http://web.localhost
-repo/apps/web  -> http://web.repo.localhost
+./apps/web     -> http://web.repo.localhost
+./dist         -> http://dist.localhost
 about.html     -> http://myproject.localhost/about.html
 ```
 
@@ -103,7 +131,10 @@ about.html     -> http://myproject.localhost/about.html
 ```bash
 gohere list
 gohere list --verbose
+gohere list --json
 gohere stop
+gohere stop web
+gohere stop --all
 gohere prune
 gohere doctor
 gohere service stop
@@ -112,6 +143,10 @@ gohere uninstall
 
 `gohere list --verbose` shows host, target, status, PID, and working directory.
 
+`gohere list --json` returns the same route information in a stable machine-readable format.
+
+`gohere stop` stops routes for the current folder. `gohere stop <target>` stops a listed route by host, short host label, route name, or project name. `gohere stop --all` stops safely controllable routes and skips unverified live routes.
+
 Route status can be `ready`, `dead`, or `unknown`. `prune` removes only routes that are confidently dead.
 
 ## Service And Uninstall
@@ -133,29 +168,31 @@ npm uninstall -g gohere
 
 ## How it works
 
-`gohere` runs a local service on HTTP port `80`.
+`gohere` runs one local service on HTTP port `80`.
 
 Each project gets a hidden local port. The service maps the clean `.localhost` hostname to that port using the request `Host` header.
 
+First-time setup installs the local service in `~/.gohere/` and starts it in the background. After that, `gohere` only starts your project and registers its route.
+
+The service only serves local machine traffic. On macOS, gohere uses a port `80` listener that rejects non-loopback connections before requests reach the router.
+
 State is stored in:
 
 ```text
 ~/.gohere/
 ```
 
-On Linux/WSL, first-time setup may ask for permission so the service can bind to local port `80`.
-
-On Windows, first-time setup starts the local service directly on `127.0.0.1:80`.
+Linux may ask for one-time permission to bind port `80`.
 
 When used from WSL, `gohere` reuses a running Windows service automatically.
 
 ## Platform support
 
-Current target: Linux / WSL and Windows.
-
-Planned: macOS.
+- Linux / WSL
+- Windows
+- macOS (experimental)
 
-The npm package currently targets Linux x64 and Windows x64.
+The npm package includes x64 and arm64 binaries for these platforms.
 
 ## Limits
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gohere",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Tiny local dev URL launcher for .localhost projects.",
   "bin": {
     "gohere": "bin/gohere.js"
@@ -25,9 +25,11 @@
   ],
   "os": [
     "linux",
-    "win32"
+    "win32",
+    "darwin"
   ],
   "cpu": [
-    "x64"
+    "x64",
+    "arm64"
   ]
 }