Tasks Configuration

The .moon/tasks/**/* configuration files define tasks and file groups that are inherited by projects based on conditions. This enables centralized task management and reduces duplication.

Configuration Files

Location: .moon/tasks/*.yml or .moon/tasks/*.json Type: InheritedTasksConfig Common files:

.moon/tasks/node.yml - Node.js/JavaScript projects
.moon/tasks/rust.yml - Rust projects
.moon/tasks/python.yml - Python projects
.moon/tasks/all.yml - All projects

Schema

Core Settings

extends

string | string[]

Extends one or many task configuration files. Supports relative paths or HTTPS URLs.

extends: 'https://example.com/.moon/tasks/base.yml'

_{Added in v1.12.0}

inheritedBy

InheritedByConfig

Conditions that determine which projects inherit this configuration.

Show properties

order

number

Inheritance order. Lower values are inherited first.If not defined, order is calculated based on conditions:

Base: 0
Toolchains/Languages: +50
Stacks: +100
Layers: +150
Tags: +500

toolchains

InheritedConditionConfig

Matches against project toolchains.

# Single value
inheritedBy:
  toolchains: 'node'

# Multiple values (OR)
inheritedBy:
  toolchains: ['node', 'bun']

# Logical operators
inheritedBy:
  toolchains:
    or: ['node', 'bun']
    not: ['rust']

languages

InheritedConditionConfig

Matches against project language setting.

stacks

InheritedConditionConfig

Matches against project stack setting.

inheritedBy:
  stacks: ['frontend', 'backend']

layers

InheritedConditionConfig

Matches against project layer setting.

inheritedBy:
  layers: ['library', 'tool']

Tasks

tasks

object

Map of task identifiers to task configurations.

tasks:
  format:
    command: 'prettier --check .'
    inputs:
      - 'src/**/*'
  
  lint:
    command: 'eslint .'
    options:
      cache: true
  
  test:
    command: 'jest --passWithNoTests'

Each task supports the following fields:

Show Task Fields

command

string | string[]

Command to execute. Use for single commands with arguments.

tasks:
  lint:
    command: 'eslint --fix .'
    # Or array format
    command:
      - 'eslint'
      - '--fix'
      - '.'

script

string

Script to execute. Supports pipes, redirects, and multiple commands.

tasks:
  cleanup:
    script: 'rm -rf dist && mkdir dist'

_{Added in v1.27.0}

args

string | string[]

Additional arguments to append to the command.

tasks:
  test:
    command: 'jest'
    args: '--coverage --verbose'

description

string

Human-readable description of the task._{Added in v1.22.0}

extends

string

Extends settings from another task.

tasks:
  lint:
    command: 'eslint .'
  lint-fix:
    extends: 'lint'
    args: '--fix'

_{Added in v1.12.0}

deps

string[]

Task dependencies (targets) to run before this task.

tasks:
  build:
    command: 'vite build'
    deps:
      - 'design-system:build'
      - '~:generate'

Supports args and env overrides:

deps:
  - target: 'api:build'
    args: ['--production']
    env:
      NODE_ENV: 'production'

inputs

string[]

Files, globs, and environment variables that affect the task.

tasks:
  build:
    inputs:
      # Files and globs
      - 'src/**/*'
      - 'package.json'
      # Workspace-relative
      - '/tsconfig.json'
      # Environment variables
      - '$NODE_ENV'
      # File groups
      - '@group(sources)'
      # External projects
      - 'project://design-system?group=sources'

Advanced file input options:

inputs:
  - file: 'config.json'
    optional: true
  - file: 'src/constants.ts'
    content: 'API_KEY|SECRET'

outputs

string[]

Files and folders created by the task.

tasks:
  build:
    outputs:
      - 'dist'
      - 'build/**/*.js'

Advanced output options:

outputs:
  - file: 'dist/optional.js'
    optional: true

env

object

Environment variables for the task.

tasks:
  build:
    env:
      NODE_ENV: 'production'
      API_URL: '${BASE_URL}/api'

toolchains

string | string[]

Toolchains the command runs on.

tasks:
  build:
    command: 'npm run build'
    toolchains: ['javascript', 'node', 'npm']

