---
name: "Vercel"
description: Inspect and manage Vercel projects, deployments, domains, env vars, and logs through the official `vercel` CLI.
version: 1
situations: vercel, deployments, hosting, domains, preview builds
requires-secrets:
requires-packages:
requires-connector: vercel
---

# Vercel (`vercel`)

Runs through Vercel's official CLI in your **bash** tool. The operator connected the account from 00's
skill store.

## First, know who you are

```
vercel whoami
vercel teams ls
```

If `whoami` errors, tell the operator to open **Skill store → Vercel → Connect**. Most commands take
`--scope TEAM` — when the operator belongs to several teams, ask which one rather than guessing, since
the wrong scope silently returns a different project list.

## Read

```
vercel projects ls
vercel ls PROJECT                      # recent deployments
vercel inspect DEPLOYMENT_URL          # build meta, routes, sizes
vercel logs DEPLOYMENT_URL             # runtime logs
vercel domains ls
vercel env ls production               # NAMES only — never `vercel env pull` into the workspace
```

`vercel env ls` shows variable names. Do not run `vercel env pull`, `vercel env get`, or anything else
that writes secret VALUES into a file the agent can read — if a value is needed, ask the operator to
add it to 00's vault instead.

## Deploying

A deploy is outward-facing. Preview deploys are cheap and reversible; production deploys are not.

```
vercel deploy                          # preview
vercel deploy --prod                   # ask first, every time
vercel rollback DEPLOYMENT_URL         # ask first
```

Say which project and which scope you are deploying, and wait for a yes before `--prod`.

## Debugging a failed build

1. `vercel ls PROJECT` — find the failed deployment.
2. `vercel inspect URL --logs` — read the build output, not just the last line.
3. Report the first error in the log, not the final "command exited with 1", which never says why.

## Never without being asked in this turn

`vercel remove` (deletes deployments or a project), `vercel domains rm`, `vercel env rm`, and
`--prod` deploys.