Environment Management

Commands for initializing, setting up, and managing the moon development environment.

Capabilities

Generate Completions

Generate shell completions for the moon CLI to enable tab completion.

moon completions [--shell <SHELL>]

Options:

• --shell <SHELL> - Target shell for completion generation (bash, zsh, fish, powershell, elvish)

Usage Examples:

# Generate completions for your current shell
moon completions

# Generate completions for a specific shell
moon completions --shell zsh

# Install completions (bash example)
moon completions --shell bash > /usr/local/etc/bash_completion.d/moon

Initialize Repository

Initialize a new moon repository or add moon configuration to an existing repository.

moon init [toolchain] [plugin] [--to <PATH>] [--force] [--minimal] [--yes]

Arguments:

• toolchain (optional) - Specific toolchain to initialize (e.g., "node", "rust")
• plugin (optional) - Plugin locator for the toolchain

Options:

• --to <PATH> - Destination directory to initialize into (default: current directory)
• --force - Overwrite existing configuration files
• --minimal - Initialize with minimal configuration and skip prompts
• --yes - Skip all prompts and use default values

Usage Examples:

# Initialize moon in current directory
moon init

# Initialize with Node.js toolchain
moon init node

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

# Initialize with minimal configuration
moon init --minimal --yes

# Force overwrite existing configuration
moon init --force

Setup Environment

Install and configure all required tools and dependencies for the workspace.

moon setup

This command:

• Downloads and installs configured tools (Node.js, etc.)
• Sets up toolchain dependencies
• Initializes workspace configuration
• Prepares the environment for development

Usage Examples:

# Setup the development environment
moon setup

Teardown Environment

Clean up the moon environment by uninstalling tools and removing temporary files.

moon teardown

This command:

• Uninstalls downloaded tools
• Removes temporary files and caches
• Cleans up toolchain configurations
• Resets the workspace to a clean state

Usage Examples:

# Clean up the moon environment
moon teardown

Configuration Files

Moon initialization creates several configuration files:

• .moon/workspace.yml - Workspace configuration
• .moon/toolchain.yml - Toolchain and tool configuration
• moon.yml - Root workspace settings
• .moon/tasks/ - Task configuration directory

Integration with Existing Projects

Moon can be added to existing repositories without disrupting current workflows:

# Add moon to existing project
cd existing-project
moon init --minimal

# Setup tools without changing existing configuration
moon setup