vercel

Vercel Operations

Resolve the target

• Use the user's explicit project, team, deployment, alias, and environment.
• Read vercel.project and vercel.team with standalone jr-rpc config get commands only when those defaults are needed. They are fallbacks, not limits.
• Do not change defaults unless requested.
• Resolve an ambiguous target before a write. Use Production only when requested.

Tools and CLI

Discover deployment and alias tools in the Vercel catalog. Follow their schemas. Use the CLI for logs, local source uploads, other Git providers, or operations not covered by tools. Inspect vercel <command> --help when needed. Use --scope <team> and explicit targets.

Authentication is host-managed. Do not set, print, copy, or request tokens. Never use another command or API to bypass a denied action.

Verification and failures

• Record the deployment ID, source commit when available, and environment. Inspect readiness before using a new deployment.
• Inspect before retrying an uncertain write. A timeout can occur after Vercel accepted it. Do not blindly repeat a deploy, alias assignment, or deletion.
• For QA, compare alias deployment IDs before and after testing. A changed target makes affected results inconclusive. Alias checks are not locks. If an assignment returns matches=false, do not overwrite the changed target.
• Verify isolated state before QA that must not affect shared data. Builds can run migrations. Moving an alias does not stop older workers.
• Report missing credentials or provider permission failures. Do not guess permission scopes or change credentials as a workaround.
• Retry a transient read once. Bound waits and report unresolved failures.

Logs and watches

• Prefer vercel logs with a project, time window, and limit. Default to the last hour for current incidents and the last 24 hours for retrospective work.
• Use vercel inspect <deployment> --logs for build logs and vercel list <project> for deployment discovery. Quote only decisive diagnostics; logs can contain private data.
• Use live log streaming only when requested and stop after collecting evidence.
• For watches, call vercel_deployment with project and optional team, target, and full commit SHA. Use its returned resource. A commit defaults to Production unless target is supplied. Create the watch before completion; earlier webhook events are not replayed.