Command Reference

Complete reference for all Wheels CLI commands organized by category.

Quick Reference

Most Common Commands

Command	Description
wheels generate app [name]	Create new application
wheels generate scaffold [name]	Generate complete CRUD
wheels dbmigrate latest	Run database migrations
wheels test	Run application tests
wheels reload	Reload application

Core Commands

Essential commands for managing your Wheels application.

Command	Description	Documentation
wheels init	Bootstrap existing app for CLI	Details
wheels info	Display version information	Details
wheels reload	Reload application	Details
wheels deps	Manage dependencies	Details
wheels destroy [type] [name]	Remove generated code	Details

Code Generation

Commands for generating application code and resources.

Command	Alias	Description	Documentation
wheels generate app	wheels new	Create new application	Details
wheels generate app-wizard		Interactive app creation	Details
wheels generate controller	wheels g controller	Generate controller	Details
wheels generate model	wheels g model	Generate model	Details
wheels generate view	wheels g view	Generate view	Details
wheels generate property		Add model property	Details
wheels generate route		Generate route	Details
wheels generate test		Generate tests	Details
wheels generate snippets		Code snippets	Details
wheels generate scaffold		Complete CRUD	Details

Generator Options

Common options across generators:

• --force - Overwrite existing files

• --help - Show command help

Database Commands

Commands for managing database schema and migrations.

Database Operations

Command	Description	Documentation
wheels db create	Create database	Details
wheels db drop	Drop database	Details

Migration Management

Command	Description	Documentation
wheels dbmigrate info	Show migration status	Details
wheels dbmigrate latest	Run all pending migrations	Details
wheels dbmigrate up	Run next migration	Details
wheels dbmigrate down	Rollback last migration	Details
wheels dbmigrate reset	Reset all migrations	Details
wheels dbmigrate exec [version]	Run specific migration	Details

Migration Creation

Command	Description	Documentation
wheels dbmigrate create blank [name]	Create empty migration	Details
wheels dbmigrate create table [name]	Create table migration	Details
wheels dbmigrate create column [table] [column]	Add column migration	Details
wheels dbmigrate remove table [name]	Drop table migration	Details

Testing Commands

Commands for running and managing tests.

Command	Description	Documentation
wheels test	Run framework tests	Details

Environment Management

Commands for managing development environments and application context.

Command	Description	Documentation
wheels env	Environment base command	Details
wheels env setup [name]	Setup environment	Details
wheels env list	List environments	Details

Code Analysis

Commands for analyzing code quality and patterns.

Command	Description	Documentation
wheels analyze	Code analysis base command	Details
wheels analyze code	Analyze code quality	Details
wheels analyze performance	Performance analysis	Details
wheels analyze security	Security analysis	Details

CI/CD Commands

Commands for continuous integration and deployment workflows.

Command	Description	Documentation
wheels ci init	Initialize CI/CD configuration	Details

Docker Commands

Commands for Docker container management and deployment.

Command	Description	Documentation
wheels docker init	Initialize Docker configuration	Details
wheels docker deploy	Deploy using Docker	Details

Command Patterns

Getting Help

Every command supports --help:

wheels [command] --help
wheels generate controller --help
wheels dbmigrate create table --help

Command Aliases

Many commands have shorter aliases:

wheels g controller users  # Same as: wheels generate controller users
wheels g model user       # Same as: wheels generate model user
wheels new myapp         # Same as: wheels generate app myapp

Common Workflows

Creating a new feature:

wheels generate scaffold name=product properties=name:string,price:decimal
wheels dbmigrate latest
wheels test

Starting development:

wheels reload            # Reload the application
wheels test             # Run tests

Deployment preparation:

wheels test
wheels analyze security
wheels analyze performance
wheels dbmigrate info

Environment Variables

Variable	Description	Default
WHEELS_ENV	Environment mode	development
WHEELS_DATASOURCE	Database name	From config
WHEELS_RELOAD_PASSWORD	Reload password	From config

Exit Codes

Code	Description
0	Success
1	General error
2	Invalid arguments
3	File not found
4	Permission denied
5	Database error

See Also

• Quick Start Guide

• CLI Development Guides

• Service Architecture

• Migrations Guide

• Testing Guide