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.

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

Config

Get the current YAML:

tpc council config get
tpc council config get --out config.yaml

Replace it from a file (or stdin):

tpc council config set --file config.yaml
cat config.yaml | tpc council config set --file -

Edit it in $VISUAL or $EDITOR:

tpc council config edit

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

tpc council config delete

Run

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

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

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:

tpc council delete --snapshot <snapshotId>

Snapshots still generating cannot be deleted.

JSON output

tpc --format json council list
tpc --format json council config get
tpc --format json council get --snapshot <snapshotId>

Get started

Commands

Recipes

Reference

Model council

Model council

Config

Run

Results

Delete a snapshot

JSON output

​Model council

​Config

​Run

​Results

​Delete a snapshot

​JSON output

Model council

Config

Run

Results

Delete a snapshot

JSON output