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

# dome judges

> Configure the Court convening trigger, inspect rulings, manage judges and constitution

| Command                         |                                       |
| ------------------------------- | ------------------------------------- |
| [List judges](#list-judges)     | `dome judges list`                    |
| [Get judge](#get-judge)         | `dome judges get <slug>`              |
| [Convening get](#convening-get) | `dome judges convening get`           |
| [Convening set](#convening-set) | `dome judges convening set`           |
| [Mode get](#mode-get)           | `dome judges mode get`                |
| [Mode set](#mode-set)           | `dome judges mode set`                |
| [Rulings list](#rulings-list)   | `dome judges rulings list`            |
| [Rulings get](#rulings-get)     | `dome judges rulings get <ruling-id>` |

The `dome judges` command surface mirrors the dashboard's Judges (Intelligent Authorization) pages. Refer to [Intelligent Depth](/govern/judges#decision-flow) for the conceptual model.

<Info>
  Renamed from `dome moot` in the 2026-06 release. Update shell scripts, agent configs, and CI jobs — there is no `dome moot` alias.
</Info>

***

## List judges

`dome judges list`

List every judge available in the workspace — preconfigured judges plus any custom judges created locally. Judge-CRUD commands are flat under `dome judges` to avoid stutter (`dome judges list`, not `dome judges judges list`).

## Get judge

`dome judges get <slug>`

Show one judge's full configuration: personality axes, system prompt, weight, and kind (`preconfigured` or `custom`).

| Arg    | Type   | Required | Description                        |
| ------ | ------ | -------- | ---------------------------------- |
| `slug` | string | Yes      | Judge slug from `dome judges list` |

Custom judges also support `create`, `edit`, and `delete` under the same flat group. Preconfigured judges are immutable.

## Convening get

`dome judges convening get`

Read the workspace's current Court trigger, effect, `escalate_no_match`, and `strict_audit_convene` flags. Equivalent to `dome judges mode get`.

Output includes:

* **Convening** — `disabled`, `no_match`, `policy_escalation`, `judge_policy`, or `all`
* **Effect** — `audit` or `live`
* **Escalate no\_match** — boolean (`policy_escalation` only)
* **Strict audit-convene** — boolean (`judge_policy` / `all` only)
* **Mode (legacy)** — back-compat single-axis mirror

## Convening set

`dome judges convening set`

Set the configurable Court convening trigger. The trigger and the effect are orthogonal axes — the trigger picks *when* the Court convenes, the effect picks *what* a verdict does once convened.

```bash theme={"system"}
dome judges convening set \
  --convening policy_escalation \
  --effect live \
  --escalate-no-match=false
```

| Flag                     | Type   | Required | Default | Description                                                                                                                                                  |
| ------------------------ | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--convening`            | string | Yes      | —       | `disabled`, `no_match`, `policy_escalation`, `judge_policy`, or `all`                                                                                        |
| `--effect`               | string | No       | `audit` | `audit` (observe-only) or `live` (apply the verdict)                                                                                                         |
| `--escalate-no-match`    | bool   | No       | `true`  | `policy_escalation` only — also convene on no\_match                                                                                                         |
| `--strict-audit-convene` | bool   | No       | `false` | `judge_policy` / `all` only — when `@court("strict")` pins a decision, still convene observe-only to record an audit ruling instead of suppressing the Court |

Under `--convening judge_policy`, the Court convenes only when a `judge` rule in the bundle matches the request. Refer to [Resolve Access Ambiguity](/govern/judges) for Judge configuration. `--escalate-no-match` is ignored — the judge rule itself decides whether `no_match` convenes.

<Info>
  `--convening all` + `--effect live` runs a full Court deliberation on every governed decision (\~14–18s added per call). Use `all` + `audit` to validate judge configuration at high coverage without impacting agent latency.
</Info>

A `@court("strict")` pin always forces the deterministic outcome — the Court can never move it. By default a pin suppresses the Court entirely; pass `--strict-audit-convene` to still record an observe-only ruling so you can audit judge agreement on pinned rules. Refer to [Resolve Access Ambiguity](/govern/judges).

## Mode get

`dome judges mode get`

Alias of `dome judges convening get`.

## Mode set

`dome judges mode set [disabled|audit|live]`

Set the legacy single-axis mode. Behavior-preserving shortcut for back-compat: `audit` and `live` set `convening=no_match`.

| Arg    | Type   | Description                    |
| ------ | ------ | ------------------------------ |
| `mode` | string | `disabled`, `audit`, or `live` |

Prefer `dome judges convening set` for `policy_escalation` and `all` triggers.

## Rulings list

`dome judges rulings list`

List Court rulings, newest first. The table includes a `DETERMINISTIC` column showing the deterministic Cedar outcome the Court convened on (`permit`, `forbid`, or `no_match`), alongside the final Court outcome — overrules are visible at a glance.

| Flag          | Type    | Description                                                       |
| ------------- | ------- | ----------------------------------------------------------------- |
| `--outcome`   | string  | Filter by Court outcome (`permit`, `forbid`, `court_unavailable`) |
| `--agent`     | string  | Filter by agent name or ID                                        |
| `--unanimous` | bool    | Only unanimous rulings                                            |
| `--split`     | bool    | Only split rulings                                                |
| `--start`     | RFC3339 | Lower time bound                                                  |
| `--end`       | RFC3339 | Upper time bound                                                  |
| `--limit`     | int     | Maximum results                                                   |

## Rulings get

`dome judges rulings get <ruling-id>`

Show one ruling's full detail — case inputs, votes per judge, tier breakdown, applied constitution clauses. The `Tier 0` field carries the deterministic baseline; a different `Court` value means the verdict overruled it.

| Arg         | Type   | Required | Description                                 |
| ----------- | ------ | -------- | ------------------------------------------- |
| `ruling-id` | string | Yes      | Ruling UUID from `dome judges rulings list` |