The generated binary is a CLI. start boots the A2A server; --help and --version work as you'd expect.

# Run the agent
go run . start

# Or build and invoke the CLI directly
task build
./bin/documentation-agent --help
./bin/documentation-agent --version
./bin/documentation-agent start

# Or with Docker
docker build -t documentation-agent .
docker run -p 8080:8080 documentation-agent

Add this agent to your Inference Gateway CLI:

infer agents add documentation-agent http://localhost:8080 \
  --oci ghcr.io/inference-gateway/documentation-agent:latest \
  --run

• ✅ A2A protocol compliant
• ✅ AI-powered capabilities
• ✅ Streaming support
• ✅ State transition history
• ✅ Enterprise-ready
• ✅ Minimal dependencies

• GET /.well-known/agent-card.json - Agent metadata and capabilities
• GET /health - Health check endpoint
• POST /a2a - A2A protocol endpoint

Configure the agent via environment variables:

The following custom configuration variables are available. Defaults are derived from spec.config.* in agent.yaml; the env vars below override them at runtime.

# Generate code from ADL
task generate

# Run tests
task test

# Build the application
task build

# Run linter
task lint

# Format code
task fmt

The generator owns the baseline toolchain pins (SDK, server framework, logging, CLI, sandbox utilities). To extend the project without forking the templates, declare extras in agent.yaml - every empty list below is rendered by adl init --defaults precisely so it's discoverable:

Entries use the <package>@<version> form. Built-in pins always win on conflict; the generator prints a warning and skips the user entry when shadowing is attempted. After editing agent.yaml, re-run task generate to refresh the manifests.

Use the A2A Debugger to test and debug your A2A agent during development. It provides a web interface for sending requests to your agent and inspecting responses, making it easier to troubleshoot issues and validate your implementation.

docker run --rm -it --network host ghcr.io/inference-gateway/a2a-debugger:latest --server-url http://localhost:8080 tasks submit "What are your skills?"

docker run --rm -it --network host ghcr.io/inference-gateway/a2a-debugger:latest --server-url http://localhost:8080 tasks list

docker run --rm -it --network host ghcr.io/inference-gateway/a2a-debugger:latest --server-url http://localhost:8080 tasks get <task ID>

The Docker image can be built with custom version information using build arguments:

# Build with default values from ADL
docker build -t documentation-agent .

# Build with custom version information
docker build \
  --build-arg VERSION=1.2.3 \
  --build-arg AGENT_NAME="My Custom Agent" \
  --build-arg AGENT_DESCRIPTION="Custom agent description" \
  -t documentation-agent:1.2.3 .

Available Build Arguments:

• VERSION - Agent version (default: 0.2.32)
• AGENT_NAME - Agent name (default: documentation-agent)
• AGENT_DESCRIPTION - Agent description (default: A2A agent server that provides Context7-style documentation capabilities for your agents)

These values are embedded into the binary at build time using linker flags, making them accessible at runtime without requiring environment variables.

Apache 2.0 License - see LICENSE file for details