# AML documentation

Build, understand, and operate typed agent workflows with Agent Markup Language.
Canonical: https://agent-markup-language.com/docs/
Documentation index: https://agent-markup-language.com/docs/
Complete documentation: https://agent-markup-language.com/docs/llms.txt

**Documentation shortcuts**

- [FAQ](https://agent-markup-language.com/docs/faq/)
- [Examples](https://agent-markup-language.com/docs/examples/)
- [CLI](https://agent-markup-language.com/docs/cli/)
- [Agent skill](https://agent-markup-language.com/docs/agent-skill/)
- [Providers](https://agent-markup-language.com/docs/providers/)
- [Cookbook](https://agent-markup-language.com/docs/cookbook/)
- [Reference](https://agent-markup-language.com/docs/reference/)

- [Full documentation for agents](https://agent-markup-language.com/docs/llms.txt) — Give an agent the complete AML documentation in one plain-text file.

- [Project llms.txt](https://agent-markup-language.com/llms.txt) — Share the concise project overview and links to the full agent documentation.

AML is an asynchronous TypeScript and JSX runtime for building executable agent workflows. JSX describes the dependency tree; [`AmlRuntime`](https://agent-markup-language.com/docs/reference/runtime/) evaluates it, opens scoped resources, runs provider sessions, and cleans up in reverse order. It is not a UI framework or a second workflow language—ordinary TypeScript owns control flow, while [`<Parallel>`](https://agent-markup-language.com/docs/reference/primitives/parallel/) explicitly marks independent AML branches.

## Install AML

**Application runtime**

### Install the SDK

Add the public ESM package to a Node.js 26+ TypeScript project.

```sh
npm install @aml-jsx/sdk
```

Prefer an executable workflow file without application glue? Use the [experimental AML CLI](https://agent-markup-language.com/docs/cli/).

[Configure TSX and run a credential-free workflow →](https://agent-markup-language.com/docs/getting-started/)

**Coding agents**

### Install the AML authoring skill

Give a compatible coding agent the repository-backed AML API, composition, provider, and security guidance.

```sh
npx skills add \
  we-are-singular/aml \
  --skill aml-jsx
```

The skill guides the agent; your project still needs the SDK and its selected provider executables.

[Install, verify, and use the skill →](https://agent-markup-language.com/docs/agent-skill/)

Start with the [credential-free tutorial](https://agent-markup-language.com/docs/getting-started/), then use the provider guides and cookbook to assemble a production workflow. Search the complete documentation with `Ctrl` + `K`.