unbrowse 2.12.2 → 2.12.7

package/README.md

@@ -6,25 +6,18 @@ 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 replacement for OpenClaw / `agent-browser` browser flows for agents: on the API-native path it is typically ~30x faster, ~90% cheaper, and turns repeated browser work into reusable route assets.
-
 > 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
-# 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
+# Fastest full setup
+npx unbrowse setup
 ```
 
-`./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 wallet detection when present.
-
-If a wallet is configured, that wallet address becomes the contributor/payment truth: it is synced onto your agent profile, used as the destination for contributor payouts when your routes earn, and used as the spending wallet for paid marketplace routes.
-
-Unbrowse supports wallet providers such as `lobster.cash` for x402-gated routes. If you use `lobster.cash`, set `LOBSTER_WALLET_ADDRESS`. Other providers can use `AGENT_WALLET_ADDRESS` and optional `AGENT_WALLET_PROVIDER`.
+`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.
 
-For repeat npm use after a healthy publish:
+For daily use:
 
 ```bash
 npm install -g unbrowse
@@ -41,12 +34,11 @@ 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 from a repo clone:
+If you installed the CLI globally:
 
 ```bash
-cd ~/unbrowse
-git pull --ff-only
-./setup --host off
+npm install -g unbrowse@latest
+unbrowse setup
 ```
 
 If your agent host uses skills, rerun its skill install/update command too:
@@ -58,17 +50,14 @@ 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` now prompts for an email-shaped identity first; headless setups can provide `UNBROWSE_AGENT_EMAIL`.
-Canonical docs: [docs.unbrowse.ai](https://docs.unbrowse.ai)
 
 Works with Claude Code, Open Code, Cursor, Codex, Windsurf, and any agent host that can call a local CLI or skill.
 
 ## What setup does
 
-- Checks the local runtime/package-manager environment for the repo bootstrap or packaged CLI path.
-- Prebuilds the packaged CLI runtime and installs the stable `unbrowse` shim for the repo bootstrap path.
+- Checks local prerequisites for the npm/npx flow.
 - Verifies the bundled Kuri binary, or builds it from the vendored Kuri source when working from repo source with Zig installed.
 - Registers the Open Code `/unbrowse` command when Open Code is present.
-- Runs the first-use flow: ToS, agent registration/API-key caching, and wallet detection.
 - Starts the local Unbrowse server unless `--no-start` is passed.
 
 ## Common commands
@@ -91,21 +80,6 @@ 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 public docs set:
-
-- [Quickstart](./docs/guides/quickstart.md)
-- [API reference](./docs/api.md)
-- [Deployment guide](./docs/deployment.md)
-- [Release checklist](./docs/RELEASING.md)
-
-Whitepaper companion docs:
-
-- [Whitepaper companion index](./docs/whitepaper/README.md)
-- [For Technical Readers](./docs/whitepaper/for-technical-readers.md)
-- [For Investors](./docs/whitepaper/for-investors.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.
@@ -183,16 +157,6 @@ 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