{
  "slug": "vercel-agent-runs-cli-observability-commands-b4d4023927be",
  "title": "vercel agent-runs CLI observability commands",
  "tools": [
    "vercel"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-07-03T00:04:43.000Z",
  "announced_at": "2026-07-03T00:04:43.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When debugging or reviewing Agent Runs, use the Vercel CLI to list runs for a project, inspect a run, view its trace, or list active projects. Add `--json` to any subcommand for raw JSON output.",
    "examples": [
      "vercel agent-runs list --project <project-name-or-id> --environment <production|preview> --since <time> --until <time> --json",
      "vercel agent-runs inspect <runId> --project <project-name-or-id> --environment <production|preview> --json",
      "vercel agent-runs trace <runId> --project <project-name-or-id> --environment <production|preview> --json"
    ],
    "gotchas": [
      "Version: 54.20.0",
      "<runId> (required): Agent Run ID to inspect or trace.",
      "--project <NAME|ID>: Project name or ID; overrides the linked project.",
      "--environment <production|preview>: Environment to query; defaults to production.",
      "--since <TIME>: Include runs after ISO 8601 time or relative time such as `1h`, `30m`, or `7d`.",
      "--until <TIME>: Include runs before this time; requires `--since`, defaults to now.",
      "--json: Print the raw API response as JSON to stdout.",
      "Prerequisite: Install Vercel CLI with `pnpm i -g vercel`.",
      "Prerequisite: Log in before accessing resources; CI can authenticate with a token using `--token`.",
      "Prerequisite: The CLI supports selecting a team with `--scope`; run from a linked project directory or specify a project with `--project`.",
      "`list` lists Agent Runs for a project.",
      "`projects` lists projects in the team with Agent Runs activity."
    ]
  },
  "why_it_matters": "Inspect Agent Runs activity for a project or trace a specific run while debugging or reviewing a coding-agent workflow.",
  "sources": [
    "https://github.com/vercel/vercel/releases/tag/vercel%4054.20.0",
    "https://github.com/vercel/vercel/blob/vercel@54.20.0/packages/cli/src/commands/agent-runs/command.ts",
    "https://vercel.com/docs/cli"
  ],
  "rank": 0.98036,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v1+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "backfill-20261007",
    "verdict_id": "backfill-20261007:backfill-20261007-c0cdd5cb2639375c-0:gate",
    "evidence_hash": "3b16b4b481625ad7faa8f616a40070bd1df78feafbf277f79b23a141cfd34826"
  },
  "review": {
    "draft_hash": "ed2d389afb4cfe59b5a03dc6e4e3cbe601140faa79d70c0bd6f3ae89bcd1f380",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "backfill-20261007:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.98 >= 0.9; 2 needed) and Jev gave 0.73 (>= 0.6 needed)."
  }
}