@moonrepo/cli

@moonrepo/cli

The official CLI for moon, a task runner and repo management tool for the web ecosystem, written in Rust! Supports JavaScript, TypeScript, Bash, and much more!

• Documentation
• Getting started
• Feature comparison
• FAQ

Installation

moon can be installed with bash:

curl -fsSL https://moonrepo.dev/install/moon.sh | bash

Or with npm, pnpm, or yarn.

yarn add --dev @moonrepo/cli

Once installed, initialize moon in your repository.

moon init

Usage

Once projects and tasks have been configured, tasks can be ran with:

# Run `lint` in project `app`
moon run app:lint

# Run `lint` in all projects
moon run :lint

Why use moon?

Working in the JavaScript ecosystem can be very involved, especially when it comes to managing a repository effectively. Which package manager to use? Which Node.js version to use? How to import node modules? How to build packages? So on and so forth. moon aims to streamline this entire process and provide a first-class developer experience.

• Increased productivity - With Rust as our foundation, we can ensure robust speeds, high performance, and low memory usage. Instead of long builds blocking you, focus on your work.
• Exceptional developer experience - As veterans of the JavaScript ecosystem, we're well aware of the pain points and frustrations. Our goal is to mitigate and overcome these obstacles.
• Incremental adoption - At its core, moon has been designed to be adopted incrementally and is not an "all at once adoption". Migrate project-by-project, or task-by-task, it's up to you!
• Reduced scripts confusion - package.json scripts can become unwieldy, very quickly. No more duplicating the same script into every package, or reverse-engineering which root scripts to use. With moon, all you need to know is the project name, and a task name.
• Ensure correct versions - Whether it's Node.js or npm, ensure the same version of each tool is the same across every developer's environment. No more wasted hours of debugging.
• Automation built-in - When applicable, moon will automatically install node_modules, or sync package dependencies, or even sync TypeScript project references.
• And of course, the amazing list of features below!

Features

Not all features are currently supported, view the documentation for an accurate list!

Management

• Smart hashing - Collects inputs from multiple sources to ensure builds are deterministic and reproducible.
• Remote caching - Persists builds, hashes, and caches between teammates and CI/CD environments.
• Integrated toolchain - Automatically downloads and installs explicit versions of Node.js and other tools for consistency across the entire workspace or per project.
• Multi-platform - Runs on common development platforms: Linux, macOS, and Windows.

Organization

• Project graph - Generates a project graph for dependency and dependent relationships.
• Code generation - Easily scaffold new applications, libraries, tooling, and more!
• Dependency workspaces - Works alongside package manager workspaces so that projects have distinct dependency trees.
• Code ownership - Declare owners, maintainers, support channels, and more. Generate CODEOWNERS.

Orchestration

• Dependency graph - Generates a dependency graph to increase performance and reduce workloads.
• Action pipeline - Executes actions in parallel and in order using a thread pool and our dependency graph.
• Action distribution - Distributes actions across multiple machines to increase throughput.
• Incremental builds - With our smart hashing, only rebuild projects that have been touched since the last build.

Notification

• Flakiness detection - Reduce flaky builds with automatic retries and passthrough settings.
• Webhook events - Receive a webhook for every event in the pipeline. Useful for metrics gathering and insights.
• Terminal notifications - Receives notifications in your chosen terminal when builds are successful... or are not.
• Git hooks - Manage Git hooks to enforce workflows and requirements for contributors.

Changelog

1.32.0

🚀 Updates

• Added unstable support for multiple package workspaces when installing dependencies and resolving lockfiles.
  • For example, you can now have multiple yarn.lock files throughout the repository, allowing for multiple Yarn/Node workspaces.
• Updated Pkl (.pkl) based configuration to always be enabled, and is no longer hidden behind an experimental flag.
  • Added official documentation: https://moonrepo.dev/docs/guides/pkl-config
• Updated our unstable remote service (Bazel RE API) with new functionality:
  • You can now use http(s) protocols for gRPC servers, instead of just grpc(s).
  • Added an unstable_remote.api setting, which can be used to inform the server's API format. Defaults to grpc.
  • Added an unstable_remote.auth setting, which can be used for HTTP Bearer/token Authorization based endpoints. Can also be used to set headers for all requests.
  • Added support for Depot cloud-based caching: https://depot.dev/docs/cache/overview
  • Added support for the HTTP protocol: https://bazel.build/remote/caching#http-caching
  • Added support for the ByteStream API.
  • Added timeout and concurrency limit to clients.
  • Added a MOON_DEBUG_REMOTE environment variable, which can be used to debug internal errors for diagnosing connection/integration issues.
  • Improved handling of TLS/mTLS connections.
• Improved the Bun toolchain.
  • Added support for the new v1.2 bun.lock file. We do our best to detect this, but we suggest configuring --save-text-lockfile.
• Improved the Deno toolchain.
  • Added support for Deno v2 and deno install. Will now run this command instead of deno cache.
  • Added support for v3 and v4 lockfiles (we now use the deno_lockfile crate).
  • Added basic support for workspaces.
  • Added deno.installArgs setting.
• Improved the Python toolchain.
  • Added unstable uv support. Can be enabled with the new python.packageManager and python.uv settings.
    • Right now, has basic toolchain support, including dependency installs and virtual environments.
  • Renamed python.rootRequirementsOnly to python.rootVenvOnly (old name still works).
  • Will now inherit versions from the root .prototools.
• Improved the Rust toolchain.
  • The root-level project is now properly taken into account when detecting if a project is within the Cargo workspace.
  • Project dependencies (dependsOn) are now automatically inferred from Cargo.toml dependencies.
• Reworked child process handling to better handle signals and shutdown accordingly. Additionally, when the pipeline receives a signal, we now display the status that shutdown the pipeline in the summary.
• Reworked the new task inferInputs option to not infer environment variables from popular CI/CD providers, as those values constantly change, causing tasks to always be affected. If you would like to reference these values, add them as an explicit inputs.

🐞 Fixes

• Fixed lots of issues around remote caching. Should be "stable" now.

⚙️ Internal

• Updated Rust to v1.84.1.