gohere 0.5.0 → 0.7.0

package/README.md

@@ -3,7 +3,7 @@
 Tiny local dev URL launcher for `.localhost` projects.
 
 ```text
-http://myproject.localhost
+https://myproject.localhost
 ```
 
 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.
@@ -34,13 +34,15 @@ Run the default command:
 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:
+In a package project, this runs the nearest `package.json` `dev` script. In a workspace root with child packages that have `dev` scripts, this starts each matching package and gives each package its own route:
 
 ```text
-gohere web    -> http://web.myrepo.localhost
-gohere worker -> http://worker.myrepo.localhost
+gohere web    -> https://web.myrepo.localhost
+gohere worker -> https://worker.myrepo.localhost
 ```
 
+If workspace metadata exists but no child package has a `dev` script, `gohere` falls back to the current package's `dev` script. If there is no package script and the folder has `index.html`, `gohere` serves it as a static site.
+
 Run a named package script:
 
 ```bash
@@ -53,6 +55,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 +71,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,23 +102,30 @@ 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
 gohere --open
 ```
 
-For static folders, `gohere` serves `index.html`. You can also open a specific file, for example `gohere about.html`, which routes to `http://myproject.localhost/about.html`.
+For static folders, `gohere` serves `index.html`. You can also open a specific file, for example `gohere about.html`, which routes to `https://myproject.localhost/about.html`.
 
 CSS, images, and scripts are served normally.
 
 ## Examples
 
 ```text
-myproject      -> http://myproject.localhost
-@scope/web     -> http://web.localhost
-repo/apps/web  -> http://web.repo.localhost
-about.html     -> http://myproject.localhost/about.html
+myproject      -> https://myproject.localhost
+@scope/web     -> https://web.localhost
+./apps/web     -> https://web.repo.localhost
+./dist         -> https://dist.localhost
+about.html     -> https://myproject.localhost/about.html
 ```
 
 ## Route management
@@ -103,7 +133,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 +145,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,35 +170,37 @@ 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` and HTTPS port `443`.
 
 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/`, installs a local trusted certificate authority, and starts the service 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 local ports and trust the local certificate authority.
 
 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
 
-- HTTP only
 - `.localhost` only
-- no HTTPS
+- HTTPS uses a local trusted certificate authority
+- HTTP remains available with `--http`
 - no LAN sharing
 - no custom TLDs
 - no project config files

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gohere",
-  "version": "0.5.0",
+  "version": "0.7.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"
   ]
 }