aixyz package includes the CLI for developing and building agents. Install it to get the aixyz command.
Commands
aixyz dev
Starts a local development server with hot reload. Watches app/ and aixyz.config.ts for changes and restarts automatically (100ms debounce).
On startup, the dev server prints the A2A and MCP endpoints:
app/server.ts exists, one is auto-generated from app/agent.ts and app/tools/*.ts.
aixyz build
Bundles your agent for deployment.
Standalone output goes to
.aixyz/output/server.js — run it with bun .aixyz/output/server.js.
Vercel output goes to .vercel/output/ using Build Output API v3. Automatically detected when VERCEL=1 is set or configured in aixyz.config.ts.
The build process:
- Loads environment variables from
.envfiles - Reads and validates
aixyz.config.ts - Detects or auto-generates the server entrypoint
- Bundles with
Bun.build(), materializing the config into the bundle - Copies static assets from
public/andapp/icon.png
aixyz erc-8004 register
Registers a new agent on the ERC-8004 IdentityRegistry. Creates app/erc-8004.ts if it doesn’t exist (prompting for supported trust mechanisms), asks for your agent’s deployment URL, and derives the on-chain URI as <url>/_aixyz/erc-8004.json. After a successful registration, the entry is written back to app/erc-8004.ts.
aixyz erc-8004 update
Updates the metadata URI of a registered agent. Reads existing registrations from app/erc-8004.ts, lets you select which one to update (if multiple), and derives the new URI from the provided URL.
See ERC-8004 Identity for the full protocol documentation.