aqua Documentation

aqua is a QA planning and execution service for AI coding agents. Describe what to test in natural language — the AI agent creates structured QA plans, executes them, and captures results on a web dashboard.

Get Started

Installation

Set up the server and CLI, and connect your coding agent. →

Quickstart

Walk through your first QA session — from setup to results. →

Guides

QA Plans

Data model, versioning, and status lifecycle. →

Environments

Variables, secrets, and proxy settings. →

Execution

Run plans via coding agent or CLI. →

Common Scenarios

Reusable scenario templates across QA plans. →

Project Memory

Accumulate knowledge across QA sessions. →

Organizations

Teams, members, and roles. →

Billing & Plans

Plans, quotas, and subscription management. →

Audit Log

Track organization and account activity. →

Reference

CLI

All aqua-cli commands and options. →

MCP Tools

All MCP tools exposed by aqua. →

Step Actions

HTTP and browser step action schemas. →

Assertions

HTTP and browser assertion types. →

Configuration

Config files and environment variables. →

Template Variables

Variable syntax, resolution, and TOTP support. →

Architecture

┌───────────────────┐
│  AI Coding Agent  │
│  (Claude Code …)  │
└────────┬──────────┘
         │ MCP
┌────────┴──────────┐      ┌──────────────────────────┐
│    aqua CLI       │ API  │       aqua Server         │
│  • MCP server     ├─────►│  • QA plan storage        │
│  • Test execution │      │  • Web dashboard          │
└───────────────────┘      └──────────────────────────┘

The CLI runs locally — it acts as an MCP server for AI agents and executes tests. Secrets never leave your machine. The Server stores plans and results, providing a web dashboard for your team.

For AI Agents

This documentation is available in LLM-friendly plain text format:

• llms.txt — Documentation index
• llms-full.txt — Complete documentation in a single file
• llms-small.txt — Abridged version for smaller context windows