screenshot

screenshot

Capture screenshots of web pages using headless Chromium.

Usage

Use uv run --project ${CLAUDE_PLUGIN_ROOT} to run the tool. This resolves the package from the plugin directory while keeping your current working directory, so screenshots are saved in your project.

uv run --project ${CLAUDE_PLUGIN_ROOT} screenshot <url>

Basic screenshot

uv run --project ${CLAUDE_PLUGIN_ROOT} screenshot https://example.com

With options

uv run --project ${CLAUDE_PLUGIN_ROOT} screenshot https://example.com --preset mobile --full-page --dark

Authenticated pages

# First: save a session (opens browser for manual login)
uv run --project ${CLAUDE_PLUGIN_ROOT} screenshot login mysite https://example.com/login

# Then: use the session
uv run --project ${CLAUDE_PLUGIN_ROOT} screenshot https://example.com/dashboard --session mysite

Available viewports

desktop (1280x720), laptop (1440x900), tablet (768x1024), tablet-landscape (1024x768), mobile (375x667), mobile-large (414x896).

uv run --project ${CLAUDE_PLUGIN_ROOT} screenshot presets

Output

Screenshots are saved to .screenshots/ in the current working directory with auto-generated filenames. Use -o path.png for an explicit output path. The tool prints the absolute path of the saved file to stdout.

Other features

• --dump-html — save rendered HTML alongside the PNG
• --dark — capture in dark color scheme
• --click SELECTOR — click an element before capture
• --full-page — capture the entire scrollable page

Notes

• Chromium is auto-installed on first run.
• ${CLAUDE_PLUGIN_ROOT} is set by Claude Code and points to the plugin's install directory.