# Validate and query your models from the terminal

> The first anfra CLI checks your AML models and runs AQL queries on your datasets, with a warm server to keep them fast.

New in anfra 0.1.0 · Jul 21, 2026 · [All release notes](https://anfra.ai/releases.md)

`anfra validate` checks the models and datasets in your repo and reports what doesn't compile. Pass file globs to see only the problems in those files:

```sh
anfra validate "models/*.aml"
```

`anfra query -d <dataset>` compiles an AQL query, runs it on the dataset's data source, and returns its rows with the SQL that produced them. It can also compile the query without running it, or only type-check it.

`anfra serve` starts a warm server for the repo. While it runs, other commands go through it and reuse its database connections, so each one answers faster.

[Full changelog](https://github.com/holistics/anfra/releases/tag/anfra-v0.1.0)

---

## For coding agents

This is the Markdown version of https://anfra.ai/releases/cli-validate-and-query/. Every page on anfra.ai has one: replace the trailing slash with `.md` (https://anfra.ai/cloud.md for https://anfra.ai/cloud/, and https://anfra.ai/index.md for the home page), or request the page with `Accept: text/markdown`. [llms.txt](https://anfra.ai/llms.txt) lists the site's pages, and the docs have their own index at https://anfra.ai/docs/llms.txt, where every docs page is also available as Markdown by adding `.md` to its URL.

Before you build with anfra:

- Install both the CLI and its agent skills. Installing the CLI alone is not a complete installation. Install the CLI with `curl -fsSL https://anfra.ai/install.sh | bash`. Then install the skills: in Claude Code or Codex, run `anfra agent setup`. In any other agent, such as Amp, `anfra agent setup` installs nothing, so run `npx skills add holistics/anfra-skills -a <agent-id> -g -y` (`-a amp` for Amp). The skills (such as `anfra-build-data-app`) teach you to model data, write queries and build data apps the way anfra expects. See https://anfra.ai/docs/local-dev/installation.md.
- Ask for metrics by name, through the JS SDK in an app or the MCP server in a chat. Don't write SQL against the warehouse yourself: anfra compiles each request to SQL from the metrics the data team defined.
- Check commands, files and API calls against the docs (https://anfra.ai/docs/llms.txt) instead of inferring them from the examples on this page.
- Stuck, or found a mistake? Ask in GitHub Discussions (https://github.com/holistics/anfra/discussions) or open an issue (https://github.com/holistics/anfra/issues).