Repository Setup

/**
 * Initialize moon workspace in current or specified directory
 * Creates .moon directory with configuration files
 */
moon init [tool]

# Arguments:
# [tool]    Optional specific tool to initialize (bun, node, rust, typescript)

# Options:
--force      Overwrite existing config files if they exist
--minimal    Generate minimal configurations with sane defaults  
--to <path>  Destination directory to initialize (default: current directory)
--yes        Skip all prompts and enable tools based on file detection

# Initialize moon in current directory
moon init

# Initialize with minimal configuration
moon init --minimal

# Initialize in specific directory
moon init --to ./my-workspace

# Auto-detect and configure without prompts
moon init --yes

# Initialize specific tool after initial setup
moon init node
moon init typescript

/**
 * Initialize and configure a specific tool in the toolchain
 * Modifies .moon/toolchain.yml configuration
 */
moon init <tool>

# Available tools:
# bun          Bun JavaScript runtime and package manager
# node         Node.js runtime and npm package manager  
# rust         Rust compiler and Cargo package manager
# typescript   TypeScript compiler and type checking

# Add Node.js to existing workspace
moon init node

# Configure TypeScript in workspace
moon init typescript

# Set up Rust toolchain
moon init rust

# Add Bun runtime support
moon init bun

# Directory structure created:
.moon/
├── workspace.yml     # Workspace-level configuration
├── toolchain.yml     # Tool versions and settings
└── tasks.yml         # Global task definitions (optional)

# Project discovery and workspace settings
projects:
  - 'apps/*'
  - 'packages/*'

# Workspace-level configuration
versionConstraint: '>=1.0.0'

# Tool configurations
node:
  version: '18.17.0'
  packageManager: 'npm'

typescript:
  version: '5.0.0'

/**
 * Setup toolchain by installing all configured tools
 * Downloads and installs tools defined in toolchain.yml
 */
moon setup

# Options:
--force    Force reinstall tools even if already present

# Install all configured tools
moon setup

# Force reinstall all tools
moon setup --force

/**
 * Teardown toolchain by uninstalling tools
 * Removes tools installed by moon setup
 */
moon teardown

/**
 * Upgrade moon binary to latest available version
 * Downloads and replaces current installation
 */
moon upgrade