Using the CLI from an AI agent

The CLI ships with an agent skill: a short guide that teaches your AI coding assistant how to use it. Once it's installed, you can describe a rendering job in plain English and the agent runs the right commands for you.

Install the skill

urlbox skill install --target claude-code

• --target can be claude-code, cursor, codex, or opencode.
• --scope is user (available in all your projects) or project (this repository; commit it so teammates get it too). Run urlbox skill install bare and it asks you for both.

To read the skill yourself rather than install it:

urlbox skill show

Render in plain English

With the skill installed, just describe what you want:

"Use the Urlbox CLI to grab a full-page PNG of stripe.com and save it as stripe.png."

"Read urls.csv and save a full-page screenshot of each URL into ./shots, named by the company column."

The agent picks a format and loops where needed, so a batch job becomes a sentence rather than a script.

Sign in yourself with urlbox login first. The agent then drives the CLI without needing to see your credentials; secrets are masked in every command's output unless you explicitly pass --reveal.