fyrer.yml Configuration File: Complete Field Reference

fyrer reads a fyrer.yml file in the current directory (or the path passed to --config). The file declares the config format version, global environment variables, cache settings, and a list of packages with their tasks. fyrer validates the file at startup and resolves all paths relative to the directory that contains fyrer.yml.

Top-level structure

version: 1                # Required. Must be 1.
cache:
  provider: local         # Cache backend. Only "local" is available.
env:                      # Variables available to all packages and tasks.
  NODE_ENV: development
concurrency: 8            # Max concurrent tasks (default: CPU count)
packages:                 # List of packages in your monorepo.
  - name: web
    root: ./apps/web
    tasks:
      dev:
        cmd: bun run dev
        persistent: true

Top-level fields

Field	Type	Required	Description
`version`	integer	Yes	Config format version. Must be `1`.
`cache`	object	No	Cache configuration.
`cache.provider`	string	No	Cache backend. Only `"local"` supported.
`env`	map	No	Environment variables for all packages.
`concurrency`	integer	No	Max concurrent tasks. Defaults to available parallelism.
`packages`	array	Yes	List of package definitions.

Where to place fyrer.yml

Place fyrer.yml at the root of your monorepo — the directory that is the common ancestor of all your packages. Run fyrer from that same directory so that package root paths and task glob patterns resolve correctly. If you need to point at a different file, pass the --config flag: