Skip to content

jev-browser 0.1.0

Choose a tag to compare

View all tags
@ChenYCL ChenYCL released this 22 Sep 06:47
· 18 commits to main since this release
v0.1.0
225f288

jev-browser 0.1.0

First release of jev-browser: browser use / computer use for coding agents where
TypeSafe Jev supplies calibrated per-step judgments and a code controller
owns memory, budgets and termination (the split introduced by
NanoJev).

Highlights

  • Backends: ego lite (default; reuses your logged-in sessions, hands the tab to you on blockers, resumes with --space-id), Chrome via CDP (launch or attach, headless), Safari via safaridriver.
  • Interfaces: CLI (run, observe, judge, pick, doctor, config, install, mcp) and a dependency-free MCP stdio server (jev_browse, jev_observe, jev_judge, jev_pick, jev_doctor, jev_config).
  • Agents: one command installs into Claude Code, Codex, Cursor, the skills.sh directory and Claude Desktop (MCP), with backups, --dry-run and --uninstall.
  • Safety: typed values are selected from inputs, never generated; secrets never reach the model or the journal; step / cost / time budgets; local JSONL journals.
  • Zero dependencies: Node 22+ and TYPESAFE_API_KEY.

Verified

  • Unit suite + e2e scenarios per backend against a fixture site (navigation, search + typing, login with a secret, choosing among identical buttons, cart, form + dropdown, scroll-to-reveal, blocker hand-off, limits), CLI round-trip, ego hand-off → resume.
  • macOS with live Jev: 54 passed / 0 failed / 5 skipped (Safari opt-in), three consecutive identical runs; ~$0.02 per full suite.
  • GitHub Actions on ubuntu-latest with the mock judge and headless Chrome.
  • Real sites via ego lite: TypeSafe docs → Choice page (2 steps, $0.0005); GitHub → docs/ATOMIC_PLANNING.md (4 steps, $0.0016).

Install

git clone https://github.com/ChenYCL/jev-browser-skill.git && cd jev-browser-skill
export TYPESAFE_API_KEY=...
node skills/jev-browser/bin/jev-browser.mjs doctor
node skills/jev-browser/bin/jev-browser.mjs install

Or: claude plugin marketplace add ChenYCL/jev-browser-skill && claude plugin install jev-browser@jev-browser-skill,
or npx skills add ChenYCL/jev-browser-skill --skill jev-browser.
The attached jev-browser-skill-0.1.0.zip is the bare skill directory for manual installs.

Known limitations

Same-origin iframes and new tabs are not followed; canvas / drag-and-drop / uploads are not handled; Safari is implemented to the WebDriver spec but not yet exercised live; goals should be in English for best accuracy.

Full changelog: CHANGELOG.md

Assets 3
Loading