vercel-status

Files (2)

• SKILL.md
• run.sh · scripts/

SKILL.md (first lines)

# Vercel Status

Queries the Vercel REST API (`https://api.vercel.com`) directly — does not shell out
to the `vercel` CLI. This keeps the skill runnable from any environment that has
`curl` + `python`, without needing the CLI installed in the openclaw container.

The `projectId`, `orgId` (team), and `projectName` are read from `.vercel/project.json`
at repo root (created by `vercel link`) at runtime — the script reads them itself, so
they are not duplicated here.

Auth is via `VERCEL_TOKEN` env var, passed as `Authorization: Bearer $VERCEL_TOKEN`.
Generate at https://vercel.com/account/settings/tokens. If the token is missing the
skill fails loud — per the "no silent defaults" rule, it will not fall back to
anonymous calls.

## Usage

```bash
scripts/run.sh                    # Full overview: latest prod + recent deployments + domains
scripts/run.sh deployments [n]    # Recent deployments (default 5)
scripts/run.sh production         # Latest production deployment only
scripts/run.sh domains            # Domains attached to the project
```

## Endpoints used

- `GET /v6/deployments?projectId=...&teamId=...&limit=N` — list recent deployments
- `GET /v6/deployments?projectId=...&teamId=...&target=production&limit=1` — latest prod
- `GET /v9/projects/{projectId}/domains?teamId=...` — project domains

## Output

For each deployment: `url`, `state` (READY / BUILDING / ERROR / CANCELED), `target`
(production / preview), `createdAt`, git commit SHA if present. Domains show the
hostname and verification state.

From Glad-Labs/poindexter, Apache-2.0.

More from Glad-Labs/poindexter