Skip to content

Jev directory

Jev Ego

A TypeScript browser agent for ego lite that turns one natural-language goal into CLICK, TYPE_TEXT, or SELECT on a numbered element table, with Jev choosing the operation and target in one request.
Stars
17
Language
TypeScript
Reading time
3 min
Published by
Community
Author
romaluev
Last verified
Sep 2026

About this project

TypeScript browser agent for ego lite — Jev Ultrafast's indexed action space, without Chrome, Playwright, or Browser Harness. Give it one natural-language goal. A coding agent (or TypeSafe Jev) picks CLICK / TYPETEXT / SELECT on a numbered element table. The whole loop — TypeSafe, the text helper, and CDP — runs inside one ego-browser nodejs process.

Quoted from the project's README. Read the full README.

Highlights

  • One TypeSafe request returns the operation and its target together; speculative target questions put two decisions in one network round trip.
  • The whole loop - TypeSafe, the text helper, and CDP - runs inside one ego-browser nodejs process, with no Python process or Browser Harness hop.
  • No screenshots: Jev consumes a structured element table, and visible controls, names, values, and text are read in one browser call per snapshot.
  • Commands include serve, observe, act, suggest, step, run, flights, smoke, probe, and stop; serve keeps one TaskSpace in a loopback daemon.
  • A first snapshot after navigation costs 3 CDP calls, and shadow roots, frames, canvas, uploads, and pop-up tabs stay outside the MVP.

Quickstart

bash
pnpm install
pnpm build
cp .env.example .env   # add TYPESAFE_API_KEY and TEXT_MODEL_API_KEY
pnpm exec jev-ego serve --url https://en.wikipedia.org/wiki/Main_Page --goal 'Find and open the article about Gödel’s incompleteness theorems.'
pnpm exec jev-ego step
pnpm exec jev-ego stop

Watch out

MIT-licensed and not a general web-automation SDK; needs macOS with ego lite installed, ego-browser on PATH, Node 20+ and pnpm, plus TYPESAFE_API_KEY and a TEXT_MODEL_API_KEY for typing.

Questions about this entry

Short answers drawn from the linked project or page.

Reactions & coverage

Posts, threads, and videos about this entry from around the web.

X: Text-to-screenshot (Malay Vasa)

X: Google's MediaPipe Decision Maker, tested in the browser

X: Playwright CLI + Jev vs Playwright MCP

X: jev-ultrafast splits every browser decision into operation, target and value. JEV passed 18,000 stars in its…

From the Jev guides

Original write-ups on what this entry is for.

From the Jev AI model community

Posts from builders shipping with Jev right now.

Follow @typesafeai