Media & Screenshots

Use the CLI to upload site assets, list what is in the media library, inspect individual files, and capture screenshots while you work locally.

Upload Media

Upload images, documents, audio, and small video files to the active site's media library. Images are optimized for web delivery when possible.

# Upload an image
redo upload ./hero-image.jpg

# Upload into a folder
redo upload ./team-photo.png --folder about

# Add useful alt text at upload time
redo upload ./bakery-counter.jpg --alt "Owner standing behind the bakery counter"

After upload, the CLI prints the media ID and URLs you can use in pulled files.

Uploading hero-image.jpg...
✓ Optimized: 2.4MB -> 340KB
✓ Uploaded media 184
URL: https://redopage.com/files/site_abc/hero-image.webp
Template: {{media 184}}

List Media

List media when you need IDs for templates, block HTML, or agent work. Use --limit and --offset for pages of results, or --all when you intentionally want the whole library.

# First page
redo list media --limit 50

# Next page
redo list media --limit 50 --offset 50

# Everything
redo list media --all

Read A Media Record

Read one item when you need its public URL, template URL, MIME type, size, or metadata.

redo read media 184

Use the template form inside page or block source so Redo can resolve the current media URL.

<img src="{{media 184}}" alt="Owner standing behind the bakery counter" />

Screenshots

Capture draft pages while you iterate, or capture external URLs for reference.

# Screenshot the home page
redo screenshot --page /

# Screenshot a specific page
redo screenshot --page /about

# Mobile viewport
redo screenshot --page / --mobile

# Full page scroll capture
redo screenshot --page /pricing --full

# External reference
redo screenshot https://example.com --mobile --full

Screenshot Options

Option	Description
--page <path>	Capture a draft page on your active site.
--mobile	Use a narrow mobile viewport.
--full	Capture the full scrollable page.
--output <path>	Write to a specific file path.

Fetch Web Content

Convert a URL to clean markdown, or download a file directly.

# Convert a page to markdown
redo fetch https://example.com/blog/post

# Save markdown to a file
redo fetch https://example.com/about --output about.md

# Download a file instead of converting it
redo fetch https://example.com/brochure.pdf --download

Extract Design Assets

Extract colors, fonts, screenshots, and images from a reference site.

# Full extraction
redo extract https://example.com

# Extract only colors
redo extract https://example.com --colors-only

# Extract only images
redo extract https://example.com --images-only

Next: AI Context →