# Agents can now find Vercel CLI commands by describing the task

> Source: <https://vercel.com/changelog/agents-can-now-find-vercel-cli-commands-by-describing-the-task>
> Published: 2026-11-19 05:00:00+00:00

**Key takeaway:** Coding agents can call `vercel help search "<task>" --with-help --json` to get the matching command plus its options and examples in one call, and API matches return a `vercel api` command with placeholders for every required input.

Coding agents can now use `vercel help search` to find Vercel CLI commands by describing a task in plain language.

The search returns a list of matching commands. Add `--with-help` to include the help page for the first result in the same call. For example, `vercel help search "roll back production" --with-help` returns the options and examples for `vercel rollback`.

Search also supports:

**API endpoints:** When a Vercel API endpoint matches the task, search returns a `vercel api` command with the request path and placeholders for every required input. The agent can fill in the values without guessing the path.

**JSON output:** Use `--json` to return search results as JSON. Combine it with `--with-help` to include usage instructions, options, and examples for the first result.

Search recognizes common wording, such as “show” instead of “list,” and handles minor spelling mistakes.

The CLI also includes a skill that tells coding agents to start with `vercel help search` when looking for a command. Vercel doesn't log your search text.

Update to the latest Vercel CLI with `vercel upgrade`.
