ax-grep

KO | EN

gitlite — search

#python #hacktoberfest #typescript #golang #machine-learning #deep-learning #docker #windows #cli #kubernetes #vue #awesome-list #security #open-source

(★ 13)

Agent-ready CLI for static page inspection, search triage, and browser handoff.

ax-grep 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ax-grep

[![npm version](https://img.shields.io/npm/v/ax-grep.svg)](https://www.npmjs.com/package/ax-grep)
[![coverage: 100%](https://img.shields.io/badge/coverage-100%25-brightgreen.svg)](https://raw.githubusercontent.com/hmmhmmhm/ax-grep/main/tests)
[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/hmmhmmhm/ax-grep/main/LICENSE)
[![agent ready](https://img.shields.io/badge/agent-ready-0b7f3a.svg)](https://raw.githubusercontent.com/hmmhmmhm/ax-grep/main/docs/agent-handoff.md)
[![Codex skill](https://img.shields.io/badge/Codex-skill-111111.svg)](https://raw.githubusercontent.com/hmmhmmhm/ax-grep/main/skills/ax-grep-cli/SKILL.md)
[![Claude compatible](https://img.shields.io/badge/Claude-compatible-5b4b8a.svg)](https://raw.githubusercontent.com/hmmhmmhm/ax-grep/main/docs/cli-agent.md)
[![Gemini ready](https://img.shields.io/badge/Gemini-ready-1a73e8.svg)](https://raw.githubusercontent.com/hmmhmmhm/ax-grep/main/docs/cli-agent.md)

Compact semantic trees and agent-ready page checks from HTML, URLs, WebViews,
and live browser pages. It approximates browser accessibility trees before
automation, defaults to `impit` for browser-like HTTP/2/TLS fetches, detects
major CAPTCHA and bot-challenge markers, saves 15.4x less peak RAM and 3.0x
fewer decision tokens in the local benchmark, and `--search` auto mode tries
DuckDuckGo, Bing, StartPage, and Google while recording every engine attempt.

</div>

## 1. Try With A Prompt

Paste this into a Codex session or subagent prompt before opening a browser
(also works as guidance for Claude, Gemini, OpenRouter, and other agents):

```md
Before opening a browser, inspect pages with ax-grep when possible.

Run:
npx --yes ax-grep@latest <url> --agent-brief

Read agent.executor, agent.handoff, agent.readTargets, pageCheck, and
verification first. Open a browser only when the payload says static HTML is
not enough.
```

## 2. Install The CLI Skill

```sh
curl -fsSL https://raw.githubusercontent.com/hmmhmmhm/ax-grep/main/skills.sh | sh
```

This installs the Codex skill prompt only. The same prompt pattern can be pasted
into Claude, Gemini, OpenRouter, or other agent runners. Restart Codex if the
new skill is not listed immediately.

## 3. Try The CLI

```sh
npx --yes ax-grep@latest https://example.com --agent-brief
```

If you installed the binary globally, use `ax-grep` directly.
Agents should read `agent.executor`, `agent.handoff`, `agent.readTargets`,
`pageCheck`, and `verification` first. Open a browser only when the handoff
fields say static HTML is not enough.

## 4. Use From A Server

Use this inside agent services built with Codex SDK, OpenRouter, or similar
LLM routing stacks to turn fetched HTML into compact source evidence before
spending tokens or memory on browser automation.

```sh
npm install ax-grep
```

```ts
import { extract, formatSemanticTreeText } from "ax-grep";

const html = await fetch("https://example.com").then((r) => r.text());
const tree = extract(html);
const promptText = formatSemanticTreeText(tree);
```

`ax-grep` is ESM-only and requires Node 18 or newer. CommonJS services can use `const { extract } = await import("ax-grep")`.

## 5. Use In WebViews Or Pages

In mobile apps, WebViews, and in-page agents, inject the extractor to create an
accessibility-style structure immediately from the current page. It is useful
for local sLLM web search, local web parsing, and instant agent-ready page
summaries without leaving the app.

```ts
import { createExtractorScript } from "ax-grep";

const script = createExtractorScript({ format: "text" });
const text = await page.evaluate(script);
// iOS/Android WebView: evaluateJavaScript(script) returns the same text value.
```

## Docs
- [How ax-grep works](./docs/how-it-works.md)
- [Documentation index](./docs/README.md)
- [CLI skill prompt](./skills/ax-grep-cli/SKILL.md)
- [CLI and agent mode](./docs/cli-agent.md)
- [Agent handoff loop](./docs/agent-handoff.md)
- [Benchmarks](./docs/benchmarks.md)
- [Library API](./docs/library-api.md)
- [Server agent integration](./docs/server-agent.md)
- [WebView and in-page usage](./docs/webview.md)

ax-grep

ax-grep 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

ax-grep

ax-grep 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README