Skip to content
pixelvault-devPublic

About

Agent skill for image hosting — upload images and get CDN URLs from Claude Code, Codex, Cursor, or any AI agent.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

48 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tags
image hosting
image hosting for agents
video hosting
audio hosting
CDN
screenshots
image management
diagrams
tools
PixelVault
PixelVault CLI
PixelVault MCP
Claude Code
Codex
Cursor
Cloudflare R2
Cloudflare CDN
companies
Cloudflare
dependencies
Node.js

PixelVault — Media Hosting for AI Agents

Agent skills for hosting images, MP4 videos, and MP3/WAV/M4A/OGG audio, creating social-ready video copies, running resumable video transcript/storyboard enrichment, and transcribing audio to text/WebVTT/timestamped JSON.

PixelVault is agent-first media hosting for developers and AI coding agents. These skills let an agent upload screenshots, diagrams, mockups, generated images, MP4 videos, and audio; get instant globally cached original URLs, plus optional transcript artifacts, without a manual dashboard.

When it triggers: "screenshot this and host it", "upload this image and give me the URL", "host this MP4", "give me a URL for this audio", "transcribe this podcast", "make captions for this audio", or any task needing hosted media.

Why PixelVault for agents

  • Just an API key — no crypto wallet, no per-upload payment. A permanent free tier, not a trial.
  • Permanent, global URLs — served from Cloudflare's edge CDN with zero egress fees.
  • Built for discovery — ships a Claude Code skill, a remote MCP server, llms.txt, and an OpenAPI 3.1 spec so any agent can find and call it.
  • Works with any agent — Claude Code, Codex, Cursor, Gemini CLI, or paste SKILL.md into custom instructions.

Skills

Skill Description
/pixelvault-upload <file-or-url> Upload images or video, or host/transcribe MP3/WAV/M4A/OGG audio; get public/signed CDN URLs; manage lifecycle; or run video optimization/enrichment
/pixelvault-host-image Zero-install: host a file or URL with one curl, no signup (keyless, 30-day links; add a key for permanent). Published on ClawHub for OpenClaw
/pixelvault-setup Install CLI and configure API key
/pixelvault-list List recently uploaded images, search them by AI description or tag, and describe an already-uploaded image (alt text, OCR, tags; needs pixelvault-cli 0.13.0+ for tags/describe)
/pixelvault-optimize Compress and resize local images (no account needed): pixelvault optimize
/pixelvault-transform Resize, convert, remove backgrounds, add effects or a watermark — via URL params
/pixelvault-ecommerce-catalog <folder or URLs> Turn product photos into catalog variants (marketplace white squares, listing/PDP sizes, thumbnails, cut-outs, watermarks) and verify each one before reporting URLs
/pixelvault-generate <prompt> Generate an image from a prompt and host it. Built-in by default (pixelvault generate, only your PixelVault key, monthly credits); OpenRouter for other models
/pixelvault-email-images Host the local images in an email template (Resend, react-email) and rewrite them to permanent CDN URLs
/pixelvault-desktop Get a local screenshot/clipboard image into a remote/cloud agent as a URL (via the PixelVault desktop app)
/pixelvault-account Check quota/usage before bulk uploads; list, create, rotate, and revoke API keys; start a plan upgrade or open the billing portal (needs pixelvault-cli 0.6.0+, 0.7.0+ for upgrade/billing)

Quick Start

npx skills add pixelvault-dev/skill

Then, inside your agent:

  1. Run /pixelvault-setup to configure your API key
  2. Upload media with /pixelvault-upload screenshot.png, /pixelvault-upload demo.mp4, /pixelvault-upload episode.ogg, or a public media URL. Ask it to manage or transcribe an aud_... asset, or enrich a local MP4/existing vid_... asset.

Use it from any agent

  • skills.sh (any agent) — npx skills add pixelvault-dev/skill installs the skill folders for Claude Code, Codex, Cursor, and more.
  • Claude Code plugin — install from the marketplace, or copy the folders in skills/ into .claude/skills/ (project) or ~/.claude/skills/ (user).
  • OpenClaw — openclaw skills install pixelvault-host-image (from ClawHub). Needs only curl. Guide: https://pixelvault.dev/integrations/openclaw
  • Remote MCP server — point any MCP-capable agent at https://mcp.pixelvault.dev/mcp (bearer auth with your API key). No local install required.
  • Any other agent — paste a SKILL.md from skills/ into your custom instructions, or hand the agent the OpenAPI spec below.

How It Works

The skill wraps the PixelVault CLI. When you or an agent uploads media:

  1. A local file is read by the CLI, or PixelVault securely imports a public media URL.
  2. It is stored on Cloudflare R2 and served globally through Cloudflare CDN.
  3. You get a URL such as https://img.pixelvault.dev/proj_abc/img_xyz.png, https://img.pixelvault.dev/proj_abc/vid_xyz.mp4, or https://img.pixelvault.dev/proj_abc/aud_xyz.ogg.
  4. For social publishing, the agent can create a separate H.264/AAC fast-start copy without changing the original (up to 100 MB and 60 seconds).
  5. For transcript/storyboard enrichment, the agent exposes the asset and job IDs immediately, waits with a bounded timeout, and can resume later without another upload.

Requirements

  • Node.js 20+
  • A PixelVault account. Free tier: 200 MB storage, 500 uploads/month, 1 GB bandwidth, 5 MB per image, and 25 MB per MP4 video. No credit card or trial expiry.
  • Audio originals have an approved global maximum of 25,000,000 bytes. This is a byte ceiling, not a plan allowance or reserved capacity.
  • Audio enrichment accepts up to 10 minutes and shares the existing media-enrichment allowance with video.

Examples

> /pixelvault-upload screenshot.png
Uploaded: https://img.pixelvault.dev/proj_abc/img_xyz.png

> /pixelvault-upload *.png --folder diagrams
Uploaded: https://img.pixelvault.dev/proj_abc/img_001.png
Uploaded: https://img.pixelvault.dev/proj_abc/img_002.png

> /pixelvault-upload demo.mp4
Uploaded: https://img.pixelvault.dev/proj_abc/vid_xyz.mp4

> /pixelvault-upload https://media.example.com/demo.mp4
Uploaded: https://img.pixelvault.dev/proj_abc/vid_xyz.mp4

> /pixelvault-upload episode.ogg
Uploaded: https://img.pixelvault.dev/proj_abc/aud_xyz.ogg

> Make that uploaded video social-ready
Optimized: https://img.pixelvault.dev/proj_abc/vid_xyz.social.mp4

> Enrich that video and return its transcript and storyboard; don't wait forever
Enrichment queued: asset vid_xyz, job ven_xyz
Completed: original MP4 + text/VTT/JSON transcript + storyboard index/sheets

> Transcribe that podcast; return captions and save IDs so I can resume
Enrichment queued: asset aud_xyz, job aen_xyz
Completed: original audio + text/VTT/timestamped JSON transcript

> /pixelvault-list --json
[{ "id": "img_xyz", "url": "https://...", "size": 45200, ... }]

Agent discovery

PixelVault is designed to be found and used by agents without a human in the loop:

Links

License

MIT

About

Agent skill for image hosting — upload images and get CDN URLs from Claude Code, Codex, Cursor, or any AI agent.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors