Reference
CLI
The a22a CLI deploys projects from a folder.
The CLI ships with the Node.js library, @a22a/sdk. To deploy from a pipeline, see Deploying from CI.
npx a22a deployCommands
a22a list [project] list every project under ./a22a/ and its workflows, or the one named
a22a deploy [project] deploy every project under ./a22a/, or the one named| Flag | Description |
|---|---|
--dir <path> | The projects folder. Default ./a22a. |
-v, --version | Print the version. |
-h, --help | Print usage. |
| Variable | Description |
|---|---|
A22A_API_KEY | Needed by deploy. |
A22A_DIR | The projects folder when --dir is not given. |
Layout
Every folder under the projects folder is a project. Every .json file in it is a workflow, named after the file. Folders starting with . are skipped.
a22a/
acme/
summarise.json
translate.jsonA workflow file holds its steps:
{
"steps": [
{ "id": "extract", "prompt": "Pull the key facts from {{input.text}}", "model": "anthropic/claude-haiku-4.5" }
]
}deploy checks every file before sending any, then deploys each project and prints its version and the URL of each workflow:
Deployed:
acme v2
summarise POST https://api.a22a.sh/v1/run/acme/summarise
translate POST https://api.a22a.sh/v1/run/acme/translate