Webcmd
Self-learning browser infrastructure that compiles website navigation into deterministic CLI commands, cutting AI agent browser token spend by up to 90%.
Least privilege: the README describes a sandboxed session model, explicit session IDs, and a browser-only default skill — measured layering (2). User confirmation (1): profiles are cookie jars reused to hand logged-in state to agents; no explicit confirmation mechanism for sensitive operations is documented. Data flow transparency (2): profile/session semantics are explained, but Webcmd Cloud data handling gets one sentence. Sensitive data handling (2): isolation and explicit session close are described, but no on-disk/encryption policy for cookie jars is shown. Dependency security (1): exact versions pinned for cloakbrowser and playwright-core, but no lockfile audit, SBOM, or rationale; postinstall/preuninstall lifecycle scripts (including a local HTTP shutdown call) are present without their implementations in evidence. External effects (1): the tool drives real browsers against real sites including authenticated social accounts ('Keep it read-only' appears only in one prompt example), with no systematic guardrail description. Rollback (1): plugins can be searched and installed, but no documented uninstall/rollback path. Source attribution (2): LICENSE carries clear copyright lines (jackwener / AgentR) consistent with package. author/repository.
Self-consistency (2): the 0–3 layer model and profile/session semantics are internally consistent and match package., but the README has a visible break — the Community section's 'Search and install them with:' is followed by an unrelated compatibility sentence. Dependency availability (2): Node 20.6+ stated, CI covers three OSes plus Bun; however, cloakbrowser 0.4.5 is a single hard dependency with no fallback path documented. Failure messages (2): benchmark tests verify cleanup/termination on startup failure, and structured -f output is shown, but the product's own error-message quality is not visible in the provided files.
Audience and scenarios (3): the layer table clearly spans unfamiliar sites to deterministic CLIs, with research/social/shopping example prompts. Capability boundaries (2): Cloud instability, illustrative plugin list, and plugin-dependent availability are noted, but the 'up to 90%' framing is vague. Trigger precision (2): explicit guidance to load the webcmd-browser skill only for live browser work, and precise example prompts. Environment fit (2): Node and Bun, three-OS CI, multiple harness targets for skills; but the browser engine is a single dependency (CloakBrowser) with no stated fallback.
Information architecture (3): README is well structured (layers → quick start → examples → benchmark → docs → community → contributing → license) with a documented docs site. Install notes (3): Node version, global install, plugin install, and skills install are all complete. Naming stability (2): @agentrhq/webcmd and the webcmd bin are consistent, but the project is pre-1.0 with an explicit 'Use Webcmd 0.7.11 or newer' compatibility break. Examples and FAQ (2): rich 'What You Can Ask' and X→CLI examples, but no FAQ or troubleshooting section. Known limitations (1): only one sentence about Cloud instability; applicability conditions of the 90% claim and plugin availability risks are under-disclosed. License (3): full Apache-2.0 text present and consistent across README, package., and badges. Versioning/changelog (1): version 0.8.2 exists but no CHANGELOG file is in evidence, only a release-notes generation script. Maintenance responsibility (2): SECURITY.md defines a private reporting channel and supported version (latest), CONTRIBUTING.md is referenced but not shown; maintenance cadence is only inferable from CI.
Output usability (2): examples specify required fields and source links; -f structured output recurs in CLI samples, but no actual output samples are shown. Marginal value (2): the learn-and-compile-to-deterministic-commands mechanism is genuinely differentiated; the benchmark chart claims best accuracy and lowest cost, but the methodology lives outside the provided files. Cost benefit (2): quantified anchors (90% token cut, $0.255/completed task) exist, yet the self-built stronger judge and judge-excluded cost accounting weaken comparability.
Claim traceability (2): the benchmark claim links to an in-repo report and external benchmark and states controlled conditions (same controller, model, judge, engine); but the headline '90%' has no inline derivation. Cross-source corroboration (1): the benchmark is self-reported and the plugin catalog lives in the same publisher's ecosystem; no independent third-party corroboration is in evidence. Fact/inference separation (2): the benchmark section defines its metrics ('accuracy is passed tasks out of 100') and explicitly contrasts its judge with the original setup; but marketing numbers and verifiable facts are not explicitly tiered in the text.
- The tool drives real browsers with the user's actual logged-in state (profile cookie jars) against accounts like LinkedIn and X; trial in an isolated environment first and avoid exposing high-value credentials to infrastructure from an unverified publisher.
- package. contains postinstall and preuninstall lifecycle scripts; review scripts/postinstall.js before installing.
- The 'up to 90% token cut' and benchmark results are self-reported, use a self-built stronger judge, and exclude judge cost — do not treat them as procurement-grade evidence.
- The core product source was not within this review's provided scope; security properties (session isolation, cookie storage, Cloud data flow) are confirmed only from documentation, not code.
- Site adapters are installed on demand from a separate repository via 'installSource', a supply-chain surface; verify plugin provenance before installing.
What does this agent do, and when should you use it?
Webcmd (GitHub: agentrhq/webcmd) is self-learning browser infrastructure for AI agents. On a first visit to a site, agents drive a real browser via `webcmd browser` commands (inspect, click, type, extract, capture network calls); as usage accumulates, Webcmd builds sitemap memory for the site and eventually compiles it into a reusable `webcmd <site>` adapter, so later agents skip rediscovery entirely. It ships as the npm global package `@agentrhq/webcmd`, requires Node.js 20.6+, and installs site adapters on demand from a separate plugin catalog (agentrhq/webcmd-plugins). Profiles act as cookie jars and Sessions are independent browser windows within a profile, enabling parallel agents to work in isolation. On the BU Bench V1 100-task browser automation benchmark, Webcmd recorded the highest accuracy (67%), the lowest cost per completed task ($0.255), and the fewest agent turns per completed task (9.8). The project is released under Apache-2.0.
Webcmd operates in four layers. Layer 0: for unfamiliar sites, the webcmd browser command family inspects, clicks, types, extracts data, and captures network calls in a live browser. Layer 1: it records observed pages, states, actions, workflows, APIs, pitfalls, and fallback paths into an agent-facing sitemap memory. Layer 2: once the action space is known, you author a reusable webcmd <site> adapter with structured output. Layer 3: deterministic workflows get tailored commands that run instantly with minimal tokens. It supports explicit browser sessions: webcmd --profile work session create "Work Project" -f creates a session; webcmd --profile work --session <id> browser run --file explore.js executes a sandboxed Playwright-style program; browser run --stdin accepts inline scripts. webcmd skills add installs the single webcmd-browser skill into Claude, Codex, or another supported harness; webcmd plugin search and webcmd plugin install github:agentrhq/webcmd-plugins/<name> manage site adapters.
- Developers building research agents that compare discussions across Hacker News, Reddit, and PubMed and return summaries with source links
- Teams automating social media with logged-in state, e.g. collecting X bookmarks, summarizing LinkedIn unread messages, or monitoring TikTok posts using a named
socialprofile - Users of ChatGPT, Claude, Gemini, or NotebookLM who want an agent to retrieve conversations, notebooks, and generated materials from those tools
- E-commerce and procurement agents that look up Grainger parts by part number, compare Amazon/Blinkit/Zepto products, or check SAP Ariba purchase-order status
- Engineers running multiple agents against the same site in parallel, using immutable Session IDs and profile cookie jars to isolate browser state
- Teams frustrated by browser-agent token costs, who can turn recurring site navigation into CLI commands and spend their budget on the task itself
What are this agent's strengths and limitations?
- Learning architecture: site navigation knowledge is compiled into deterministic commands, so repeated tasks stop burning exploration tokens — up to 90% claimed savings
- Auditable benchmark results: on BU Bench V1's 100 tasks it leads in accuracy (67%), cost per completed task ($0.255), and agent turns (9.8), with methodology and reproduction steps published
- Profile/Session model natively supports parallel agents: Session IDs are immutable and profile-scoped, with cookie isolation for login state
- A plugin-based site adapter ecosystem that can be searched and installed on demand, with a documented path for publishing community plugins
- The npm package ships zero site adapters — every site requires searching and explicitly installing a plugin, adding cold-start configuration cost
- Webcmd Cloud (hosted command and browser session execution) is in active development and not yet stable, so a managed deployment path is immature
- Requires a Node.js 20.6+ runtime and a real browser engine; benchmarks used the CloakBrowser engine, so local browser dependencies need verification
- Benchmark results come from a self-built, stronger judge (Codex gpt-5.4) rather than the original BU Bench setup (Gemini 2.5 Flash judge), so cross-tool comparisons warrant caution
- The
webcmd-browserskill loads into your agent's context and should only be loaded for live browser work
How do you install or deploy this agent?
- Ensure Node.js 20.6+ is installed. 2. Install the core globally:
npm install -g @agentrhq/webcmd. The npm package ships core and browser commands but no site adapters. 3. Install adapters as needed:webcmd plugin search <site> -f, thenwebcmd plugin install <installSource-from-search>(community adapters use the formwebcmd plugin install github:agentrhq/webcmd-plugins/<name>; Webcmd 0.7.11+ is required for the standalone plugin catalog). 4. Install the browser skill into your agent harness: runwebcmd skills addand choose Claude, Codex, another supported harness, or a custom skills path.
How do you use this agent?
The simplest start is to give your agent this prompt: "Fetch and follow https://raw.githubusercontent.com/agentrhq/webcmd/main/start.md to set up Webcmd end to end." Then issue natural-language instructions such as "Use webcmd to research agentic browser automation on PubMed and return title, authors, publication date, abstract, and URL for each result." For explicit browser sessions: webcmd --profile work session create "Work Project" -f ; webcmd --profile work --session <id> browser tabs; webcmd --profile work --session <id> browser run --file explore.js for multi-step exploration; printf 'return await page.title();' | webcmd --profile work --session <id> browser run --stdin for inline scripts; webcmd --profile work session close <id> to close. Adapter commands without --session reuse the profile's adapter-default session; raw browser commands require an explicit readable Session ID. After one exploration, ask the agent to create a stable webcmd <site> command that later agents can reuse.
How does this agent compare with similar options?
The README benchmarks Webcmd directly against other browser automation tools in the browser-use ecosystem's BU Bench V1, where it leads in accuracy, cost per completed task, and agent turns. Its differentiator is compiling site knowledge into deterministic CLI commands rather than re-browsing on every run.
FAQ
How much token savings can I expect?
Does it support logged-in (cookie) operations?
work, social). Adapter commands default to the profile's adapter-default session, and parallel agents should create separate Sessions.What if there is no plugin for my site?
webcmd plugin search <site> -f . If none exists, the agent can explore the site live with webcmd browser, gradually building sitemap memory and authoring a custom webcmd <site> adapter.What runtime and permissions does it need?
webcmd skills add installs exactly one webcmd-browser skill, while adapter, search, fetch, and plugin commands work directly on the CLI.