gohere 0.1.0

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2026 Roie Ambulo
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,114 @@
+# gohere
+
+Tiny local dev URL launcher for `.localhost` projects.
+
+```text
+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.
+
+No script edits. No port memorization. No repo config.
+
+## Install
+
+```bash
+npm i -g gohere
+```
+
+Or install the Go CLI directly:
+
+```bash
+go install github.com/roie/gohere/cmd/gohere@latest
+```
+
+## Quick start
+
+`gohere` supports package projects and static files.
+
+Run the default `dev` script from the nearest `package.json`:
+
+```bash
+gohere
+```
+
+Run a named package script:
+
+```bash
+gohere dev:web
+```
+
+Run a raw command:
+
+```bash
+gohere -- npm run dev
+```
+
+Route to a known target port:
+
+```bash
+gohere --target 5173 -- npm run dev
+```
+
+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`.
+
+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
+```
+
+## Route management
+
+```bash
+gohere list
+gohere list --verbose
+gohere stop
+gohere clean
+gohere doctor
+```
+
+`gohere list --verbose` shows host, target, status, PID, and working directory.
+
+Route status can be `ready`, `dead`, or `unknown`. `clean` removes only routes that are confidently dead.
+
+## How it works
+
+`gohere` runs a local router on HTTP port `80`.
+
+Each project gets a hidden local port. The router maps the clean `.localhost` hostname to that port using the request `Host` header.
+
+State is stored in:
+
+```text
+~/.gohere/
+```
+
+On Linux/WSL, first-time setup may ask for permission so the router can bind to local port `80`.
+
+## Platform support
+
+Current target: Linux / WSL.
+
+Planned: macOS and native Windows.
+
+The npm package currently targets Linux x64 first.
+
+## Limits
+
+- HTTP only
+- `.localhost` only
+- no HTTPS
+- no LAN sharing
+- no custom TLDs
+- no project config files
+- no browser auto-open yet
+
+## License
+
+Apache-2.0

package/bin/gohere.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("node:child_process");
+const path = require("node:path");
+
+const platform = process.platform;
+const arch = process.arch;
+const exe = platform === "win32" ? "gohere.exe" : "gohere";
+const binary = path.join(__dirname, "..", "vendor", `${platform}-${arch}`, exe);
+
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+
+if (result.error) {
+  console.error(`gohere binary not available for ${platform}-${arch}`);
+  console.error(result.error.message);
+  process.exit(1);
+}
+
+if (result.signal) {
+  process.kill(process.pid, result.signal);
+}
+
+process.exit(result.status ?? 1);

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "gohere",
+  "version": "0.1.0",
+  "description": "Tiny local dev URL launcher for .localhost projects.",
+  "bin": {
+    "gohere": "bin/gohere.js"
+  },
+  "files": [
+    "bin/",
+    "vendor/"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/roie/gohere.git"
+  },
+  "bugs": {
+    "url": "https://github.com/roie/gohere/issues"
+  },
+  "homepage": "https://github.com/roie/gohere#readme",
+  "keywords": [
+    "localhost",
+    "dev-server",
+    "cli"
+  ],
+  "os": [
+    "linux"
+  ],
+  "cpu": [
+    "x64"
+  ]
+}