CLI Overview

curl -sSL https://chameleondb.dev/install | sh

chameleon --version
# Output: chameleon v1.0-alpha

.
├── .chameleon.yml          # Configuration (version controlled)
├── .chameleon/             # Admin directory (local, not versioned)
│   ├── config.yml          # Source config
│   ├── state/              # Current DB state
│   ├── journal/            # Audit logs
│   ├── vault/              # Schema Vault (versioned schemas)
│   └── backups/            # Migration backups
├── schemas/                # Schema files
│   └── example.cham        # Example schema
└── README.md               # Getting started guide

# 1. Initialize project
chameleon init my-project
cd my-project

# 2. Set database connection
export DATABASE_URL="postgresql://user:password@localhost/dbname"

# 3. Edit schema
vim schemas/example.cham

# 4. Preview migration
chameleon migrate --dry-run

# 5. Apply migration
chameleon migrate --apply

# Check status
chameleon status

# Edit schema
vim schemas/users.cham

# Validate changes
chameleon validate schemas/users.cham

# Apply migration
chameleon migrate --apply

# View history
chameleon journal migrations

# Verify vault integrity
chameleon verify

# View version history
chameleon journal schema

# Check current mode
chameleon status

# General help
chameleon --help

# Command-specific help
chameleon migrate --help
chameleon journal --help