git404hub

what is ax fr?

yusukebe/ax — explained in plain English

Analysis updated 2026-05-18

569TypeScriptAudience · developerComplexity · 2/5Setup · easy

tl;dr

A command line tool that fetches web pages and extracts structured data for AI coding agents, replacing throwaway scraping scripts with one deterministic command.

vibe map

mindmap
  root((ax))
    What it does
      Fetches web pages
      Reports full request status
      Discovers page structure
      Extracts structured rows
    Tech stack
      TypeScript
      Bun
      linkedom
    Use cases
      Scrape data for an AI agent
      Extract tables from web pages
      Read docs as markdown
      Replace curl in agent workflows
    Audience
      Developers
      AI agent builders
    Setup
      Install with shell script
      Or install via Nix
      Run ax with a URL

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Let an AI coding agent fetch and extract data from a web page without writing a custom script.

VIBE 2

Discover the repeating structure of a page before extracting data from it.

VIBE 3

Pull an HTML table into clean, structured rows of data.

VIBE 4

Read documentation pages as markdown with a token budget limit.

what's the stack?

TypeScriptBunlinkedom

how it stacks up fr

yusukebe/axamaancoderx/npxskilluigsync/jobsync
Stars569569577
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min
The README does not state a license for this project.

in plain english

ax is a command line tool built for AI coding agents that need to fetch a web page and pull structured information out of it, described by its author as the AI-era version of curl. Instead of an agent piping a raw page download into a throwaway script it has to write and debug each time, ax fetches a page, helps the agent understand what is on it, and extracts organized data in one step, all running locally on the user's own machine with no cloud service involved. A normal web request with curl often prints nothing useful when something goes wrong, leaving an agent guessing. ax instead always reports the status, headers, timing, and final URL of every request, even when the response is empty or an error. It also offers a discovery mode that shows the repeating patterns on a page, such as lists of items, without ever dumping raw HTML into the AI's context window, which would waste a large number of tokens. From there, a user or agent can extract multiple fields from each matching item in a single command, turn HTML tables into clean rows of data, or filter results with a simple expression. The tool is deliberately careful about token usage since it is meant to feed AI agents that have limited context space. Results are capped by default, and a budget option can limit output to an estimated number of tokens, with clear messages telling the agent exactly how to continue reading past a cutoff point. ax is installed with a single shell command or through the Nix package manager, and it can also teach an agent how to use it through a built in skill file. It is built using the Bun JavaScript runtime, compiled into a single binary, and uses the linkedom library for parsing HTML in a standard way. The README includes benchmark comparisons showing lower cost and time when Claude Code agents use ax compared to writing their own scraping scripts.

prompts (copy fr)

prompt 1
Help me install ax and use it to fetch a web page instead of curl.
prompt 2
Show me how to use the outline flag to discover a page's structure before extracting data.
prompt 3
Explain how to pull multiple fields from each item on a page using the row option.
prompt 4
Walk me through turning an HTML table on a page into structured rows with ax.
prompt 5
Show me how to limit ax output to a specific token budget for my agent's context window.

Frequently asked questions

what is ax fr?

A command line tool that fetches web pages and extracts structured data for AI coding agents, replacing throwaway scraping scripts with one deterministic command.

What language is ax written in?

Mainly TypeScript. The stack also includes TypeScript, Bun, linkedom.

What license does ax use?

The README does not state a license for this project.

How hard is ax to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ax for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.