Skip to main content

​
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.

​
Next Steps

Installation

Full walkthrough of setting up your agent.

Project Structure

Understand the generated project layout.