create-aixyz-app

Overview

create-aixyz-app is a project scaffolding CLI that generates a new aixyz agent project with the standard directory structure, configuration, and example files.

Usage

bunx create-aixyz-app my-agent

The CLI prompts for:

Agent name — Used in aixyz.config.ts and package.json
OpenAI API key — Saved to .env.local (optional)

Non-Interactive Mode

Skip all prompts with the -y flag:

bunx create-aixyz-app my-agent -y

What Gets Scaffolded

Scripts

The generated package.json includes:

package.json

{
  "scripts": {
    "dev": "aixyz dev",
    "build": "aixyz build"
  }
}

After Scaffolding

cd my-agent
bun install
bun run dev

Your agent starts at http://localhost:3000 with A2A, MCP, and x402 support ready to go.

Getting Started

CLI

Config

File-system layout

Functions

Protocols

create-aixyz-app

Overview

Usage

Non-Interactive Mode

What Gets Scaffolded

Scripts

After Scaffolding

Next Steps

Installation

Project Structure

​Overview

​Usage

​Non-Interactive Mode

​What Gets Scaffolded

​Scripts

​After Scaffolding

​Next Steps

Installation

Project Structure

Overview

Usage

Non-Interactive Mode

What Gets Scaffolded

Scripts

After Scaffolding

Next Steps