Pixel Eagle

Auto Comparison

Instead of specifying a run ID to compare against, you can let Pixel Eagle automatically select the best matching run based on metadata filters. This is especially useful in CI where you want to compare against the latest run on a base branch.

Exact Match

Filter for the latest run with a specific metadata value:

# API
curl https://pixel-eagle.com/runs/$run_id/compare/auto \
  --json '{"branch": "main"}' --oauth2-bearer $token

# CLI
pixeleagle compare-run $run_id --filter branch:main

Same Value Match

Find a run that has the same value for a metadata field as the current run. Use the special <same> marker in the API, or --same in the CLI:

# API
curl https://pixel-eagle.com/runs/$run_id/compare/auto \
  --json '{"platform": "<same>"}' --oauth2-bearer $token

# CLI
pixeleagle compare-run $run_id --same platform

Combining Filters

You can combine multiple filters to narrow down the matching run. For example, find the latest run on the "main" branch with the same platform:

# API
curl https://pixel-eagle.com/runs/$run_id/compare/auto \
  --json '{"branch": "main", "platform": "<same>"}' --oauth2-bearer $token

# CLI
pixeleagle compare-run $run_id --filter branch:main --same platform