Toolchain Management

Commands for managing development tools, runtime environments, and toolchain plugins within the moon workspace.

Capabilities

Get Tool Binary Path

Return the absolute path to a tool's binary within the moon toolchain.

moon bin <tool>

Arguments:

• tool (required) - The name of the tool to query (e.g., "node", "npm", "pnpm", "yarn")

Usage Examples:

# Get path to Node.js binary
moon bin node
# Output: /home/user/.moon/tools/node/18.17.0/bin/node

# Get path to npm binary
moon bin npm

# Use in scripts
NODE_PATH=$(moon bin node)
$NODE_PATH --version

Node.js Commands

Special commands for working with Node.js within the moon environment.

moon node <subcommand>

Subcommands:

Run Package.json Script

Execute a package.json script within a project using the moon-managed Node.js installation.

moon node run-script <script> [--project <ID>]

Arguments:

• script (required) - Name of the script to run from package.json

Options:

• --project <ID> - Project ID to run the script in (defaults to current directory project)

Usage Examples:

# Run a script in the current project
moon node run-script build

# Run a script in a specific project
moon node run-script test --project my-app

# Run development server
moon node run-script dev

Toolchain Plugin Management

Manage toolchain plugins that provide language and tool support.

moon toolchain <subcommand>

Subcommands:

Add Toolchain Plugin

Add and configure a new toolchain plugin in the workspace.

moon toolchain add <plugin> [--to <PATH>]

Arguments:

• plugin (required) - Plugin identifier or URL

Options:

• --to <PATH> - Configuration file path (defaults to .moon/toolchain.yml)

Usage Examples:

# Add Node.js toolchain plugin
moon toolchain add node

# Add a custom plugin from URL
moon toolchain add https://github.com/example/moon-plugin

# Add plugin to specific config file
moon toolchain add rust --to ./rust-toolchain.yml

Show Toolchain Plugin Information

Display detailed information about a configured toolchain plugin.

moon toolchain info <plugin> [--json]

Arguments:

• plugin (required) - Name of the plugin to query

Options:

• --json - Output information in JSON format

Usage Examples:

# Show info about Node.js plugin
moon toolchain info node

# Get plugin info as JSON
moon toolchain info node --json

Toolchain Configuration

Toolchain behavior is configured in .moon/toolchain.yml:

# Example toolchain configuration
node:
  version: "18.17.0"
  packageManager: "npm"
  syncProjectWorkspaceDependencies: true

python:
  version: "3.11.0"
  syncProjectWorkspaceDependencies: false

Supported Tools

Moon supports automatic installation and management of:

• Node.js - JavaScript runtime and package managers (npm, pnpm, yarn)
• Python - Python interpreter and package managers (pip, poetry)
• Rust - Rust compiler and Cargo package manager
• Go - Go compiler and module system
• Java - JDK and build tools (Maven, Gradle)
• Custom Tools - Via plugin system

Tool Version Management

Moon ensures consistent tool versions across all environments:

# Check installed tool versions
moon toolchain info node

# Update tool version in configuration
# Edit .moon/toolchain.yml, then run:
moon setup

Plugin Development

Custom toolchain plugins can be developed to support additional languages and tools. Plugins define:

• Tool installation and management
• Language-specific task detection
• Dependency resolution
• Build and test commands