agent-vercel

Vercel CLI for AI agents

Language
Go
Version
0.16.0
License
PolyForm Perimeter 1.0.0
Category
CLI Tool

A Vercel CLI for AI agents that triages and carefully acts on Vercel through compact, structured output. Read-default and cross-project: what is live including rolling releases, build and runtime logs, env-var diffs across environments, domains, DNS, certs and the Firewall, CDN cache purges, and what is driving spend — without exposing the Vercel token to the agent.

Features

01

Answers the questions the vercel CLI cannot — which deploy is live across these projects, why this build failed, what env var is missing in prod, what DNS record is absent; all read-oriented, cross-project and historical

02

Credential and scope are separate axes — one keychain-stored token reaches many teams, so --auth picks the secret and --scope picks the team

03

The token has no way out — stored in the keychain, never printed, and there is no command to read it back

04

Fifteen command domains — auth, scope, deployment, project, env, domain, alias, firewall, cache, billing, webhook, drains, edge-config, api and config

05

Deployment triage end to end — list, get, checks, routes, what is current, build logs and runtime logs

06

Env diffing across environments without printing secret values, plus shared env vars and pull

07

Domain and cert work in one place — inspect intended vs actual nameservers, list DNS records, bulk cert expiry triage, and which project an apex is attached to

08

Firewall visibility — WAF config, live attack status and bypass rules

09

CDN cache invalidation by tag

10

Spend, broken down — charges by service, project or region, plus consumption

11

Observability plumbing — webhooks and log/trace/analytics drains, so you can see where data is being shipped

12

Mutation safety — promote, rollback, cancel, redeploy, env writes, domain and alias changes and cache purges all require --yes

13

Raw REST escape hatch for anything not yet wrapped

14

Tested offline against a fixture Vercel server, with opt-in live read-only shape checks

Install

Homebrew

>_
$ brew install shhac/tap/agent-vercel

AI Agent Skill

>_
$ npx skills add shhac/agent-skills --skill agent-vercel --global

GitHub Release (macOS)

>_
$ curl -L https://github.com/shhac/agent-vercel/releases/latest/download/agent-vercel-darwin-arm64.tar.gz | tar xz

Go Install

>_
$ go install github.com/shhac/agent-vercel/cmd/agent-vercel@latest

Build from Source

>_
$ git clone https://github.com/shhac/agent-vercel.git && cd agent-vercel && make build

Getting Started

One Vercel credential reaches many teams, so agent-vercel keeps the two apart: auth manages the secret, scope selects the team. Create a token at vercel.com/account/tokens, or import one the vercel CLI already stored.

01 · Store a token in the keychain

>_
$ agent-vercel auth add personal

The label is optional and defaults to "default". agent-vercel auth import-cli picks up a token the vercel CLI already has.

02 · Verify the credential

>_
$ agent-vercel auth test

Checks it against GET /v2/user without printing the secret.

03 · Pick a team to act on

>_
$ agent-vercel scope set-default acme

scope list shows every team the credential reaches. Override per call with --scope; --auth switches credential independently.

04 · See what is live in production

>_
$ agent-vercel deployment current --prod

Including rolling releases. agent-vercel usage prints the LLM-oriented overview of the whole surface.

Usage

>_ What is live in production right now
$ agent-vercel deployment current --prod
>_ Why the build failed
$ agent-vercel deployment logs dpl_... --limit 100
>_ Which env var is missing in prod
$ agent-vercel env diff --project web production preview
>_ Is this domain configured correctly
$ agent-vercel domain inspect example.com
>_ Certs about to expire
$ agent-vercel domain cert list
>_ Is something attacking us
$ agent-vercel firewall attack-status --project web
>_ What is driving the bill
$ agent-vercel billing charges --by project
>_ Invalidate CDN cache by tag
$ agent-vercel cache purge --tag products --yes
>_ Roll back a bad production deploy
$ agent-vercel deployment rollback --project web --yes