Skip to content

Use Buzz With AI Agents

Use this guide to let a coding agent run the Buzz CLI for you. Buzz publishes an agent skill that tells the agent how to install the CLI, sign in, and deploy a site.

You need:

  • Node.js 22 or later and npm.
  • A coding agent that supports skills.
  • A Buzz server URL, as described in Deploy Your First Site.

Install the skill:

Terminal window
npx skills add infomiho/buzzstatic

The installer asks which of your agents to install it for. The skills CLI documents the other options.

Ask the agent to deploy a build directory:

Deploy ./dist to Buzz as my-site.

The skill instructs the agent to confirm Node.js 22 and the buzz command, then run buzz server --json to find the selected server. The agent uses the server you ask for, or the selected one, and passes its URL with --server on every later command, so a changed default can’t redirect the task. When sign-in is needed, the agent runs buzz login --server <url> --no-browser and gives you the approval link and code. It deploys with an explicit site name and asks before running buzz delete or buzz access public.

Say which server to use when you have several, for example Deploy ./dist to my work Buzz server as my-site. See Use Several Servers.

buzz login stores the session in ~/.buzz.config.json. The agent runs commands against that session and does not need the credential itself.

For unattended work, provide a site-scoped deployment token through the BUZZ_TOKEN environment variable instead of pasting it into a prompt. Automate Deployments explains how to create one.