Getting Started with ayo

ayo is a CLI framework for creating, managing, and orchestrating AI agents that work autonomously in isolated sandbox environments. Design specialized agents, teach them skills, chain them into workflows, and let them coordinate through a ticket-based task system.

Start Here

Install ayo and run the onboarding wizard.

Your First Agent

Create an agent and process your first task.

Build a Pipeline

Chain agents into automated workflows.

Core Concepts

Skills — Reusable instruction modules that extend agent capabilities
Tickets — Markdown files that coordinate work between agents
Squads — Team sandboxes where agents collaborate under shared constitutions
Flows — YAML-defined multi-step workflows with parallel execution
Memory — Persistent fact storage that survives sessions
Triggers — Automation via cron schedules, file watchers, or webhooks

Prerequisites

Go 1.21 or later
macOS or Linux (Windows via WSL)
An API key from Anthropic, OpenAI, or OpenRouter

Quick Install

go install github.com/ayo-ooo/ayo/cmd/ayo@latest

See the Installation Guide for detailed setup instructions.