Skip to content

commands.md

Latest commit

 

History

History
85 lines (62 loc) · 2.34 KB

commands.md

File metadata and controls

85 lines (62 loc) · 2.34 KB

CLI Commands

MAIASS provides a set of commands for Git workflow automation and project management.

Available Commands

hello

Test command to verify installation and configuration.

maiass hello

Output:

  • Displays version banner
  • Confirms environment loading
  • Shows colorful greeting

Planned Commands

The following commands are planned to replicate functionality from the original MAIASS script:

Git Workflow

  • maiass init - Initialize Git workflow in current directory
  • maiass branch <name> - Create and switch to new feature branch
  • maiass merge - Interactive merge workflow
  • maiass release [type] - Create release (patch/minor/major)

Project Management

  • maiass version - Display version information
  • maiass config - Manage configuration
  • maiass status - Show project and Git status

AI Integration

  • maiass commit - AI-augmented commit message generation
  • maiass review - AI code review suggestions

Command Structure

All commands follow this pattern:

maiass <command> [options] [arguments]

Global Options

  • --help, -h - Show help for command
  • --version, -v - Show version
  • --debug - Enable debug output
  • --config <path> - Use specific config file

Workflow Options (main maiass command)

  • --auto, -a - Full auto: stage, commit, push, merge to develop, bump version. Suitable for CI.
  • --auto-commit, -ac - Auto-yes for commit phase only — stops after commit (no merge, no version bump)
  • --commits-only, -c - Generate AI commit without entering version management
  • --auto-stage - Auto-stage all changes (commit phase only)
  • --dry-run, -d - Preview without making changes
  • --force, -f - Skip confirmation prompts (still respects auto vars)
  • --silent, -s - Suppress non-essential output
  • --tag, -t - Force release tagging for the version bump

See configuration.md for how these flags relate to MAIASS_AUTO_* environment variables.

Examples

# Basic usage
maiass hello

# Get help
maiass --help
maiass hello --help

# Debug mode
maiass hello --debug

Environment Integration

Commands automatically load environment variables from:

  1. Project .env
  2. User .maiass.env
  3. System config files

This ensures consistent behavior across different projects and environments.