jevfetch

Use it instead of WebFetch: agent runs take 43 to 49% less time than with WebFetch on Haiku 5.5 and find the same facts. Against WebFetch on Haiku 4.5, they also cost 43 to 44% less.

한국어 | Quick start | Command-line use | Python API | More agent setup

Why jevfetch

Passing the whole page eats context and costs more. A paraphrase can't be quoted, and checking it means reading the page again.

jevfetch splits the page into blocks and asks TypeSafe's judgment model Jev whether each block answers the question. It returns the blocks judged to answer it, plus the first block, exactly as they appear on the page.

We compared it with Claude Code's WebFetch on 30 documentation questions, giving the page URL with each question and running every question twice in Korean and twice in English (2026-10-09, Claude Code 2.1.295, Sonnet 5.5):

The answers must contain 58 facts, checked in both runs, so 116 checks per language. jevfetch and WebFetch on Haiku 5.5 passed all 116 in both languages; WebFetch on Haiku 4.5 missed two in Korean. Against Haiku 5.5, the 95% interval of the cost ratio includes no difference in either language. Two more questions are left out because their sites serve Markdown, which WebFetch hands over whole without its model; on those, WebFetch found every fact and jevfetch missed one Redis EXPIRE fact in every run.

At the tool level, asked for a specific fact, jevfetch returned the reference sentence verbatim in 81 of 81 outputs, against 25 of 81 for a single WebFetch call and 32 of 81 when WebFetch read further windows (27 English questions, three runs each, 2026-10-09, Claude Code 2.1.294). Full conditions and limits are in bench/RESULTS.md.

Example

jevfetch https://docs.python.org/3/library/functools.html "What happens if lru_cache maxsize is None?"

Output (trimmed):

