Moon CLI Tool

Moon is a repository management, organization, orchestration, and notification tool for the web ecosystem, written in Rust. It provides comprehensive capabilities for managing monorepos, handling dependencies, executing tasks, and coordinating builds across multiple projects.

Package Information

• Package Name: @moonrepo/core-macos-x64
• Package Type: npm (binary distribution)
• Language: JavaScript/Node.js (wrapper for Rust binary)
• Platform: macOS x64 (Intel)
• Installation: Automatically installed as optional dependency via @moonrepo/cli

Installation

This package provides the macOS x64 binary for the moon CLI tool. It's automatically selected as an optional dependency when installing the main CLI package on compatible systems:

# Install the main CLI package (includes this binary)
npm install @moonrepo/cli

# Or install globally
npm install -g @moonrepo/cli

# Alternatively, install with script
curl -fsSL https://moonrepo.dev/install/moon.sh | bash

The @moonrepo/core-macos-x64 package contains the compiled moon binary and is automatically used by the CLI package on macOS x64 systems. Users typically don't install this package directly.

Basic Usage

# Initialize a new moon repository
moon init

# Run tasks for affected projects
moon run build

# Check all projects
moon check

# View project information
moon project my-app

# Display interactive project graph
moon project-graph

Architecture

Moon is built around several key components:

• Repository Management: Multi-project repository organization and dependency tracking
• Task Orchestration: Parallel task execution with dependency resolution
• Build System: Smart caching, incremental builds, and remote caching
• Toolchain Management: Automatic tool installation and version management
• Graph Visualization: Interactive dependency and task graphs
• Code Generation: Template-based scaffolding and file generation

Capabilities

Environment Management

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

moon completions [--shell <SHELL>]
moon init [toolchain] [plugin] [--to <PATH>] [--force] [--minimal] [--yes]
moon setup
moon teardown

Environment Management

Toolchain Management

Commands for managing development tools and runtime environments.

moon bin <tool>
moon node <subcommand>
moon toolchain <subcommand>

Toolchain Management

Project & Task Management

Commands for working with projects and tasks within the repository.

moon project <id> [--json] [--no-tasks]
moon task <target> [--json]
moon sync [subcommand]

Project & Task Management

Task Execution

Commands for running builds, tests, and other tasks across projects.

moon check [ids...] [--all] [--summary] [--update-cache]
moon ci [targets...] [--base <REF>] [--head <REF>] [--job <INDEX>] [--job-total <TOTAL>] [--stdin]
moon run <targets...> [--dependents] [--force] [--interactive] [--query <QUERY>] [--summary]

Task Execution

Graph Visualization

Commands for visualizing project and task dependencies through interactive graphs.

moon action-graph [targets...] [--dependents] [--host <HOST>] [--port <PORT>]
moon project-graph [id] [--dependents] [--host <HOST>] [--port <PORT>]
moon task-graph [target] [--dependents] [--host <HOST>] [--port <PORT>]

Graph Visualization

Code Generation

Commands for generating code from templates and managing templates.

moon generate <name> [dest] [--defaults] [--dry-run] [--force] [--template]
moon templates [--filter <PATTERN>] [--json]

Code Generation

Query & Analysis

Commands for querying information about projects, tasks, and the build pipeline.

moon query hash <hash> [--json]
moon query hash-diff <left> <right> [--json]
moon query projects [query] [--alias <ALIAS>] [--affected] [--json] [--language <LANG>] [--tags <TAGS>]
moon query tasks [query] [--affected] [--command <COMMAND>] [--json] [--project <PROJECT>]
moon query touched-files [--base <REF>] [--head <REF>] [--json] [--local] [--remote]

Query & Analysis

Extensions & Integration

Commands for working with plugins, extensions, and external integrations.

moon ext <id> [-- args...]
moon mcp
moon docker <subcommand>
moon migrate <subcommand> [--skip-touched-files-check]

Extensions & Integration

Maintenance & Utilities

Commands for maintaining the workspace and managing moon itself.

moon clean [--lifetime <DURATION>]
moon upgrade

Maintenance & Utilities

Debugging & Development

Internal debugging commands for development and troubleshooting.

moon debug config
moon debug vcs

Maintenance & Utilities

Global Options

All moon commands support the following global options:

--cache <MODE>           # Mode for cache operations (default: read-write)
--color                  # Force colored output
--concurrency <NUM>      # Maximum number of threads to utilize (-c)
--dump                   # Dump a trace profile to the working directory
--log <LEVEL>            # Lowest log level to output (off|error|warn|info|debug|trace)
--log-file <PATH>        # Path to a file to write logs to
--quiet                  # Hide all non-important terminal output (-q)
--theme <THEME>          # Terminal theme to print with (dark|light)

Environment Variables

Moon behavior can be configured through environment variables:

• MOON_CACHE - Cache operation mode
• MOON_CONCURRENCY - Maximum thread utilization
• MOON_DUMP - Enable trace profiling
• MOON_HOST - Graph server host address
• MOON_LOG - Log level setting
• MOON_LOG_FILE - Log file path
• MOON_PORT - Graph server port
• MOON_QUIET - Quiet mode toggle
• MOON_SUMMARY - Action summary toggle
• MOON_THEME - Terminal theme setting
• MOON_VERSION - Moon version (set automatically)
• STARBASE_LOG - Starbase logging configuration

Exit Codes

Moon commands return standard exit codes:

• 0 - Success
• 1 - General error
• Other codes may be returned based on specific command failures