inference-gateway

adl-cli: Scaffold A2A Agents from ADL Files

adl-cli generates Go, Rust, and TypeScript A2A agent servers from YAML Agent Definition Language files. It is aimed at teams that want configurable scaffolding for agent tools, integrations, and deployment workflows.

ActiveGoApache-2.0CLIAI AgentsCode Generation
Stars
15
Forks
2
Stars, last 30 days
+0
Last commit
3 days ago
Contributors
5

Our take

Activeregular commits and releases

Health score

77/100

How it is scored
Activity
90
Community
48
Issues
86
Pull requests
85

+0 stars in the last 30 days

  • Merges more pull requests than 98% of the projects we track
  • Releases more often than 93% of the projects we track
  • Closes issues faster than 81% of the projects we track

This is a recently active, frequently released generator with broad language support, but its own README warns that it is in early development and breaking changes are expected.

Good fit if

  • You want to generate an A2A agent server from a declarative ADL file rather than assemble the project scaffold yourself.
  • Your target language is Go, Rust, or TypeScript, and you want options for tools, services, skills, or deployment scaffolding.
  • You are comfortable evaluating an actively changing project; recent commits and releases indicate ongoing maintenance, with contributions from multiple people rather than dependence on one contributor.

Look elsewhere if

  • You need a stable generator with a guarantee against breaking changes, which the project does not claim at this early stage.
  • You need a target language other than Go, Rust, or TypeScript.
  • You want a ready-made agent rather than scaffolding that leaves TODOs for your implementation.
All health signals
Last commit2026-11-05 (3 days ago)
Commits, last 90 days100+
Releases, last 12 months100+ (latest v0.68.5, 2026-11-05)
Contributors5 (top contributor: 47% of commits)
Issues closed, last 90 days16+ (typically closed in 0 days)
Pull requests merged, last 90 days97 (typically merged in 0 days)
Project age16 months

Checked on 2026-11-09 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

15

Forks

2

Change since Nov 15, 2026: 0 stars·0 forks

Overview

adl-cli is a command-line tool for generating enterprise-ready Agent-to-Agent (A2A) servers from YAML files written in Agent Definition Language (ADL). It aims to reduce boilerplate and give teams consistent project scaffolding for agents built around the A2A protocol.

The generator supports Go, Rust, and TypeScript output. An ADL manifest describes an agent’s configuration, tools, services, skills, and optional development or deployment setup; the CLI validates the manifest and generates a project to customize.

Key Features

  • Scaffold agent projects from YAML ADL manifests, with schema validation.
  • Generate code for Go, Rust, and TypeScript, including agent tools and project configuration.
  • Support service injection, environment-based configuration, and multiple AI providers.
  • Generate optional CI/CD workflows and deployment configuration for supported platforms.
  • Add Flox and DevContainer development environments to generated projects.
  • Include optional OpenTelemetry instrumentation and, for Go agents, MCP client support.
  • Fetch or scaffold agent skills, and protect customized files during regeneration with .adl-ignore.

Use Cases

  • A team prototyping an A2A agent can define its tools and configuration in ADL, then generate a starter project instead of creating the initial structure by hand.
  • An organization building several agents in Go, Rust, or TypeScript can use shared scaffolding patterns to make their generated projects more consistent.
  • A developer integrating agent tools with services can start from generated interfaces and injection wiring, then fill in the business logic.
  • A team preparing an agent for deployment can generate supported CI/CD and deployment configuration alongside the application scaffold.

What you need

Detected in the repository

  • Go 1.26.8 or newer (from go.mod)
  • Automated checks on GitHub Actions

License in plain words

Apache-2.0permissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license, the NOTICE file and a note of your changes
  • Share your changes: no
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

With Node.js installed, try the recommended wrapper:

npx @inference-gateway/adl-cli init my-agent

Then generate a project from the resulting ADL manifest, for example with npx @inference-gateway/adl-cli generate --file agent.yaml --output ./my-agent. See the README for other installation methods, options, and examples.

Alternatives

  • AgentStack: AgentStack scaffolds Python agent projects with frameworks and development tools, while adl-cli generates Go, Rust, or TypeScript A2A servers from YAML definitions.
ProjectLanguageLicenseStarsStatus
adl-cliGoApache-2.015Active
AgentStackPythonMIT2.2kInactive

Considerations

The README explicitly describes the project as early development and warns that breaking changes are acceptable until a stable version. The repository is actively maintained, but that activity does not remove the need to assess generated output and migration impact before adopting it in a production workflow. The supplied requirements identify Go 1.26.8 as a runtime requirement; generated projects can target Go, Rust, or TypeScript. The project reports CI but does not report tests in its requirements data, so teams should verify their desired validation coverage. Its Apache-2.0 license permits broad use subject to that license’s terms.

Found this useful?

Share it with someone who would like adl-cli.

Comparisons