CLI Reference

Complete command reference for the ayo CLI.

ayo

Start an interactive chat session or send a prompt.

ayo [prompt] [flags] ayo @agent [prompt] [flags]

Options

FlagDescription
-a, --attach <file>Attach file to conversation
-c, --continueContinue previous session
--session <id>Use specific session
--model <name>Override default model

Examples

# Interactive mode ayo # Single prompt ayo "What time is it?" # Use specific agent ayo @summarizer "Summarize this document" # Pipe input cat report.txt | ayo @summarizer "Summarize" # Continue previous session ayo -c "What else?"

ayo agents

Manage agents.

ayo agents list

List all available agents.

ayo agents list

ayo agents show

Display agent details.

ayo agents show @name

ayo agents create

Create a new agent.

ayo agents create @name

ayo ticket

Manage tickets.

ayo ticket list

ayo ticket list [flags]
FlagDescription
--status <status>Filter by status (open, in_progress, closed)
-a, --assignee <agent>Filter by assignee

ayo ticket create

ayo ticket create "title" [flags]
FlagDescription
-a, --assignee <agent>Assign to agent
--deps <id,...>Dependencies (comma-separated)
--globalCreate global (not session) ticket

ayo ticket start

Mark ticket as in progress.

ayo ticket start <id>

ayo ticket close

Mark ticket as closed.

ayo ticket close <id>

ayo ticket ready

List tickets ready for work (dependencies resolved).

ayo ticket ready [-a @agent]

ayo ticket note

Add note to ticket.

ayo ticket note <id> "note text"

ayo squad

Manage squads.

ayo squad create

ayo squad create <name> -a @agent1,@agent2,...

ayo squad list

ayo squad list

ayo squad start

Start squad sandbox.

ayo squad start <name>

ayo flow

Manage and run flows.

ayo flow list

ayo flow list

ayo flow run

ayo flow run <name> [input-json]

ayo flow new

ayo flow new <name>

ayo flow show

ayo flow show <name>

ayo memory

Manage persistent memory.

ayo memory store

ayo memory store "fact to remember"

ayo memory list

ayo memory list

ayo memory search

ayo memory search "query"

ayo memory delete

ayo memory delete <id>

ayo trigger

Manage automation triggers.

ayo trigger create

ayo trigger create <name> [flags]
FlagDescription
--cron <expr>Cron schedule
--watch <pattern>File watch pattern
--webhook <path>Webhook endpoint
--agent <@name>Agent to run
--flow <name>Flow to run
--prompt <text>Prompt for agent

ayo trigger list

ayo trigger list

ayo trigger delete

ayo trigger delete <name>

ayo setup

Run initial setup wizard.

ayo setup

ayo doctor

Check system health and configuration.

ayo doctor

ayo sandbox service

Manage the background daemon.

ayo sandbox service start

ayo sandbox service start

ayo sandbox service stop

ayo sandbox service stop

ayo sandbox service status

ayo sandbox service status