examples/INDEX.md
Use this index when you want the shortest path from a first runnable agent to the next services, agents, workflows, and interop examples. Every command below is provider-free unless the example README says otherwise.
| Goal | Start here | Run or verify | Then try |
|---|---|---|---|
| Run the smallest no-secret agent | first-agent | go run ./examples/first-agent | agent-demo for a larger service-backed agent |
| Prove the maintained 0→hero path | support | go run ./examples/support and go test ./examples/support | zero-to-hero guide |
| See planning and delegation | agent-plan-delegate | go run ./examples/agent-plan-delegate | plan-delegate guide |
| Expose services through MCP | mcp/hello | follow mcp setup | mcp/crud and mcp/workflow |
| Try A2A or gRPC interop next | agent-demo plus gateway docs | run the example, then use the gateway docs | grpc-interop |
| Add workflow durability | flow-durable | go run ./examples/flow-durable | flow-loop |
hello-world to learn service
registration, handlers, client calls, and health checks.first-agent with
go run ./examples/first-agent; it uses a deterministic mock model and needs
no provider key.support with
go run ./examples/support; it keeps typed services, an agent chat loop, an
event-driven flow, and an approval gate in one maintained example.mcp/hello, mcp/crud,
and mcp/workflow when you are ready to expose tools to
external AI clients.flow-durable once the agent path
needs checkpointed, resumable deterministic work.The installed CLI prints the same path:
micro examples
micro agent demo
micro zero-to-hero
Keep this file, README.md, and the micro examples output in
sync so new developers can find examples/first-agent and examples/support
from one documented path.