junhost 0.1.0

package/README.md

@@ -0,0 +1,38 @@
+# Jun
+
+Self-hosted dashboard that runs and supervises [Codex](https://developers.openai.com/codex) as a 24/7 agent on your own machine or VPS.
+
+- **Chat runs** — full Codex conversations with live streaming, reasoning, tool cards, approvals, steering, models/effort/sandbox per conversation
+- **Workspaces** — multiple isolated project workspaces with a file tree, editor, and previews
+- **Remote browser** — watch the agent browse in a live viewport, take manual control, WAF-resistant stealth engine, proxy support
+- **Skills** — create, edit, and test agent skills; install from the [skills.sh](https://skills.sh) registry
+- **MCP** — manage MCP servers from the UI; Jun ships its own MCP server so the agent can manage itself
+- **Schedules** — cron or one-off automated runs, unattended approval mode
+- **Memories** — Codex's native memory feature, surfaced and editable
+
+## Requirements
+
+- [Bun](https://bun.sh) ≥ 1.2
+- [Codex CLI](https://developers.openai.com/codex) on your PATH (`npm i -g @openai/codex`) with a signed-in account
+
+## Install
+
+```bash
+bun install -g junhost
+jun start
+```
+
+Open http://127.0.0.1:8787. Sign in to Codex from the Settings page (device-code flow works on headless servers).
+
+```bash
+jun doctor   # check prerequisites
+jun help
+```
+
+## Where things live
+
+All state is in `~/.jun` (override with `JUN_HOME`): projects/workspaces, run history (JSONL), schedules, config. The daemon binds `127.0.0.1` only — for a remote VPS, tunnel: `ssh -L 8787:127.0.0.1:8787 user@host`.
+
+## License
+
+Proprietary — all rights reserved. Free to install and use; the source is not open.

package/bin/jun.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env bun
+/**
+ * `jun` CLI — entry point of the published junhost package.
+ *
+ * The daemon requires the Bun runtime (Bun.serve/Bun.spawn); the shebang
+ * targets bun directly, and the guard below catches the npm/Node case with a
+ * pointer instead of a cryptic crash.
+ */
+
+if (typeof Bun === "undefined") {
+  console.error(
+    "Jun runs on Bun, not Node. Install Bun (https://bun.sh) and reinstall:\n" +
+      "  bun install -g junhost",
+  );
+  process.exit(1);
+}
+
+import path from "node:path";
+import { existsSync } from "node:fs";
+
+const root = path.resolve(import.meta.dir, "..");
+const command = process.argv[2] ?? "start";
+
+function version() {
+  const pkg = require(path.join(root, "package.json"));
+  return pkg.version;
+}
+
+function help() {
+  console.log(`jun ${version()} — self-hosted Codex agent dashboard
+
+Usage: jun <command>
+
+Commands:
+  start         Start the daemon + dashboard (default; http://127.0.0.1:8787)
+  doctor        Check prerequisites (codex CLI, browser engine)
+  mcp-server    Run the self-management MCP server (spawned by Codex, stdio)
+  version       Print the version
+
+Environment:
+  JUN_HOME      Data directory (default ~/.jun)
+  JUN_HOST      Bind address (default 127.0.0.1)
+  JUN_PORT      Port (default 8787)`);
+}
+
+async function doctor() {
+  let ok = true;
+  const report = (good, label, hint) => {
+    console.log(`${good ? "  ok " : "FAIL "} ${label}${good || !hint ? "" : ` — ${hint}`}`);
+    if (!good) ok = false;
+  };
+
+  report(true, `bun ${Bun.version}`);
+  const codex = Bun.which("codex");
+  report(Boolean(codex), codex ? `codex CLI (${codex})` : "codex CLI not found", "install with: npm i -g @openai/codex");
+  if (codex) {
+    try {
+      const proc = Bun.spawn([codex, "--version"], { stdout: "pipe", stderr: "ignore" });
+      const out = await new Response(proc.stdout).text();
+      await proc.exited;
+      console.log(`     ${out.trim()}`);
+    } catch {
+      /* version probe is best-effort */
+    }
+  }
+
+  const os = await import("node:os");
+  const cloakRoot = path.join(os.homedir(), ".cloakbrowser");
+  const hasCloak =
+    existsSync(cloakRoot) &&
+    (await import("node:fs")).readdirSync(cloakRoot).some((d) => d.startsWith("chromium-"));
+  report(
+    true,
+    hasCloak
+      ? "stealth browser engine (cloakbrowser) installed"
+      : "stealth browser engine not yet downloaded (fetched automatically on first start, ~535MB)",
+  );
+
+  process.exit(ok ? 0 : 1);
+}
+
+switch (command) {
+  case "start":
+    await import(path.join(root, "dist", "index.js"));
+    break;
+  case "mcp-server":
+    await import(path.join(root, "dist", "mcp-server.js"));
+    break;
+  case "doctor":
+    await doctor();
+    break;
+  case "version":
+  case "--version":
+  case "-v":
+    console.log(version());
+    break;
+  case "help":
+  case "--help":
+  case "-h":
+    help();
+    break;
+  default:
+    console.error(`Unknown command: ${command}\n`);
+    help();
+    process.exit(1);
+}