Fluxon Docs
Reference

For AI Agents

How to consume these docs as raw Markdown — automatically, no flags needed.

These docs are built for AI agents as much as for humans. Any page is available as raw Markdown, and agents get it automatically — no query parameter, no special knowledge required.

Just use the page URL

When a human copies a docs URL and hands it to an agent, the agent fetches it with curl (or a fetch tool). The server detects a non-browser client and returns raw Markdown instead of HTML:

curl https://docs.fluxon-lang.com/docs/batteries/http
# → returns the raw Markdown of the http battery page

A browser visiting the same URL gets the full styled HTML page. Same URL, two representations — chosen by the request, not by you.

Or ask for Markdown explicitly

Three equivalent ways to force Markdown:

# 1. Append .md to any docs path
curl https://docs.fluxon-lang.com/docs/batteries/http.md

# 2. Send an Accept header
curl -H "Accept: text/markdown" https://docs.fluxon-lang.com/docs/batteries/http

Whole-site bundles

For loading the entire documentation into a context window:

  • /llms.txt — a structured index of every page (titles, URLs, descriptions). Start here to discover what exists.
  • /llms-full.txt — every page's full Markdown concatenated into one document. Drop the whole language into your context in a single request.

The compact spec

If you want the single, canonical, token-minimal description of the language — the file an agent reads to learn Fluxon — use the Agent Spec. It is the authoritative reference, organized for machine consumption rather than narrative reading.

On this page