CLI ReferenceOverview

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

Or use it without installing:

npx aerostack init my-app

Verify your install:

aerostack --version

Command Overview

CommandDescription
aerostack initCreate a new project from a template
aerostack devStart local development server
aerostack deployDeploy to Aerostack or your Cloudflare account
aerostack loginAuthenticate with your Aerostack account
aerostack linkLink a local project to an Aerostack project
aerostack whoamiShow current auth and project status
aerostack addAdd a service or shared library
aerostack dbManage databases and migrations
aerostack generate typesGenerate TypeScript types from your schema
aerostack secretsManage secrets for staging and production
aerostack testRun tests with Vitest + Workers runtime
aerostack mcp convertConvert an NPM MCP server to a Cloudflare Worker
aerostack skillInstall and publish skills
aerostack workspaceManage MCP workspaces
aerostack functionsInstall community functions
aerostack aiRun the AI agent with project context
aerostack indexIndex your project for the AI agent
aerostack storeAI-powered schema and data seeding
aerostack migrateMigrate 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
💡

Run aerostack with no arguments to launch the interactive welcome screen.