5-Minute Demo

This walkthrough gives a new user a fast path from a generated project to a validated Agent2Agent task flow.

1. Create a project

pnpm dlx @a2amesh/create-a2amesh demo
cd demo
pnpm install

PowerShell:

pnpm dlx @a2amesh/create-a2amesh demo
Set-Location demo
pnpm install

2. Run the local agent

pnpm run dev

Keep the local URL printed by the dev server. Use it for CLI validation and message sending.

3. Validate the Agent Card

a2amesh discover http://127.0.0.1:3000
a2amesh export-card http://127.0.0.1:3000 --output ./agent-card.json
a2amesh validate ./agent-card.json

PowerShell:

a2amesh discover http://127.0.0.1:3000
a2amesh export-card http://127.0.0.1:3000 --output .\agent-card.json
a2amesh validate .\agent-card.json

4. Send a task

a2amesh send http://127.0.0.1:3000 "hello from the demo"
a2amesh monitor http://127.0.0.1:3000 --cycles 3

5. Capture conformance output

a2amesh conformance http://127.0.0.1:3000 --protocol-version 1.0 --json > conformance.json
a2amesh conformance-badge conformance.json --output conformance.svg

The same flow powers the browser playground once the local UI command is wired into the CLI. Until checked-in UI screenshots are available, the visual asset above tracks the expected first-run sequence for docs review.

What to verify

• The generated project installs without workspace-only assumptions.
• discover, export-card, and validate agree on Agent Card metadata.
• send returns a task response with messages, status, and artifacts where the demo agent produces them.
• conformance creates a JSON report that can be saved as a CI or release artifact.