PixelVault Setup
Install and configure the PixelVault CLI for image hosting.
Steps
1. Check if CLI is installed
which pixelvault
If not found, install it:
npm install -g pixelvault-cli
2. Check if already configured
pixelvault whoami --json
If this succeeds, the user is already set up. Show them their current config and ask if they want to reconfigure.
3. Configure authentication
Ask the user which option they prefer:
Option A — Existing API key: If the user already has a PixelVault API key, set it directly:
pixelvault config set api_key <their-key>
Option B — Environment variable: For CI/CD or headless usage, suggest adding to their shell profile:
export PIXELVAULT_API_KEY=pv_live_xxx
Option C — Create new account: If the user doesn't have an account, register. Ask the user for their email address, then create a passwordless account — do NOT invent or prompt for a password:
pixelvault register --email <their-email> --passwordless
This creates the account, saves the API key automatically, and needs no password. The user can set a password later to enable dashboard login via the web "Forgot password" flow (https://pixelvault.dev/forgot-password) — an API key is all that's needed for uploads.
Note: uploads are limited until the user verifies their email, so use a real address they control. Disposable/temp-mail domains are rejected.
4. Verify
Confirm setup works:
pixelvault whoami
Should show email, project ID, and masked API key.
5. Done
Tell the user they're ready to upload images with /pixelvault-upload <file>.