CLI Reference

The Air CLI is your Swiss Army knife for building modular Flutter apps.

Installation

dart pub global activate air_cli

Commands

air create

Initializes a new Air project.

air create <project_name> --org=com.example --template=starter

air generate (alias: g)

Scaffolds various framework components.

Type	Command	Description
Module	air g module <name>	Creates a feature module.
Screen	air g screen <name> --module=<m>	Creates a UI page.
State	air g state <name> --module=<m>	Creates reactive state.
Service	air g service <name> --module=<m>	Creates a business service.
Model	air g model <name> --module=<m>	Creates a data model.
Adapter	air g adapter <name>	Creates a headless adapter.

air module

Manages external modules.

# Add from Git
air module add https://github.com/user/module.git

# Add from Local Path
air module add /path/to/local/module

air doctor

Diagnoses your project and environment.

air doctor

air skills

Installs the Air Framework AI agent skill so coding agents (Antigravity, Claude Code, OpenCode, Cursor) understand the framework automatically.

# Interactive selection
air skills install

# Specific agent
air skills install cursor

# All agents
air skills install all

See the AI Agent Skills guide for details.

Best Practices

Always use the CLI to generate modules, adapters, and state to ensure naming conventions and directory structures are followed.