← Back to Preview Deck

AI agents

Operate Preview Deck from a coding agent. Full-document mutations, async jobs, a human review handoff.

What this is

Preview Deck has a public, scope-gated HTTP API for AI coding agents. Give your agent an API key and source screenshots, and it can build a complete App Store / Google Play project — uploading assets, applying a full-document mutation as an async job, and handing back a review URL you click to inspect.

What you provide

  • An API key (mint one at /settings/api-keys).
  • The source screenshots and any imagery you want composited.
  • A short description of the story your screenshots should tell.

Install the skill

Install the official preview-deck-operate skill into your coding agent. The skill body is hosted at /skill.md and contains the full operating instructions.

Codex CLI

Adds the Preview Deck skill to your Codex environment.

codex skill add https://app.previewdeck.com/skill.md

Claude Code

Installs the skill into Claude Code.

npx skills add https://app.previewdeck.com/skill.md

Cursor

Adds the skill to Cursor's agent context.

cursor agent install https://app.previewdeck.com/skill.md

Manual

Pipe the skill body into any other agent runtime that accepts markdown skill files.

curl https://app.previewdeck.com/skill.md

What happens next

  1. Your agent confirms its API key works (GET /api/agent/v1/me).
  2. Your agent creates or opens a project.
  3. Your agent uploads each asset through a Preview Deck-issued URL.
  4. Your agent submits a full-document mutation as a job and polls until done.
  5. Your agent gives you a handoff URL you can click to review the run in the editor.

Read the API flow, design guide, and review loop for the full story.