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

# Model council

> Run Model Council snapshots, manage config.yaml, and read or delete results from the TPC CLI.

# Model council

`tpc council` is the CLI for Model Council. It scores every response for a product, topic, or prompt against the product's question config. You can run a council snapshot, read status and reports, replace the config YAML, and delete completed snapshots.

`tpc snapshot` is an alias for `tpc council`.

<Note>
  Run `tpc org switch <org-slug>` and `tpc product switch <product-slug>` first. Saving or deleting `config.yaml` requires an admin session.
</Note>

## Config

Get the current YAML:

```bash theme={null}
tpc council config get
tpc council config get --out config.yaml
```

Replace it from a file (or stdin):

```bash theme={null}
tpc council config set --file config.yaml
cat config.yaml | tpc council config set --file -
```

Edit it in `$VISUAL` or `$EDITOR`:

```bash theme={null}
tpc council config edit
```

Delete it. `tpc council run` will fail until a new config is uploaded:

```bash theme={null}
tpc council config delete
```

## Run

Fast mode is on by default (synchronous gateway analysis). Pass `--fast-mode=false` for the batch path.

```bash theme={null}
tpc council run
tpc council run --product my-product
tpc council run --product my-product --topic <topicId>
tpc council run --prompt <promptId>
tpc council run --from 2025-01-01 --to 2025-04-01
tpc council run --fast-mode=false
```

`run` starts the workflow and exits. Council runs can take a long time. Check status with `list`.

## Results

```bash theme={null}
tpc council list
tpc council get --snapshot <snapshotId>
tpc council report --snapshot <snapshotId>
tpc --format json council report --snapshot <snapshotId> > report.json
```

`report` prints a markdown summary by default (executive summary, tracked signals, suggested actions, and a capped claims table). Use `--format json` for the full payload. The report is only available for snapshots with status `completed`.

## Delete a snapshot

There is no API to patch an existing snapshot row. Change the scoring rubric with `tpc council config set`, then run again. Delete a completed or failed snapshot with:

```bash theme={null}
tpc council delete --snapshot <snapshotId>
```

Snapshots still generating cannot be deleted.

## JSON output

```bash theme={null}
tpc --format json council list
tpc --format json council config get
tpc --format json council get --snapshot <snapshotId>
```