@ahtmljs/vite

Vite plugin for AHTML — RSS for AI agents.

Adds three endpoints to any Vite-based dev server or built site:

• /ahtml/<path> — token-optimal AHTML snapshot (compact text / JSON / diff)
• /.well-known/ahtml.json — site manifest
• /llms.txt — Jeremy Howard convention shim

Works with SvelteKit, SolidStart, vanilla Vite, and anything that accepts a Vite plugin.

npm install @ahtmljs/vite @ahtmljs/schema

📊 How well does an AI read it?

We asked an AI 20 questions about the same page — given in 4 different formats:

| Format you give the AI | Tokens used | Right answers | |---|---:|---:| | Plain HTML | 684 | 91% | | llms.txt | 227 | 89% | | AHTML compact | 338 | 95% | | AHTML JSON | 365 | 100% ✓ |

AHTML JSON: every answer right. AHTML compact: ~50% fewer tokens than HTML — and still more accurate.

• Real API calls to gpt-4o-mini, claude-haiku-4.5, gemini-2.5-flash, llama-3.3-70b at temperature=0.
• 20 hand-graded questions an AI agent actually wants to know: price, in stock?, SKU, return window, confirmation needed?, author, publication date, etc.
• Tokens counted with the official OpenAI + Anthropic tokenizers (gpt-tokenizer, @anthropic-ai/tokenizer). No text.length/4 guessing.
• Cost from real provider usage × public prices.
• Reproduce: git clone https://github.com/DibbayajyotiRoy/AHTML && cp .env.example .env && bash scripts/run-llm-benchmark.sh

Full report · Source

Quickstart

// vite.config.ts
import { defineConfig } from 'vite';
import { ahtml } from '@ahtmljs/vite';
import { snapshot } from '@ahtmljs/schema';
import { db } from './src/lib/db';

export default defineConfig({
  plugins: [
    ahtml({
      site: 'https://shop.com',
      policy: { agents_welcome: true, license: 'MIT', rate_limit: '100/min' },
      routes: [
        { path: '/', page_type: 'home' },
        { path: '/products/mbp-14', page_type: 'product_detail' },
      ],
      async buildSnapshot(segments, req) {
        if (segments[0] === 'products' && segments[1]) {
          const p = await db.product(segments[1]);
          if (!p) return null;
          return snapshot(req.url, 'product_detail')
            .ttl(60)
            .add({
              id: `product:${p.slug}`,
              type: 'product',
              name: p.name,
              price: { amount: p.price, currency: 'USD' },
              stock: { status: p.qty > 0 ? 'in_stock' : 'out_of_stock', quantity: p.qty },
            })
            .action({
              id: 'purchase',
              target: `product:${p.slug}`,
              category: 'transact',
              execute_url: '/api/checkout',
              auth: 'required',
              cost: { amount: p.price, currency: 'USD', category: 'purchase' },
              reversible: { reversible: true, window: 'P30D', policy: 'full_refund' },
              side_effects: ['charge_card', 'email_buyer', 'decrement_stock'],
              confirmation: 'required',
            })
            .build();
        }
        return null;
      },
    }),
  ],
});

That's it. Visit:

• http://localhost:5173/ahtml/products/mbp-14 → typed snapshot
• http://localhost:5173/.well-known/ahtml.json → site manifest
• http://localhost:5173/llms.txt → markdown shim
• http://localhost:5173/ahtml/mcp.json → MCP tool manifest

Configuration

| Field | Type | Default | Description | |---|---|---|---| | site | string | required | Canonical public site URL | | buildSnapshot | function | required | Returns a Snapshot (or null) for a given path | | policy | Policy | { agents_welcome: true } | Site-level rules — license, rate_limit, contact, etc. | | default_ttl | number | 60 | Default TTL in seconds for snapshots that don't override | | routes | Array<{path, page_type}> | [] | Routes advertised in /.well-known/ahtml.json | | llms_contact | string | policy.contact | Email shown in /llms.txt | | emit_mcp | boolean | true | Auto-emit /ahtml/mcp.json | | emit_openapi | boolean | true | Auto-emit /ahtml/openapi.json |

Compatibility

• Vite 5+ (peer dependency)
• Node 20+ dev server
• Works in any Vite-driven framework: SvelteKit, SolidStart, vanilla Vite

For Next.js, use @ahtmljs/next instead. For Astro, an @ahtmljs/astro integration is in development.

Same contract, every framework

The buildSnapshot signature is identical to @ahtmljs/next/handler — you can swap frameworks without rewriting your snapshot logic.

License

MIT — see the main AHTML repository for full docs.