Reference

Complete reference documentation for ayo CLI, configuration, and specifications.

Reference Sections

CLI Reference — Complete command documentation
Configuration — Config files, directories, and environment variables
Agents — Agent config.json schema and system.md format
Flows Specification — YAML workflow schema

Quick Reference

Common Commands

Command	Description
`ayo`	Start interactive chat
`ayo "prompt"`	Send a single prompt
`ayo @agent "prompt"`	Use a specific agent
`ayo agents list`	List all agents
`ayo ticket list`	List tickets
`ayo flow run name`	Execute a flow

Directory Structure

                ~/.config/ayo/           # Configuration
├── ayo.json              # Main config
├── agents/               # User agents
├── skills/               # User skills
└── flows/                # User flows

~/.local/share/ayo/       # Data
├── ayo.db                # Database
├── agents/               # Built-in agents
├── skills/               # Built-in skills
├── sessions/             # Session data
└── sandboxes/            # Sandbox environments
            

Environment Variables

Variable	Description
`ANTHROPIC_API_KEY`	Anthropic API key
`OPENAI_API_KEY`	OpenAI API key
`OPENROUTER_API_KEY`	OpenRouter API key
`AYO_CONFIG`	Custom config path
`AYO_HOME`	Custom data directory