# Agentside

> Serve markdown twins of your pages to AI agents and A/B test what they read. An Effect-based SDK by Notra.

## Docs

- [Introduction](https://agentside.usenotra.com/docs): Agentside serves markdown twins of your pages to AI agents and lets you A/B test what each agent reads.
- [Quickstart](https://agentside.usenotra.com/docs/quickstart): Install Agentside, describe your markdown twins and mount the handler in front of your app.
- [Routes and sources](https://agentside.usenotra.com/docs/routes): Map page paths to literal, local, remote and parameterized markdown sources.
- [Content negotiation](https://agentside.usenotra.com/docs/negotiation): How Agentside decides whether a request gets markdown or HTML and which headers it sets.
- [A/B variants](https://agentside.usenotra.com/docs/variants): Serve different markdown twins to different AI agents and record which variant each agent read.
- [Error handling](https://agentside.usenotra.com/docs/error-handling): Fallbacks, retries, timeouts and typed errors that keep a broken twin from reaching an agent.
- [Caching](https://agentside.usenotra.com/docs/caching): How Agentside caches rendered twins in memory and how to tune or disable the cache.
- [Effect API](https://agentside.usenotra.com/docs/effect): Use the Effect program behind Agentside directly through agentside/effect.
- [Migrating from Dualmark](https://agentside.usenotra.com/docs/migrating-from-dualmark): Map a Dualmark route handler and middleware to Agentside routes and a single handle call.
- [API reference](https://agentside.usenotra.com/docs/api-reference): Every export of agentside and agentside/effect with its signature and defaults.

## Framework guides

- [Framework guides](https://agentside.usenotra.com/docs/frameworks): Mount Agentside in any framework that hands you a fetch Request and lets you return a Response.
- [TanStack Start](https://agentside.usenotra.com/docs/frameworks/tanstack-start): Serve markdown twins from a TanStack Start request middleware.
- [Astro middleware](https://agentside.usenotra.com/docs/frameworks/astro): Serve markdown twins from Astro middleware on on-demand rendered pages.
- [Next.js middleware](https://agentside.usenotra.com/docs/frameworks/nextjs): Serve markdown twins from Next.js middleware or proxy.ts.
- [Hono](https://agentside.usenotra.com/docs/frameworks/hono): Serve markdown twins from a Hono middleware.
- [Cloudflare Workers and Bun.serve](https://agentside.usenotra.com/docs/frameworks/workers-and-bun): Put Agentside in front of a plain fetch handler on Cloudflare Workers or Bun.

## Agent skills

- [agentside](https://agentside.usenotra.com/docs/.well-known/agent-skills/agentside/SKILL.md): Read the Agentside docs instead of answering from memory. Serve markdown twins of your pages to AI agents and A/B test what they read. An Effect-based SDK by Notra. Use when a task involves Agentside: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://agentside.usenotra.com/docs/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://agentside.usenotra.com/docs/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://agentside.usenotra.com/docs/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://agentside.usenotra.com/docs/openapi.json.
- [Agent skills](https://agentside.usenotra.com/docs/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://agentside.usenotra.com/docs/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://agentside.usenotra.com/docs/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://agentside.usenotra.com/docs/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://agentside.usenotra.com/docs/sitemap.xml): Every indexable page URL with its last-modified date.