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
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
Credential and scope are separate axes — one keychain-stored token reaches many teams, so --auth picks the secret and --scope picks the team
The token has no way out — stored in the keychain, never printed, and there is no command to read it back
Fifteen command domains — auth, scope, deployment, project, env, domain, alias, firewall, cache, billing, webhook, drains, edge-config, api and config
Deployment triage end to end — list, get, checks, routes, what is current, build logs and runtime logs
Env diffing across environments without printing secret values, plus shared env vars and pull
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
Firewall visibility — WAF config, live attack status and bypass rules
CDN cache invalidation by tag
Spend, broken down — charges by service, project or region, plus consumption
Observability plumbing — webhooks and log/trace/analytics drains, so you can see where data is being shipped
Mutation safety — promote, rollback, cancel, redeploy, env writes, domain and alias changes and cache purges all require --yes
Raw REST escape hatch for anything not yet wrapped
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
$ agent-vercel deployment current --prod $ agent-vercel deployment logs dpl_... --limit 100 $ agent-vercel env diff --project web production preview $ agent-vercel domain inspect example.com $ agent-vercel domain cert list $ agent-vercel firewall attack-status --project web $ agent-vercel billing charges --by project $ agent-vercel cache purge --tag products --yes $ agent-vercel deployment rollback --project web --yes