> ## Documentation Index
> Fetch the complete documentation index at: https://docs.formae.io/llms.txt
> Use this file to discover all available pages before exploring further.

# formae eval

> Evaluate a forma and print the resolved result without applying it. Reference for formae eval and its flags.

Evaluate a forma and print the resolved result. `eval` runs the same evaluation
that `apply` does, so you can inspect exactly what a forma resolves to before you
apply it. It does not change any infrastructure.

```bash theme={"languages":{"custom":["/languages/pkl.json"]}}
formae eval [flags] <forma file>
```

## Examples

```bash theme={"languages":{"custom":["/languages/pkl.json"]}}
formae eval forma.pkl
formae eval --mode patch forma.pkl
formae eval --output-consumer machine --output-schema yaml forma.pkl
```

## Flags

| Flag                                 | Default     | Description                                                                                                                                                                                                                                                             |
| ------------------------------------ | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--mode <reconcile\|patch>`          | `reconcile` | Apply mode to evaluate against.                                                                                                                                                                                                                                         |
| `--beautify`                         | `true`      | Beautify output. Human consumer only.                                                                                                                                                                                                                                   |
| `--colorize`                         | `true`      | Colorize output. Human consumer only.                                                                                                                                                                                                                                   |
| `--schema-location <remote\|local>`  | `remote`    | How plugin PKL schemas are referenced when serializing the evaluated forma. `remote` emits `package://` URIs fetched from the hub. `local` emits local file imports against the agent's on-disk PklProject paths, and requires the CLI and agent to share a filesystem. |
| `--output-consumer <human\|machine>` | `human`     | Consumer of the command result.                                                                                                                                                                                                                                         |
| `--output-schema <json\|yaml>`       | `json`      | The schema to use for the result output.                                                                                                                                                                                                                                |
| `--config <path>`                    |             | Path to a config file.                                                                                                                                                                                                                                                  |
| `--profile <name>`                   |             | Named profile to use.                                                                                                                                                                                                                                                   |

Like `apply` and `destroy`, `eval` also exposes the property flags declared by the
forma it evaluates.