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

44 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tags
image hosting
image hosting for agents
video 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 and MP4 videos, creating social-ready copies, and running resumable transcript/storyboard enrichment workflows from any agent that reads SKILL.md.

PixelVault is agent-first media hosting for developers and AI coding agents. These skills let an agent upload screenshots, diagrams, mockups, generated images, and MP4 videos and get an instant, globally cached CDN URL 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 video", or any task that produces media needing a shareable link.

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 MP4s, get CDN URLs, make short videos social-ready, or enrich MP4s with transcripts/storyboards
/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, or /pixelvault-upload https://media.example.com/demo.mp4. Ask it to enrich a local MP4 or existing vid_... asset for resumable transcript and storyboard artifacts.

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 streamed, or PixelVault imports a public MP4 URL directly.
  2. It is stored on Cloudflare R2 and served globally through Cloudflare CDN.
  3. You get a permanent URL such as https://img.pixelvault.dev/proj_abc/img_xyz.png or https://img.pixelvault.dev/proj_abc/vid_xyz.mp4.
  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.

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

> 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

> /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