Quickstart (CLI)

Goal: Create and run a project using agentcli with config-first runtime.

Steps (PowerShell)

1. Create project (uses OpenAI provider)

agentcli create my-agents --template research-assistant -p openai

2. Enter project

Set-Location my-agents

3. Validate configuration

agentcli validate

4. Run

go run .

Expected

• CLI validation shows Status: VALID
• App starts without errors and prints agent responses

Notes

• Set your OpenAI API key: $Env:OPENAI_API_KEY="your-api-key" (PowerShell) or export OPENAI_API_KEY="your-api-key" (Bash)
• Alternative providers: -p azure (requires AZURE_OPENAI_* env vars) | -p ollama (requires local Ollama running)
• List config templates first if needed: agentcli config template --list

Bash equivalents

agentcli create my-agents --template research-assistant -p openai
cd my-agents
agentcli validate
go run .

Verification checklist

• [ ] agentcli create executed successfully
• [ ] agentcli validate reported VALID
• [ ] go run . produced agent output