unbrowse 2.10.2 → 2.11.0

package/README.md

@@ -6,18 +6,23 @@ Turn any website into a reusable API interface for agents. Unbrowse captures net
 
 One agent learns a site once. Every later agent gets the fast path.
 
+Unbrowse is a drop-in browser for agents: same browser-shaped job in the stack, but with route learning, reuse, and browser fallback built in.
+
 > Security note: capture and execution stay local by default. Credentials stay on your machine. Learned API contracts are published to the shared marketplace only after capture. See [SKILL.md](./SKILL.md) for the full agent-facing API reference and tool-policy guidance.
 
 ## Quick start
 
 ```bash
-# Fastest full setup
-npx unbrowse setup
+# Deterministic setup from a repo clone
+git clone --single-branch --depth 1 https://github.com/unbrowse-ai/unbrowse.git ~/unbrowse
+cd ~/unbrowse && ./setup --host off
 ```
 
-`npx unbrowse setup` downloads the CLI on demand, verifies the bundled Kuri runtime, lets you register with an email-shaped display identity, registers the Open Code `/unbrowse` command when Open Code is detected, and starts the local server.
+`./setup` installs repo dependencies, prebuilds the packaged CLI runtime, installs a stable `unbrowse` shim, and then runs the real first-time bootstrap: ToS acceptance, agent registration + API-key caching, and lobster.cash wallet detection when present.
+
+If a wallet is configured, that wallet address is synced onto your agent profile and becomes the destination for contributor payouts when your routes earn.
 
-For daily use:
+For repeat npm use after a healthy publish:
 
 ```bash
 npm install -g unbrowse
@@ -34,11 +39,12 @@ npx skills add unbrowse-ai/unbrowse
 
 Unbrowse no longer self-updates at runtime. If you already have Unbrowse installed, upgrade to the latest version after each release or the new flow may not work on your machine.
 
-If you installed the CLI globally:
+If you installed from a repo clone:
 
 ```bash
-npm install -g unbrowse@latest
-unbrowse setup
+cd ~/unbrowse
+git pull --ff-only
+./setup --host off
 ```
 
 If your agent host uses skills, rerun its skill install/update command too:
@@ -49,6 +55,9 @@ npx skills add unbrowse-ai/unbrowse
 
 Need help or want release updates? Join the Discord: [discord.gg/VWugEeFNsG](https://discord.gg/VWugEeFNsG)
 
+Every CLI command auto-starts the local server on `http://localhost:6969` by default. Override with `UNBROWSE_URL`, `PORT`, or `HOST`. On first startup it auto-registers as an agent with the marketplace and caches credentials in `~/.unbrowse/config.json`. `unbrowse setup` prompts for an email-shaped identity first; headless setups can provide `UNBROWSE_AGENT_EMAIL`.
+Canonical docs: [docs.unbrowse.ai](https://docs.unbrowse.ai)
+
 Every CLI command auto-starts the local server on `http://localhost:6969` by default. Override with `UNBROWSE_URL`, `PORT`, or `HOST`. On first startup it auto-registers as an agent with the marketplace and caches credentials in `~/.unbrowse/config.json`. `unbrowse setup` now prompts for an email-shaped identity first; headless setups can provide `UNBROWSE_AGENT_EMAIL`.
 
 Works with Claude Code, Open Code, Cursor, Codex, Windsurf, and any agent host that can call a local CLI or skill.
@@ -80,6 +89,15 @@ unbrowse search --intent "get stock prices"
 
 If you tried Unbrowse on a site or API and could not get it to work, add it to [Discussion #53](https://github.com/unbrowse-ai/unbrowse/discussions/53). We use that thread to collect missing or broken targets so we can turn them into requirements for the next eval pass.
 
+## Docs
+
+The synced skill repo also carries the longer-form docs set:
+
+- [Whitepaper companion index](./docs/whitepaper/README.md)
+- [For Technical Readers](./docs/whitepaper/for-technical-readers.md)
+- [For Investors](./docs/whitepaper/for-investors.md)
+- [Analytics API](./docs/analytics-api.md)
+
 ## How it works
 
 When an agent asks for something, Unbrowse first searches the marketplace for an existing skill. If one exists with enough confidence, it executes immediately. If not, Unbrowse captures the site, learns the APIs behind it, publishes a reusable skill, and executes that instead.
@@ -157,6 +175,16 @@ See [SKILL.md](./SKILL.md) for the full API reference including all endpoints, s
 | GET    | `/v1/stats/summary`      | Platform stats                                 |
 | GET    | `/health`                | Health check                                   |
 
+## Docs
+
+The standalone skill repo also carries the core repo docs:
+
+- [Quickstart guide](./docs/guides/quickstart.md)
+- [API notes](./docs/api.md)
+- [Codex eval harness](./docs/codex-eval-harness.md)
+- [Deployment notes](./docs/deployment.md)
+- [Release checklist](./docs/RELEASING.md)
+
 ## Configuration
 
 ### Runtime directories

package/bin/unbrowse-wrapper.mjs

@@ -2,13 +2,13 @@
 
 /**
  * Thin wrapper — execs the compiled binary if available,
- * falls back to source mode (bun/tsx) if not.
+ * falls back to the package-managed Node launcher if not.
  */
 
 import { existsSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
-import { execFileSync, spawn } from "node:child_process";
+import { spawn } from "node:child_process";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const binaryPath = join(__dirname, "unbrowse");
@@ -24,32 +24,16 @@ if (existsSync(binaryPath)) {
     process.exit(code ?? 1);
   });
 } else {
-  // Fallback: source mode via bun or tsx
-  const packageRoot = join(__dirname, "..");
-  const entry = join(packageRoot, "runtime-src", "cli.ts");
-  
-  // Try bun first, then node+tsx
-  try {
-    execFileSync("which", ["bun"], { stdio: "ignore" });
-    const child = spawn("bun", [entry, ...process.argv.slice(2)], {
-      stdio: "inherit",
-      cwd: process.cwd(),
-    });
-    child.on("exit", (code, signal) => {
-      if (signal) { process.kill(process.pid, signal); return; }
-      process.exit(code ?? 1);
-    });
-  } catch {
-    // No bun — use node+tsx
-    const tsxPath = join(packageRoot, "node_modules", "tsx", "dist", "loader.mjs");
-    const child = spawn(process.execPath, ["--import", tsxPath, entry, ...process.argv.slice(2)], {
-      stdio: "inherit",
-      cwd: process.cwd(),
-      env: { ...process.env, UNBROWSE_PACKAGE_ROOT: packageRoot },
-    });
-    child.on("exit", (code, signal) => {
-      if (signal) { process.kill(process.pid, signal); return; }
-      process.exit(code ?? 1);
-    });
-  }
+  // Fallback: delegate to the stable package launcher so
+  // npm installs and npx use the same dependency resolution path.
+  const launcherPath = join(__dirname, "unbrowse.js");
+  const child = spawn(process.execPath, [launcherPath, ...process.argv.slice(2)], {
+    stdio: "inherit",
+    cwd: process.cwd(),
+    env: process.env,
+  });
+  child.on("exit", (code, signal) => {
+    if (signal) { process.kill(process.pid, signal); return; }
+    process.exit(code ?? 1);
+  });
 }