_{Added in v1.31.0}

preset

'server' | 'utility'

Applies a preset configuration.

server: Long-running processes (cache off, streaming output, persistent, no CI)
utility: Interactive utilities (cache off, interactive, streaming output)

tasks:
  dev:
    command: 'vite'
    preset: 'server'

_{Added in v1.28.0}

options

TaskOptionsConfig

Additional task options. See Task Options section below.

taskOptions

TaskOptionsConfig

Default options inherited by all tasks in this configuration.

taskOptions:
  cache: true
  retryCount: 2
  runInCI: true

tasks:
  build:
    # Inherits taskOptions
    command: 'vite build'
    options:
      # Override specific options
      cache: false

_{Added in v1.20.0}

File Groups

fileGroups

object

Maps file group IDs to lists of globs, paths, or environment variables.

fileGroups:
  sources:
    - 'src/**/*'
    - 'types/**/*'
  configs:
    - '*.config.{js,ts}'
    - 'tsconfig.json'
  tests:
    - 'tests/**/*'
    - '**/__tests__/**/*'

File groups are relative to each project that inherits them.

Implicit Settings

implicitDeps

string[]

Task dependencies automatically inserted into all inherited tasks.

implicitDeps:
  - '^:build'

Useful for ensuring dependencies are built before dependent tasks run.

implicitInputs

string[]

Inputs automatically inserted into all inherited tasks.

implicitInputs:
  - 'package.json'
  - '/tsconfig.json'

Ensures common configuration changes trigger task reruns.

Task Options

Task options control execution behavior and can be defined in options or taskOptions.

cache

boolean | 'local' | 'remote'

default:true

Controls caching of task results.

options:
  cache: false       # Disable caching
  cache: 'local'     # Only local cache
  cache: 'remote'    # Only remote cache

cacheKey

string

Custom key for cache invalidation._{Added in v1.35.0}

cacheLifetime

string

How long cached results are valid (e.g., “1 day”, “2 hours”)._{Added in v1.29.0}

runInCI

boolean | 'always' | 'skip' | 'only'

default:true

Controls execution in CI environments.

true/affected: Run if affected
false: Never run
always: Always run
skip: Skip but allow dependencies
only: Only in CI

options:
  runInCI: 'always'

runFromWorkspaceRoot

boolean

default:false

Run task from workspace root instead of project root.

persistent

boolean

default:false

Marks task as long-running (e.g., servers)._{Added in v1.6.0}

interactive

boolean

default:false

Marks task as interactive (needs stdin)._{Added in v1.12.0}

internal

boolean

default:false

Marks task as internal-only (can’t be run directly)._{Added in v1.23.0}

outputStyle

'buffer' | 'buffer-only-failure' | 'hash' | 'none' | 'stream'

Controls stdout/stderr display.

retryCount

number

default:0

Number of retry attempts on failure.

timeout

number

Maximum execution time in seconds._{Added in v1.26.0}

priority

'critical' | 'high' | 'normal' | 'low'

default:"normal"

Task priority in the pipeline queue._{Added in v1.35.0}

allowFailure

boolean

default:false

Allows task to fail without failing the pipeline._{Added in v1.13.0}

affectedFiles

boolean | 'args' | 'env'

Passes affected files as arguments or environment variable.

options:
  affectedFiles: true  # Both args and env
  affectedFiles: 'args'  # Only args
  affectedFiles: 'env'  # Only MOON_AFFECTED_FILES

mutex

string

Creates exclusive lock on a virtual resource._{Added in v1.24.0}

'linux' | 'macos' | 'windows' | array

Restricts task to specific operating systems._{Added in v1.28.0}

shell

boolean

Whether to run command in a shell.

unixShell

string

Shell to use on Unix (bash, fish, zsh, etc)._{Added in v1.21.0}

windowsShell

string

Shell to use on Windows (pwsh, bash, etc)._{Added in v1.21.0}

envFile

boolean | string | string[]

Load environment variables from .env files.

options:
  envFile: true  # Auto-load .env files
  envFile: '.env.production'
  envFile:
    - '.env'
    - '.env.local'

inferInputs

boolean

default:false

Automatically infer inputs from commands._{Added in v1.31.0}