EvalGlass

How it works

You ask. Your agent runs the loop. You decide what gates.

EvalGlass runs as one local loop your coding agent drives: it derives project-specific checks from your own system — code, schemas, prompts and real traces — runs them locally in your repo, and hands back a scorecard you own, informational until you promote a gate on a threshold you approve.

The shape of a run

Your system in, a scorecard you own out.

The loop

One loop your agent runs — and each step is a command.

  1. 1

    Ask

    Ask a normal product question in plain language: evaluate this app, compare this model, explain this drift.

    no command · you just ask
  2. 2

    Observe

    It reads repo context, prompts, model calls, tools, and your exported traces — read-only, no network.

    command setup connect
  3. 3

    Shape

    It authors project-specific checks — metrics, rubrics, scenarios, judges, baselines — each landing proposed, never approved.

    command add-metric add-judge calibrate
  4. 4

    Run

    The vendored runtime evaluates behavior from that evidence, locally. The plugin never computes a verdict itself.

    command run
  5. 5

    Read

    The scorecard explains every value, delta, and authority state — and says plainly what the run does not claim.

    command view explain
  6. 6

    Cluster next

    Group failing and non-scored items by shared cause, so a flat number becomes one actionable failure mode.

    shipping next
  7. 7

    Watch next

    Re-run on a schedule and compare to your baseline — a typed drift.json from cron or CI, never a daemon.

    command watch
  8. 8

    Improve

    Fix prompts, switch models, add examples, tune metrics — or wire CI to gate on a threshold you approve.

    command compare ci
  9. — and back to Ask. The loop repeats as your app changes; each pass leaves the suite a little stronger.

Everything the agent proposes lands proposed and informational — it suggests what to measure, never approves it. A fresh run reports; it doesn’t fail your build until you promote a gate on a threshold you approve. Every verb & prompt, in the docs →

The coding agent operates. The repo owns the truth. The runtime computes. The human grants authority.

That chain is the whole design: nothing grants itself authority, and a green scorecard never means more than the run measured. What green doesn’t mean →

Who holds what

Four roles — and only one of them decides.

Coding agent

Reads your system, scaffolds checks, runs commands, and explains results.

never grants authority or fails a build.

EvalGlass runtime

Vendored into your repo; computes typed scorecards and verdicts, deterministically.

never edits your application or phones home.

Host repo

Owns the examples, traces, metrics, thresholds, calibration, and baselines.

never silently overwritten — every change is a diff you review.

You

Promote a metric to a gate, approve the threshold, accept the calibration.

the only source of authority in the system.

The wider loop

Core runs it. Add the next product only when the problem changes.

Everything above is Core — open source, in your repo, today. Two commercial products extend the same loop when the question changes: Discovery when you need the checks your suite is not even measuring yet, and Intelligence when a failure is real but you cannot yet say why. Each hands back ordinary Core artifacts you keep.

Core

open source

Runs the loop above — derive, run, read, improve — owned as code in your repo, gated only on a threshold you approve.

Discovery

private preview

Reads a bounded view of your app and proposes the evaluations it is missing — coverage gaps and candidate checks you review, edit and keep.

Intelligence

private preview

Tests why a hard failure occurs with controlled replay and intervention, verifies the repair, and preserves it as a durable Core regression.

Discovery and Intelligence are separate, paid, pre-alpha products — neither is generally available, and neither is shown running here. Compare all three →

Related

Learn
the mental model behind the loop
Use cases
the moments that trigger a run
Scorecards
the artifact you get back
Get Core
two commands in Claude Code