Reference

moon everyday loop

Install → init → map projects → run targets. Cheat sheet for the setup path (moon v2 docs).

Lesson 3 Architecture Glossary Resources

1. Install

Preferred: proto install moon (pin via .prototools)
macOS/Linux script → ~/.moon/bin + PATH
Repo pin: @moonrepo/cli devDep (global binary prefers repo package when present)

2. Init workspace

$ moon init
# optional: moon init --minimal

Creates .moon/ with required workspace.*
Touches .gitignore; infers VCS
Root may be .moon or .config/moon

3. Discover projects

Folders are invisible until listed in .moon/workspace.* → projects (required).

# map
projects:
  client: 'apps/client'
  server: 'apps/server'

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

# both
projects:
  globs:
    - 'apps/*'
  sources:
    www: 'www'

Inspect: moon project <id>

4. Tasks

Shared: .moon/tasks/** (inheritance by language/layer/tags…)
Local: <project>/moon.* (optional)

5. Run

$ moon run app:build
$ moon run client:dev server:dev
$ moon run :test
$ moon run '~:test'
$ moon run app:build --affected
$ moon run app:build -- --force   # passthrough args after --

moon run builds an action graph, runs deps first (topo), hashes/caches tasks. Default fail-fast.

VCS note

moon needs VCS for hashing/affected. Defaults to git; set vcs.defaultBranch if not master.