gohere 0.4.1 → 0.6.0

package/README.md

@@ -6,7 +6,7 @@ Tiny local dev URL launcher for `.localhost` projects.
 http://myproject.localhost
 ```
 
-Run `gohere` inside a package project or static folder. It starts or serves the project on a hidden local port, routes a clean `.localhost` hostname to it, and prints the URL.
+Run `gohere` inside a package project, workspace root, or static folder. It starts or serves the project on a hidden local port, routes a clean `.localhost` hostname to it, and prints the URL.
 
 No script edits. No port memorization. No repo config.
 
@@ -26,14 +26,21 @@ go install github.com/roie/gohere/cmd/gohere@latest
 
 ## Quick start
 
-`gohere` supports package projects and static files.
+`gohere` supports package projects, workspace roots, and static files.
 
-Run the default `dev` script from the nearest `package.json`:
+Run the default command:
 
 ```bash
 gohere
 ```
 
+In a package project, this runs the nearest `package.json` `dev` script. In a workspace root, this discovers workspace packages from `pnpm-workspace.yaml` or `package.json` workspaces, starts each package with a `dev` script, and gives each package its own route:
+
+```text
+gohere web    -> http://web.myrepo.localhost
+gohere worker -> http://worker.myrepo.localhost
+```
+
 Run a named package script:
 
 ```bash
@@ -46,6 +53,35 @@ 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
+gohere dev
+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
@@ -64,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
@@ -79,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
 ```
 
@@ -88,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
@@ -97,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
@@ -118,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.4.1",
+  "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"
   ]
 }