CLI Reference

The Aerostack CLI is the primary tool for building, deploying, and managing your projects. It handles everything from scaffolding to production deployment.

Installation

npm install -g @aerostack/cli

Or use it without installing:

npx aerostack init my-app

Verify your install:

aerostack --version

Command Overview

Command	Description
`aerostack init`	Create a new project from a template
`aerostack dev`	Start local development server
`aerostack deploy`	Deploy to Aerostack or your Cloudflare account
`aerostack login`	Authenticate with your Aerostack account
`aerostack link`	Link a local project to an Aerostack project
`aerostack whoami`	Show current auth and project status
`aerostack add`	Add a service or shared library
`aerostack db`	Manage databases and migrations
`aerostack generate types`	Generate TypeScript types from your schema
`aerostack secrets`	Manage secrets for staging and production
`aerostack test`	Run tests with Vitest + Workers runtime
`aerostack mcp convert`	Convert an NPM MCP server to a Cloudflare Worker
`aerostack skill`	Install and publish skills
`aerostack workspace`	Manage MCP workspaces
`aerostack functions`	Install community functions
`aerostack ai`	Run the AI agent with project context
`aerostack index`	Index your project for the AI agent
`aerostack store`	AI-powered schema and data seeding
`aerostack migrate`	Migrate an existing Cloudflare Worker to Aerostack

Common Workflows

# New project, deploy to Aerostack
aerostack init my-app
cd my-app
aerostack login
aerostack deploy --env staging

# New project, deploy to your own Cloudflare account
aerostack init my-app --template api --db d1
cd my-app
aerostack deploy --cloudflare

# Add a new service to an existing project
aerostack add function payments-api

# Database workflow
aerostack db migrate new add_products_table
# ... edit the SQL file ...
aerostack db migrate apply
aerostack generate types

# Install a skill from the marketplace
aerostack skill install johndoe/github-skill