Skip to content
aml/Docs

AML documentation

The practical guide to composing agents, capabilities, sandboxes, and durable workspaces with TypeScript and JSX.
Build your first workflowView on GitHub
View as MarkdownAsk Claude about this pageAsk ChatGPT about this page
Full documentation for agentsGive an agent the complete AML documentation in one plain-text file.
Project llms.txtShare 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 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> explicitly marks independent AML branches.

Install AML

Section titled “Install AML”

Application runtime

Install the SDK

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

Terminal window
npm install @aml-jsx/sdk

Prefer an executable workflow file without application glue? Use the experimental AML CLI.

Configure TSX and run a credential-free workflow →

Coding agents

Install the AML authoring skill

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

Terminal window
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 →

Start with the credential-free tutorial, then use the provider guides and cookbook to assemble a production workflow. Search the complete documentation with Ctrl + K.