Examples

Forge examples are split by language and by runtime pattern. They should be small enough to copy, but complete enough to show identity, tools, providers, and runtime state correctly.

Language quickstarts

Language Path
Rust examples/rust/quickstart
TypeScript examples/typescript/quickstart
Go examples/go/quickstart
Python examples/python/quickstart
Swift examples/swift/quickstart
Kotlin examples/kotlin/quickstart

Pattern examples to keep covered

The docs should grow examples around:

  • single-model chat agent
  • streaming tool-loop agent
  • identity-bound production agent
  • ACT-protected tool invocation
  • RAG pipeline with embeddings
  • web fetch tool
  • multi-agent delegation
  • Brew graph resolved into Flowers
  • WASI-hosted agent
  • containerized service deployment

Example quality bar

An example should state:

  • language and package
  • required environment variables
  • whether identity is development or production
  • which tools require approval or ACTs
  • expected output shape
  • how to run the smallest verification command

Examples should not describe behavior as shipped unless the release gate or language test suite covers it.