PixelVault Upload

Upload image files to PixelVault and return CDN URLs.

Prerequisites

The pixelvault CLI must be installed and configured. If the command is not found, install it:

npm install -g pixelvault-cli

If no API key is configured, tell the user to run /pixelvault-setup first or set PIXELVAULT_API_KEY in their environment.

Steps

1. Check CLI availability — Run which pixelvault to confirm the CLI is installed.

2. Check auth — Run pixelvault whoami --json to verify an API key is configured. If it fails, stop and tell the user to run /pixelvault-setup or set PIXELVAULT_API_KEY.

3. Upload — Run the upload command:

# Single file
pixelvault upload $ARGUMENTS

# With folder
pixelvault upload <file> --folder <folder>

# Multiple files (shell glob)
pixelvault upload *.png --folder screenshots

4. Report — The CLI prints one CDN URL per line to stdout. Report these URLs back to the user. Each URL is permanent and globally cached.

Output Contract

• The CLI prints only URLs to stdout (one per line)
• Human-readable messages go to stderr
• Use --json if you need metadata (id, mime_type, size, filename)

Error Handling

Examples

# Upload a screenshot, get the URL
pixelvault upload screenshot.png
# → https://img.pixelvault.dev/proj_abc/img_xyz.png

# Upload with JSON metadata
pixelvault upload diagram.svg --json
# → { "id": "img_xyz", "url": "https://...", "size": 12400, ... }

# Bulk upload
pixelvault upload ./assets/*.png --folder assets