moon
/moon
This skill should be used when the user asks to "configure moon", "set up moonrepo", "create moon tasks", "run moon commands", "configure moon workspace", "add moon project", "moon ci setup", "moon docker", "moon query", "migrate to moon v2", or mentions moon.yml, .moon/workspace.yml, .moon/toolchains.yml, moon run, moon ci, or moonrepo in general.
Assessment and security
- Files in this package
- 8
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 3
No signals detected. Repository changed on 28.10.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
What it does and when to use it
This skill should be used when the user asks to "configure moon", "set up moonrepo", "create moon tasks", "run moon commands", "configure moon workspace", "add moon project", "moon ci setup", "moon docker", "moon query", "migrate to moon v2", or mentions moon.yml, .moon/workspace.yml, .moon/toolchains.yml, moon run, moon ci, or moonrepo in general.
Triggers from the description
Original author description
This skill should be used when the user asks to "configure moon", "set up moonrepo", "create moon tasks", "run moon commands", "configure moon workspace", "add moon project", "moon ci setup", "moon docker", "moon query", "migrate to moon v2", or mentions moon.yml, .moon/workspace.yml, .moon/toolchains.yml, moon run, moon ci, or moonrepo in general.
How it works
- When to Use moon
- Quick Reference
- Workspace Configuration
- Project Configuration
- Task Configuration
- Toolchain Configuration
- CI Integration
- Docker Support
- Moon Query Language (MQL)
- Additional Resources
SKILL.md preview
---
name: moon
description: This skill should be used when the user asks to "configure moon", "set up moonrepo", "create moon tasks", "run moon commands", "configure moon workspace", "add moon project", "moon ci setup", "moon docker", "moon query", "migrate to moon v2", or mentions moon.yml, .moon/workspace.yml, .moon/toolchains.yml, moon run, moon ci, or moonrepo in general.
---
# moon - Polyglot Monorepo Build System
moon is a Rust-based repository management, task orchestration, and build system for polyglot monorepos. It provides smart caching, dependency-aware task execution, and unified toolchain management.
> **moon v2 is now available.** Run `moon migrate v2` to migrate. See `references/v2-migration.md` for breaking changes.
## When to Use moon
- Managing monorepos with multiple projects/packages
- Orchestrating tasks across projects with dependencies
- Caching build outputs for faster CI/local builds
- Managing toolchain versions (Node.js, Rust, Python, Go, etc.)
- Generating project and action graphs
## Quick Reference
### Core Commands
```bash
moon run <target> # Run task(s)
moon run :lint # Run in all projects
moon run '#tag:test' # Run by tag
moon ci # CI-optimized execution
moon check --all # Run all build/test tasks
moon query projects # List projects
moon project-graph # Visualize dependencies
```
### Target Syntax
| Pattern | Description |
| -------------- | ------------------------------- |
| `project:task` | Specific project and task |
| `:task` | All projects with this task |
| `#tag:task` | Projects with tag |
| `^:task` | Upstream dependencies (in deps) |
| `~:task` | Current project (in configs) |
### Configuration Files
| File | Purpose |
| ---------------------- | ---------------------------------------- |
| `.moon/workspace.yml` | Workspace settings, project discovery |
| `.moon/toolchains.yml` | Language versions, package managers (v2) |
| `.moon/tasks/*.yml` | Global inherited tasks (v2) |
| `moon.yml` | Project-level config and tasks |
> **v2 Note:** `.moon/toolchain.yml` → `.moon/toolchains.yml` (plural), `.moon/tasks.yml` → `.moon/tasks/*.yml`
## Workspace Configuration
```yaml
# .moon/workspace.yml
$schema: 'https://moonrepo.dev/schemas/workspace.json'
projects:
- 'apps/*'
- 'packages/*'
vcs:
client: 'git'
defaultBranch: 'main'
pipeline:
archivableTargets:
- ':build'
cacheLifetime: '7 days'
```
## Project Configuration
```yaml
# moon.yml
$schema: 'https://moonrepo.dev/schemas/project.json'
language: 'typescript'
layer: 'application' # v2: 'type' renamed to 'layer'
stack: 'frontend'
tags: ['react', 'graphql']
dependsOn:
- 'shared-utils'
- id: 'api-client'
scope: 'production'
fileGroups:
sources:
- 'src/**/*'
tests:
- 'tests/**/*'
tasks:
build:
command: 'vite build'
inputs:
- '@group(sources)'
outputs:
- 'dist'
deps:
- '^:build'
dev:
command: 'vite dev'
preset: 'server'
# v2: Use 'script' for shell features (pipes, redirects)
lint:
script: 'eslint . && prettier --check .'
test:
command: 'vitest run'
inputs:
- '@group(sources)'
- '@group(tests)'
```
### Layer Types (v2)
| Layer | Description |
| --------------- | --------------------- |
| `application` | Apps, services |
| `library` | Shareable code |
| `tool` | CLIs, scripts |
| `automation` | E2E/integration tests |
| `scaffolding` | Templates, generators |
| `configuration` | Infra, config |
## Task Configuration
### Task Fields
| Field | Description |
| --------- | ------------------------------------ |
| `command` | Command to execute (string or array) |
| `args` | Additional arguments |
| `deps` | Task dependencies |
| `inputs` | Files for cache hashing |
| `outputs` | Files to cache |
| `env` | Environment variables |
| `extends` | Inherit from another task |
| `preset` | `server` or `utility` |
### Task Inheritance
Tasks can be inherited globally via `.moon/tasks/*.yml`:
```yaml
# .moon/tasks/node.yml
inheritedBy:
toolchains: ['javascript', 'typescript']
fileGroups:
sources: ['src/**/*']
tasks:
lint:
command: 'eslint .'
inputs: ['@group(sources)']
```
Projects control inheritance:
```yaml
# moon.yml
workspace:
inheritedTasks:
include: ['lint', 'test']
exclude: ['deploy']
rename:
buildApp: 'build'
```
### Task Options
```yaml
tasks:
example:
command: 'cmd'
options:
cache: true # Enable caching
runInCI: 'affected' # affected, always, only, false
persistent: true # Long-running process
retryCount: 2 # Retry on failure
timeout: 300 # Seconds
mutex: 'resource' # Exclusive lock
priority: 'high' # critical, high, normal, low
```
### Input Tokens
```yaml
inputs:
- '@group(sources)' # File group
- '@globs(tests)' # Glob patterns
- '/tsconfig.base.json' # Workspace root file
- '$NODE_ENV' # Environment variable
```
## Toolchain Configuration
```yaml
# .moon/toolchains.yml (v2: plural)
$schema: 'https://moonrepo.dev/schemas/toolchains.json'
# JavaScript ecosystem (v2: required for node/bun/deno)
javascript:
packageManager: 'pnpm'
inferTasksFromScripts: false
node:
version: '20.10.0'
pnpm:
version: '8.12.0'
# Alternative runtimes
bun:
version: '1.0.0'
deno:
version: '1.40.0'
typescript:
syncProjectReferences: true
routeOutDirToCache: true
rust:
version: '1.75.0'
bins: ['cargo-nextest', 'cargo-llvm-cov']
go:
version: '1.21.0'
python:
version: '3.12.0'
```
### Toolchain Tiers
| Tier | Description | Examples |
| ---- | ---------------------- | ------------------------------------ |
| 3 | Full management | Node.js, Bun, Deno, Rust, Go, Python |
| 2 | Ecosystem integration | PHP, Ruby |
| 1 | Project categorization | Bash, Batch |
| 0 | System execution | Custom tools |
## CI Integration
```yaml
# GitHub Actions
- uses: actions/checkout@v4
with:
fetch-depth: 0 # Required for affected detection
- uses: moonrepo/setup-toolchain@v0
with:
auto-install: true
- run: moon ci :build :test
- uses: moonrepo/run-report-action@v1
if: success() || failure()
with:
access-token: ${{ secrets.GITHUB_TOKEN }}
```
### Parallelization with Matrix
```yaml
strategy:
matrix:
shard: [0, 1, 2, 3]
steps:
- run: moon ci --job ${{ matrix.shard }} --job-total 4
```
### Affected Detection
```bash
moon run :test --affected # Only affected projects
moon run :lint --affected --status staged # Only staged files
moon ci :test --base origin/main # Compare against base
moon query changed-files # v2: renamed from touched-files
```
## Docker Support
```bash
moon docker scaffold <project> # Generate Docker layers
moon docker setup # Install toolchain in Docker
moon docker prune # Prune for production
moon docker file <project> # Generate Dockerfile
```
## Moon Query Language (MQL)
```bash
# Filter projects
moon query projects "language=typescript && projectType=library"
moon run :build --query "tag=react"
# Operators: =, !=, ~, !~, &&, ||
# Fields: project, language, stack, tag, task, taskType
```
## Additional Resources
For detailed configuration options, consult:
- **`references/workspace-config.md`** - Complete workspace.yml reference
- **`references/task-config.md`** - Task configuration and inheritance patterns
- **`references/v2-migration.md`** - v1 to v2 migration guide
- **`references/cli-reference.md`** - Full CLI command reference
### Examples
- **`examples/workspace.yml`** - Complete workspace configuration
- **`examples/moon.yml`** - Full project configuration
- **`examples/ci-workflow.yml`** - GitHub Actions CI workflow
Files in this package (8)
- SKILL.md 8 KB
- examples/ci-workflow.yml 4 KB
- examples/moon.yml 3 KB
- examples/workspace.yml 1 KB
- references/cli-reference.md 5 KB
- references/task-config.md 19 KB
- references/v2-migration.md 7 KB
- references/workspace-config.md 5 KB
Versions
The database has no other skills named moon.
Database snapshot: 13.11.2026 · package version 262512673685 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90moon-guide
Use when configuring moonrepo monorepo tasks. Triggers on `.moon/` config files, `moon.yml`, and prompts about task definitions, project tags, task inheritance, language toolchains, project queries, or task caching, even when the user doesn't say 'moonrepo'. - 100moonrepo
Runs and caches tasks across a monorepo with moonrepo (moon): a Rust-based build system that reads the project dependency graph, orders tasks, skips unchanged work, pins toolchains such as Node.js and pnpm, and runs only affected tasks in CI. Use when someone asks to "manage a… - 100publishing-with-release-please-and-moonrepo-on-github-actions
Coordinates Release Please policy, Moon project selection, source-derived publish metadata, and SHA-pinned GitHub Actions publication. Use when standardizing monorepo release.yml/publish.yml workflows across main and release/* branches without passing computed versions or GitHub… - 90integrate-opencut
Set up, inspect, develop, build, or test the OpenCut rewrite repository with its pinned Proto, Moon, Bun, Rust, web, API, and desktop toolchain. Use when the user explicitly mentions OpenCut-app/OpenCut, the OpenCut rewrite, Moon tasks, its future Editor API/MCP/headless… - 100selfhosted-grid-migration-skill
Migrate test automation from self-hosted Selenium Grid, docker-selenium, Selenoid, Aerokube Moon, Zalenium, and local Playwright/Puppeteer/Cypress/TestCafe/Appium to TestMu AI (formerly LambdaTest) in any language or framework. Covers localhost:4444 Selenium Grid,… - 100private-fixtures
Push, pull and use private test fixtures — real recordings, inboxes or other PII-bearing files that must never enter git — through the encrypted `test-fixtures` R2 bucket with `moon run fixtures:*`. Use when a test or eval needs a real corpus (a `.wav` voice recording for…