vercel agent-runs CLI observability commands

Introduced 2026-07-03 · score 0.98

HOW TO USE IT

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.

WHY THIS HELPS

Inspect Agent Runs activity for a project or trace a specific run while debugging or reviewing a coding-agent workflow.

REQUIREMENTS AND LIMITATIONS

• 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.

FIRST-PARTY EVIDENCE

• 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

Check the installed version and the source before using it. Entry JSON

Report a problem with this card