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.

air update

Updates the Air CLI to the latest published version.

air update

air version

Prints the currently installed Air CLI version.

air version
# Air CLI v1.0.9

air clean

Removes generated code artifacts (*.air.g.dart) from the project. Useful when switching branches or resolving stale code generation conflicts.

air clean

Usage Example: State Generation

# Generate a state controller inside the 'cart' module
air g state cart --module=cart

# This creates:
# lib/modules/cart/ui/state/cart_state.dart
# Run build_runner to generate the reactive plumbing:
dart run build_runner build --delete-conflicting-outputs

Best Practices

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