# jevfetch: https://docs.python.org/3/library/functools.html
# status: filtered (blocks are quoted from the page; '##' lines are the page's heading path)
# 8/133 blocks, 461 of 7141 tokens
## functools — Higher-order functions and operations on callable objects
Source code: [Lib/functools.py](https://github.com/python/cpython/tree/3.14/Lib/functools.py)
## functools — Higher-order functions and operations on callable objects > @functools.lru_cache(maxsize=128, typed=False)
Decorator to wrap a function with a memoizing callable that saves up to the maxsize most recent calls. ...
If maxsize is set to None, the LRU feature is disabled and the cache can grow without bound.
...

Each ## line is the heading path of the passage below it. Definition-list terms such as function signatures are part of the path, so the agent can tell that the sentence about maxsize=None belongs to lru_cache.

The text is copied from the page. The only changes jevfetch makes are:

• collapsing runs of whitespace
• writing links as [text](url)
• separating table cells with |
• adding - before list items merged into one block
• adding the ## lines

JSON and XML are re-serialized, so whitespace, escapes, and number notation in those blocks can differ from the source. For example, 1.10 prints as 1.1.

Quick start

The jevfetch skill installs into Claude Code, Codex, and many other coding agents with the skills CLI. These steps are for Claude Code. You need uv, Node.js (for npx), and a TypeSafe API key (see API key).

1. Install the jevfetch skill in your project. The skill tells Claude Code to read web pages with jevfetch, including pages it found with WebSearch, and what to do with each status. Without it, Claude Code keeps using WebFetch.

   npx skills add a2sys-ai/jevfetch --skill jevfetch -a claude-code
   

2. Let jevfetch run without a permission prompt. Add this to .claude/settings.json in your project. If the file already exists, just add the entry to permissions.allow.

   {
     "permissions": {
       "allow": ["Bash(jevfetch:*)"]
     }
   }
   

API key

Add your API key to your shell profile. The command below is for zsh; for bash, use ~/.bashrc. Then open a new terminal and start Claude Code from it.

echo 'export TYPESAFE_API_KEY=<your key>' >> ~/.zshrc

Now open Claude Code in that project and ask something that needs a look at the docs. If the jevfetch command is missing, Claude Code installs it the first time, and asks before doing so unless your settings already allow it.

To set up other agents, install without Node.js, or turn WebFetch off, see More agent setup.

Command-line use

To install it yourself (Python 3.12 or later):

uv tool install jevfetch

Chrome or Chromium is optional. If present, it's used for pages that load their content with JavaScript.

Run it with a URL and a question, as in the example. The # lines at the top of the output report the status:

If a Jev request fails (missing key, no credits), jevfetch exits with code 2.

Options:

• --json: print the result as JSON, with token counts and Jev usage
• --no-render: don't fall back to a headless browser
• --model: set the Jev model

The command takes a URL. For HTML, Markdown, or plain text you already have, use the Python API. jevfetch doesn't pick passages from PDFs and other binary files. Like WebFetch, it saves them and prints the path, so the agent can open them with its file reader.

More agent setup

The skills installer works with Claude Code, Codex, and many other coding agents, and needs Node.js. By default it installs into the current project. Add -g to install it for all your projects, and use -a <agent> to pick the agents.

mkdir -p ~/.claude/skills/jevfetch
curl -fsSL https://raw.githubusercontent.com/a2sys-ai/jevfetch/main/skills/jevfetch/SKILL.md -o ~/.claude/skills/jevfetch/SKILL.md

Turning WebFetch off

With WebFetch off, Claude Code reads every page with jevfetch. Add a deny rule to .claude/settings.json in the project, or to .claude/settings.local.json to apply it only to yourself. For a single session, start Claude Code with --disallowedTools WebFetch.

{
  "permissions": {
    "deny": ["WebFetch"]
  }
}

PDFs and other files still reach the agent: jevfetch saves them, and the agent opens the saved file with Read. jevfetch doesn't summarize whole pages, though, so keep WebFetch on in projects that need that.

Codex

Codex CLI and the Codex IDE extension block network access for commands by default, so both the first install and every jevfetch call fail until you allow it. Add this to ~/.codex/config.toml:

[sandbox_workspace_write]
network_access = true

Agents without skill support

Add these lines to the agent's instruction file (AGENTS.md, CLAUDE.md, and so on):

To get a specific fact from a web page, including pages found by web search, run `jevfetch <url> "<question>"` instead of fetching the whole page.
Its output is quoted from the page, so there is no need to fetch the page again to check it.
If the status is no_match, ask a more specific question or try another page. For a PDF or another file, jevfetch prints a `# saved:` line; open that file with your file reader.

When to use it

jevfetch is built for looking up specific facts on long pages: documentation, references, Wikipedia.

Use something else when:

• The task needs the whole page, like a summary or translation. jevfetch returns only parts of the page.
• The pages are short. Pages of 2,000 tokens or less come back whole, so you get nothing over fetching the page.
• The URL is a PDF, image, or other binary file. jevfetch picks passages only from HTML and text formats, and saves other files for the agent to open.

Privacy and security

• jevfetch sends the page text and your question to the TypeSafe API.
• The first time jevfetch runs on a machine, tiktoken downloads its cl100k_base encoding from openaipublic.blob.core.windows.net and caches it locally.
• Jev responses are cached in ~/.cache/jevfetch (change it with JEVFETCH_CACHE_DIR). The cache is safe to delete.
• PDFs and other binary files are saved in a jevfetch-<uid> folder in the system's temporary directory (change it with JEVFETCH_FILES_DIR).

How it works

1. Fetch the page. If the static HTML has less than 200 tokens of text, render it in headless Chrome.
2. Split the page into blocks, tag each with its heading path, and drop navigation, footers, and other page chrome. A sentence ending in a colon is merged with the list items that follow it under the same heading, up to 1,500 characters, so that a condition it states stays with the items. JSON is split by key and array item, and XML by element, with the key or tag path in place of the heading path.
3. Return documents of 2,000 tokens or less as they are.
4. First pass: group blocks into windows of about 3,000 tokens and send one Jev request per window, asking yes or no for each block. Blocks scoring 0.3 or higher become candidates.
5. Second pass: ask about each candidate again on its own, with up to 400 characters from each neighboring block as context. Keep blocks scoring 0.8 or higher.
6. Always keep the first block, since its heading path usually contains the page title. If the other kept blocks add up to fewer than 300 tokens, add the highest-scoring remaining blocks.

Requests within each pass run concurrently.

Configuration

The default model is the alias jev-latest, and the cache is keyed by that name, so after a model update the cache can still return answers from the previous model. For reproducible results, pin a model version with --model or Config(model=...).

Python API

from jevfetch import Config, fetch_relevant, select_relevant

res = fetch_relevant(url, "question")  # fetch, then select
res = select_relevant(html_or_text, "question")  # a document you already have
print(res.status, res.text, res.jev_input_tokens)

The async versions are fetch_relevant_async and select_relevant_async. Use Config to set the thresholds, window size, and Jev model. When the URL is a PDF or other file, res.saved holds the path where it was saved.

Development

A regression benchmark on real page snapshots runs in CI against recorded Jev responses and a baseline. Setup, tests, and re-recording are in CONTRIBUTING.md, and the benchmark and the WebFetch comparisons are in bench/README.md.

Disclosure

jevfetch is not affiliated with TypeSafe. a2sys received no funding, credits, or early access from TypeSafe.

License

MIT for the jevfetch code. The page snapshots under bench/pages/ and the sentences quoted in bench/cases.json and bench/agents/questions.json are third-party content; bench/pages/SOURCES.md lists their sources and licences.