pixelvault

CLI for PixelVault — agent-first image hosting for developers and AI coding agents.

Install

npm install -g pixelvault

Or use directly with npx:

npx pixelvault upload photo.jpg

Quick Start

# Create an account
pixelvault register

# Upload an image — prints the URL to stdout
pixelvault upload screenshot.png
# https://img.pixelvault.dev/proj_abc/img_xyz.png

# Upload multiple images
pixelvault upload *.png --folder screenshots

# List your images
pixelvault list

# Delete an image
pixelvault delete img_xyz

Agent Integration

The CLI is designed for AI coding agents. Output contract:

• upload prints only the URL to stdout
• list outputs one URL per line
• delete outputs nothing on success
• All human messages go to stderr
• --json flag for structured output

# In agent workflows
URL=$(npx pixelvault upload screenshot.png)
echo "Uploaded to: $URL"

Environment Variables

For CI/CD and headless agent usage:

export PIXELVAULT_API_KEY=pv_live_xxx
npx pixelvault upload build-output.png

Commands

| Command | Description | |---------|-------------| | register | Create a new account | | login | Log in to existing account | | upload <files...> | Upload images (prints URLs to stdout) | | list | List uploaded images | | delete <id> | Delete an image | | whoami | Show current auth state | | config get\|set\|show | Manage CLI configuration |

Upload Options

pixelvault upload photo.jpg              # Single file
pixelvault upload *.png --folder icons   # Bulk with folder
pixelvault upload shot.png --json        # Full JSON response

List Options

pixelvault list                          # One URL per line
pixelvault list --json                   # Full JSON with metadata
pixelvault list --page 2 --per-page 50   # Pagination

Configuration

Config is stored at ~/.pixelvault/config.json (0600 permissions).

pixelvault config show                   # Show all config
pixelvault config set api_url http://localhost:8787  # Dev override
pixelvault config get api_key            # Get a value

PIXELVAULT_API_KEY env var always takes precedence over the config file.

Requirements

• Node.js 20+

License

MIT