AeroCoding CLI

Generate production-ready code from your UML diagrams.

Installation

npm install -g aerocoding

Quick Start

# 1. Login (once)
aerocoding login

# 2. Create a new project
aerocoding create

# 3. Make changes in the diagram editor on aerocoding.dev

# 4. Update your code incrementally
aerocoding update

Commands

aerocoding login

Authenticate with your AeroCoding account. Opens browser for secure OAuth authentication.

aerocoding login

aerocoding create [name]

Interactive wizard to create a new AeroCoding project with full architecture generation.

# Interactive (recommended)
aerocoding create

# With custom directory name
aerocoding create my-project

Options:

• -t, --template <id> - Skip template selection
• -p, --project <id> - Skip project selection
• -f, --force - Overwrite existing directory without asking

Creates:

• aerocoding.json - Project configuration
• aerocoding-manifest.json - File tracking manifest (auto-generated)
• backend/ - Generated backend code

aerocoding update

Incrementally update generated code while preserving your changes.

aerocoding update

Options:

• -f, --force - Overwrite modified files without merging
• -v, --verbose - Show detailed file operations
• --dry-run - Preview changes without writing files

Features:

• Three-way merge to preserve your custom code
• Creates .new and .conflict files when merge fails
• Syncs manifest to cloud for backup

aerocoding resolve

Clean up conflict files after manual resolution.

aerocoding resolve

Options:

• -v, --verbose - Show detailed resolution info
• -a, --all - Resolve all conflicts without confirmation

aerocoding whoami

Show current authenticated user.

aerocoding logout

Clear stored credentials.

Configuration Files

aerocoding.json

Project configuration (user-editable):

{
  "$schema": "https://aerocoding.dev/schema.json",
  "projectId": "your-project-id",
  "templateId": "clean-arch-dotnet",
  "templateVersion": "1.0.0",
  "namespace": "MegaStore",
  "organizationId": "your-org-id",
  "output": {
    "backend": "./backend",
    "frontend": "./frontend"
  }
}

aerocoding-manifest.json

Auto-generated file tracking (do not edit):

{
  "version": "1.0.0",
  "lastSync": "2024-01-15T10:30:00Z",
  "files": {
    "backend/src/Domain/Customer.cs": {
      "hash": "sha256:abc123...",
      "mtime": 1705312200000,
      "size": 2847,
      "type": "entity"
    }
  }
}

Incremental Generation

AeroCoding uses smart merging to preserve your custom code:

1. Unchanged files: Silently updated
2. Modified files: Three-way merge attempted
3. Conflicts: Creates .new and .conflict files for manual resolution

Customer.cs           <- Your version (unchanged)
Customer.cs.new       <- New generated version
Customer.cs.conflict  <- Diff showing conflicts

After resolving conflicts manually, run aerocoding resolve to clean up.

Security

Credentials are stored securely in your OS credential manager:

• macOS: Keychain
• Windows: Credential Manager
• Linux: Secret Service API

Links

• Website
• Documentation

License

MIT