Overview

The Urlbox CLI is a small, validated command-line tool over the Urlbox API. It renders screenshots, PDFs and videos from your terminal, signs render URLs offline, installs as a skill your AI coding agent can use directly, and manages your projects, storage, proxies and LLM credentials from the same place. Every command returns a predictable result and a clear exit code, so it's safe to drop into scripts and CI.

Install it from npm or GitHub. Found a bug? Report it.

The 30-second version

npm install -g @urlbox/cli
urlbox login
urlbox screenshot https://urlbox.com --output hello.png

New here? The CLI quickstart walks through it with live terminal recordings.

That's a screenshot saved to disk. Swap screenshot for pdf or video, point it at any URL, and you're done.

Three pieces, working together

• The API — powered by our Web Vision Engine™, same as always.
• The CLI — puts it in your terminal.
• The agent skill — teaches your AI agent how to use it.

The upshot: anything you can do with the Urlbox API, you can now do from the command line, or get an agent to do in plain English. See Using the CLI from an AI agent.

What's in this guide

• Quickstart — install to your first screenshot, with live terminal recordings.
• Install — npm, Homebrew, Scoop, and keeping it up to date.
• Authentication — sign in with urlbox login, switch orgs and projects; URLBOX_API_SECRET for CI and agents.
• Rendering — screenshots, PDFs, videos, formats, presets and common flags.
• Saving files & output — where renders are saved, and how results are printed.
• Any option with --json — pass through any API option, and inspect the schema.
• Signed render links — generate HMAC-signed URLs with no API call.
• Async renders & webhooks — queue heavy renders and poll or get a callback.
• Screenshots from a CSV — render a whole list of URLs into a folder.
• Using the CLI from an AI agent — install the agent skill and drive it in plain English.
• Org resources — storage, proxies and LLM credentials, and assigning them to projects.
• Configuration — where the CLI stores your session and how to inspect it.
• Troubleshooting — urlbox doctor and the error-code reference.
• Command reference — every command and what it does.

Prefer the story?

If you want the announcement and the "why" behind making Urlbox agent-accessible, read the blog post first, then come back here for the details.