How do I install the Moonrepo Workspace skill?

Run npx skillmds@latest add prometheas-labs/moonrepo-workspace in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Moonrepo Workspace safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Moonrepo Workspace?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Moonrepo Workspace free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Moonrepo Workspace?

prometheas-labs (@prometheas-labs) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Moonrepo Workspace by prometheas-labs

Name: Moonrepo Workspace
Author: prometheas-labs

File contents

Moon v2 — Workspace Configuration

Reference for .moon/workspace.yml and workspace-level concerns.

workspace.yml Structure

$schema: './cache/schemas/workspace.json'
versionConstraint: '>=2.0.0'

projects:
  - 'apps/*'
  - 'packages/*'

vcs:
  client: 'git'           # not "manager" (v1 name)
  defaultBranch: 'main'

pipeline:                  # not "runner" (v1 name)
  cacheLifetime: '7 days'
  autoCleanCache: true
  logRunningCommand: false

telemetry: false

Key v2 Renames

v1	v2
`runner`	`pipeline`
`vcs.manager`	`vcs.client`
`vcs.syncHooks`	`vcs.sync`
`constraints.enforceProjectTypeRelationships`	`constraints.enforceLayerRelationships`
`.moon/toolchain.yml`	`.moon/toolchains.yml` (plural)

Project Discovery

# Glob patterns (auto-discover by directory)
projects:
  - 'apps/*'
  - 'packages/*'
  - '.'              # root project

# Explicit mapping
projects:
  web: 'apps/web'
  api: 'apps/api'

Projects need a moon.yml file to be recognized.

Toolchains (.moon/toolchains.yml)

Configures language runtimes. Each toolchain has its own settings.

javascript:
  packageManager: 'bun'

node:
  version: '22.0.0'

bun:
  version: '1.2.0'

Run moon toolchain info <name> to see available settings for any toolchain.

Caching and CI

Cache behavior

Tasks with cache: true and defined outputs are cached
pipeline.cacheLifetime controls retention (default: 7 days)
Remote caching configured via remote block with gRPC or HTTP endpoint

CI commands

moon ci                          # Run affected tasks in CI
moon ci --include-relations      # Include dependent projects
moon run :task --affected        # Run specific task for affected projects
moon run project:task --force    # Bypass cache

Affected detection

moon query changed-files         # List changed files (was "touched-files" in v1)
moon run :test --affected        # Run tests for affected projects only

Use --include-relations to include projects that depend on affected projects. Relations are no longer included by default in v2.

CLI Quick Reference

All flags use kebab-case in v2 (not camelCase).

moon check                       # Validate workspace config
moon project list                # List all projects
moon project <name>              # Show project details
moon run <project>:<task>        # Run a task
moon run :task                   # Run task across all projects
moon task <project>:<task>       # Show task details
moon toolchain info <name>       # Show toolchain settings

---name: moonrepo-workspacedescription: Use when configuring .moon/workspace.yml, .moon/toolchains.yml, project discovery, caching, CI pipelines, or running affected detection---# Moon v2 — Workspace ConfigurationReference for `.moon/workspace.yml` and workspace-level concerns.## workspace.yml Structure```yaml$schema: './cache/schemas/workspace.json'versionConstraint: '>=2.0.0'projects: - 'apps/*' - 'packages/*'vcs: client: 'git' # not "manager" (v1 name) defaultBranch: 'main'pipeline: # not "runner" (v1 name) cacheLifetime: '7 days' autoCleanCache: true logRunningCommand: falsetelemetry: false```## Key v2 Renames| v1 | v2 ||----|-----|| `runner` | `pipeline` || `vcs.manager` | `vcs.client` || `vcs.syncHooks` | `vcs.sync` || `constraints.enforceProjectTypeRelationships` | `constraints.enforceLayerRelationships` || `.moon/toolchain.yml` | `.moon/toolchains.yml` (plural) |## Project Discovery```yaml# Glob patterns (auto-discover by directory)projects: - 'apps/*' - 'packages/*' - '.' # root project# Explicit mappingprojects: web: 'apps/web' api: 'apps/api'```Projects need a `moon.yml` file to be recognized.## Toolchains (.moon/toolchains.yml)Configures language runtimes. Each toolchain has its own settings.```yamljavascript: packageManager: 'bun'node: version: '22.0.0'bun: version: '1.2.0'```Run `moon toolchain info <name>` to see available settings for any toolchain.## Caching and CI### Cache behavior- Tasks with `cache: true` and defined `outputs` are cached- `pipeline.cacheLifetime` controls retention (default: 7 days)- Remote caching configured via `remote` block with gRPC or HTTP endpoint### CI commands```bashmoon ci # Run affected tasks in CImoon ci --include-relations # Include dependent projectsmoon run :task --affected # Run specific task for affected projectsmoon run project:task --force # Bypass cache```### Affected detection```bashmoon query changed-files # List changed files (was "touched-files" in v1)moon run :test --affected # Run tests for affected projects only```Use `--include-relations` to include projects that depend on affected projects. Relations are no longer included by default in v2.## CLI Quick ReferenceAll flags use **kebab-case** in v2 (not camelCase).```bashmoon check # Validate workspace configmoon project list # List all projectsmoon project <name> # Show project detailsmoon run <project>:<task> # Run a taskmoon run :task # Run task across all projectsmoon task <project>:<task> # Show task detailsmoon toolchain info <name> # Show toolchain settings```

Frequently asked questions

Moonrepo Workspace