# Axx

> Axx (github.com/nimbusxr/axx, "axxeptance") is an open-source acceptance testing framework, the behavioral verification layer for agentic software factories: it verifies running systems black-box, against executable acceptance criteria written in Gherkin, across APIs, events, data, native apps and AI.

- Every page is also available as Markdown: append `.md` to its path (for example `https://axx.nimbusxr.us/tutorials/quickstart.md`).
- Never invent step text. Search the step index (`/references/step-index/`) or run `axx steps search "<intent>"`, then validate with `axx validate`.
- Agent skills: `/.well-known/agent-skills/index.json`. JSON Schema for axx.yaml: `/schemas/v0/axx.schema.json`.
- Axx is pre-release (v0.x): interfaces may change before v1.0.0.

## Documentation Sets

- [Abridged documentation](https://axx.nimbusxr.us/next/llms-small.txt): a compact version of the documentation for Axx, with non-essential content removed
- [Complete documentation](https://axx.nimbusxr.us/next/llms-full.txt): the full documentation for Axx
- [Tutorials](https://axx.nimbusxr.us/next/_llms-txt/tutorials.txt): quickstart, a first suite, and testing with a coding agent
- [Guides](https://axx.nimbusxr.us/next/_llms-txt/guides.txt): task guides: services, CI, REST requests (redirects, cookies), webhooks and tokens (signatures, JWT, OAuth 2.0), OpenAPI, mocks, AI features (mocked models), MCP servers, A2A agents, SQL, MongoDB, Redis, Kafka, AMQP, MQTT, NATS, WebSockets, server-sent events, logs, files, emails, commands, web apps in real browsers (pages, checks, sign-in, screenshots, accessibility, network, Lighthouse, coverage, watching and traces), Android apps on emulators (Appium, deep links, a device and a clean app per scenario), cloud services (AWS, Google Cloud, Azure), test data, packs, custom steps, debugging, agents
- [References](https://axx.nimbusxr.us/next/_llms-txt/references.txt): generated reference of the packs (settings, steps, agent tools), the steps' grammar, the CLI and error codes, axx.yaml, JSON output and exit codes
- [Explanations](https://axx.nimbusxr.us/next/_llms-txt/explanations.txt): why Axx, how it works: black-box testing, isolation, step design, web browsers, OpenAPI, agents

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation