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

# Geval

> Decision orchestration for AI changes — policy-as-code, signals in, PASS / REQUIRE_APPROVAL / BLOCK out.

Geval is a **single static binary**. You supply **signals** (evidence from your pipeline or evals) and **policies** written as YAML rules. Geval applies your rules and returns a **single reconciled outcome** for CI and humans — no hidden scoring engine, no vendor-specific eval format.

<Card title="Watch the demo (YouTube)" icon="play" href="https://youtu.be/v6LuxIshgDU" horizontal>
  Video walkthrough: signals, policies, and outcomes (PASS / REQUIRE\_APPROVAL / BLOCK).
</Card>

<Card title="Quickstart" icon="rocket" href="/quickstart" horizontal>
  Run the built-in demo in under a minute, then scaffold a real contract with `geval init`.
</Card>

## What Geval does

| You provide                                                     | Geval does                                                  |
| --------------------------------------------------------------- | ----------------------------------------------------------- |
| **Signals** — JSON facts (metrics, scores, presence-only flags) | Builds a graph of evidence for rule matching                |
| **Contract** — lists policy file paths                          | Loads every referenced policy                               |
| **Policies** — ordered rules (`when` / `then`)                  | Evaluates rules, picks winners by priority, merges outcomes |

**Outcomes:** `PASS`, `REQUIRE_APPROVAL`, or `BLOCK` — with exit codes `0`, `1`, and `2` for automation.

**What Geval is not:** an eval runner, a model, or a hosted API. It does not invent thresholds; **you** encode them in policy YAML.

## Documentation map

<Columns cols={2}>
  <Card title="Install the binary" icon="download" href="/installation">
    Linux, macOS, Windows — download from GitHub Releases or build from source.
  </Card>

  <Card title="Contracts & policies" icon="file-lines" href="/configuration/contract-and-policies">
    How a contract references policies and how policies combine inside a contract.
  </Card>

  <Card title="Signals & rules" icon="signal" href="/concepts/signals-and-rules">
    Non-uniform signals, operators, priorities, presence rules.
  </Card>

  <Card title="CI/CD" icon="git-branch" href="/integration/github-actions">
    GitHub Actions, GitLab CI, exit codes, artifacts.
  </Card>
</Columns>

## Tools

* **[Config generator](https://config.geval.io)** — browser UI to produce `contract.yaml` and policy YAML, then validate with `geval validate-contract` and run `geval check`.

## Open source

Source and releases: **[github.com/geval-labs/geval](https://github.com/geval-labs/geval)**.