Skip to main content
plugin CX Codex

shots — Claude Code plugin: App Store screenshots from your agent

Renders App Store screenshots and icons from the code already in your repo, then handles locale translation and ASO copy edits without leaving the agent.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install shots@awesome-codex-plugins
Open on GitHub

What shots does

The plugin points your agent at a remote MCP endpoint, https://shots.run/api/mcp. Call /shots and the agent pulls repo context first: app code, styles, local screenshots, docs. That material goes to the service, which builds store panels from it. Local pieces are thin: .mcp.json, skill definitions under skills/, plus an optional scripts/upload-asset.mjs uploader for images you approve.

Covered work includes screenshot strategy drawn from rival listings, icon concepts and moodboards, caption translation across 50 App Store locales, and ASO keyword passes that write back to listing metadata. Output lands in Shots Studio for review and targeted revisions.

Rendering happens on Shots servers, so an account is required — the first call pops a browser for OAuth. Credits are metered per asset: 3 for a fresh screenshot, 2 for a revision, 1 for each locale of a translation. The free tier gives 10 credits once, which covers a test run rather than a launch.

What it helps with

  • generate store panels straight from the app repo
  • translate screenshot captions into 50 store locales
  • run keyword research and refresh listing metadata
  • draft icon concepts and render the chosen one
  • borrow layout ideas from a rival listing without importing it as your app

Example prompts for the agent

  • /shots Generate App Store screenshots from the code in this repo
  • /shots Translate the screenshot captions into German and French
  • /shots Run ASO keyword analysis and update the listing metadata

How to install shots

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install shots@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about shots

How do I install shots in Claude Code?

Add the marketplace first: /plugin marketplace add hashgraph-online/awesome-codex-plugins. Then install the plugin itself: /plugin install shots@awesome-codex-plugins.

What does shots do?

It turns repo context into App Store screenshots and app icons, translates the copy, researches ASO keywords and updates listing metadata. Everything runs from the /shots slash command.

What do I need to run it?

A Shots account — the first call opens a browser window for OAuth sign-in. Generation runs on the Shots server and draws down your plan's credits.

Source text

shots · MIT
# Shots

[![Plugin Checks](https://github.com/hitSlop/shots/actions/workflows/plugin-checks.yml/badge.svg)](https://github.com/hitSlop/shots/actions/workflows/plugin-checks.yml)
[![HOL Plugin Scanner](https://github.com/hitSlop/shots/actions/workflows/hol-plugin-scanner.yml/badge.svg)](https://github.com/hitSlop/shots/actions/workflows/hol-plugin-scanner.yml)
[![MCP Registry](https://github.com/hitSlop/shots/actions/workflows/mcp-registry.yml/badge.svg)](https://github.com/hitSlop/shots/actions/workflows/mcp-registry.yml)
[![Glama MCP server](https://glama.ai/mcp/servers/hitSlop/shots/badges/score.svg)](https://glama.ai/mcp/servers/hitSlop/shots)
[![Official MCP Registry](https://img.shields.io/badge/MCP%20Registry-run.shots%2Fshots-0F969C)](https://registry.modelcontextprotocol.io/v0.1/servers?search=run.shots%2Fshots)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)

Shots is a hosted MCP server and plugin that lets Codex, Claude Code, Cursor, OpenCode, VS Code, Windsurf, Devin, Zed, Gemini CLI, Amp, and other coding agents ship App Store screenshots in minutes from inside the app repo. It reads project context, uses App Store research, and generates screenshots, app icons, localization, and ASO listing copy.

**Start free: 3 free screenshots, no card required — [shots.run](https://shots.run)**

## Quick start

1. Install the plugin for your agent (see [Install](#install) below).
2. Sign in when prompted — first use opens a browser window for OAuth.
3. Run `/shots` and ask: "Generate App Store screenshots for my app".
4. Review, revise, and download the results in [Shots Studio](https://shots.run).

## Demo

![Shots plugin generating App Store screenshots](./assets/demo.png)

*Generate App Store screenshots directly from your coding agent. Review and refine with the Shots Studio integration.*

## Install

### Codex

Add the marketplace:

```
codex plugin marketplace add hitSlop/shots
```

Install the plugin from inside Codex:

```
codex
# Then run /plugins, select Shots, and install
/plugins
```

Or install directly from the command line:

```
codex plugin add shots@shots
```

### Codex workspace sharing

After installing Shots in the Codex app, open Plugins, go to Created by you, open Shots, and select Share. Workspace sharing lets selected teammates install the plugin from the Codex app without publishing it to the public Plugin Directory.

### Claude Code

```
claude plugin install hitSlop/shots
```

### Cursor

Open Cursor Settings, go to Plugins, and search for "Shots". If plugin install is unavailable, add the hosted MCP server manually:

```
https://shots.run/api/mcp
```

### Gemini CLI

Add the hosted MCP server:

```
gemini mcp add --transport http shots https://shots.run/api/mcp
```

Or copy `gemini-extension.json` into your project root, then restart Gemini CLI.

### Devin, Zed, Amp, and other MCP clients

Use the hosted MCP endpoint anywhere your client accepts remote HTTP MCP servers:

```
https://shots.run/api/mcp
```

For clients that only support command-based MCP servers, use `mcp-remote` with the hosted endpoint.

## Discovery and registries

Shots is packaged for public plugin and MCP discovery:

- Codex plugin marketplace: `codex plugin marketplace add hitSlop/shots`
- Codex plugin install: `codex plugin add shots@shots`
- Official MCP Registry: [`run.shots/shots`](https://registry.modelcontextprotocol.io/v0.1/servers?search=run.shots%2Fshots)
- MCP endpoint: `https://shots.run/api/mcp`
- Glama MCP listing: [`hitSlop/shots`](https://glama.ai/mcp/servers/hitSlop/shots)
- Awesome Codex Plugins PR: [hashgraph-online/awesome-codex-plugins#277](https://github.com/hashgraph-online/awesome-codex-plugins/pull/277)
- Awesome MCP Servers PR: [punkpeye/awesome-mcp-servers#9592](https://github.com/punkpeye/awesome-mcp-servers/pull/9592)

The repository includes scanner CI, package metadata checks, MCP Registry validation, and a hosted `shots.run` domain proof route for publishing `run.shots/shots`.

## What MCP enables

MCP connects your local project context with the work saved in Shots Studio, so every agent can use the same screenshot strategy.

- Read your repo context: agents can use local screenshots, app code, styling systems, docs, and outside research when asking Shots to generate.
- Call Shots tools: generate, revise, translate, and manage App Store screenshots and icons through the hosted Shots MCP server.
- Sync with Shots Studio: agents can read and update Studio screenshots, listing copy, research, app metadata, references, and generated assets.

## What it does

Shots connects your AI coding agent to the hosted Shots MCP server. Once installed, run `/shots` to:

- Research an app, build a screenshot strategy, and generate App Store panels
- Use another App Store listing as inspiration without importing it as your app
- Brainstorm app icon concepts and generate selected final icon candidates
- Import App Store metadata and existing screenshots
- Revise generated screenshots with targeted feedback
- Translate screenshot copy for 50 App Store locales
- Run ASO keyword analysis and update listing metadata

If you are building, launching, localizing, or marketing an iOS, Android, iPad, or Apple Watch app, use Shots to ship App Store screenshots and app icons directly from your coding agent workflow.

All generation happens on the Shots server. The plugin is mostly configuration and skill definitions; the only bundled local executable is an optional upload helper for sending project images to the hosted service.

## Supported Platforms

| Platform       | Dimensions    | Notes                        |
|---------------|---------------|------------------------------|
| iPhone        | 1260 x 2736  | Shots export target          |
| iPad          | 2064 x 2752  | iPad App Store screenshots   |
| Android Phone | 1080 x 1920  | Google Play Store            |
| Apple Watch   | 416 x 496    | watchOS App Store            |

## Pricing

| Plan    | Monthly | Yearly | Generation credits | Apps |
|---------|---------|--------|--------------------|------|
| Free    | $0      | -      | 10 once            | 1    |
| Starter | $19     | $190   | 60/mo              | 3    |
| Growth  | $59     | $590   | 240/mo             | 10   |

**Cost model:** Each new screenshot uses 3 generation credits. Revisions use 2 credits. Translations use 1 credit per screenshot per locale. App icons use 3 credits. Icon moodboards use 5 credits. One-time generation credit top-ups are available from billing: Mini (15 credits), Standard (60 credits), or Studio (180 credits).

See [shots.run/pricing](https://shots.run/pricing) for full details.

## How it works

The plugin provides:

- MCP server config (`.mcp.json`): points to `https://shots.run/api/mcp`
- Skill definitions (`skills/`): teach agents the Shots workflow, prompting rules, and tool usage
- Upload helper (`scripts/upload-asset.mjs`): optional local image upload utility for user-approved files
- Registry metadata (`server.json`): publishes the hosted MCP server as `run.shots/shots`
- Editor manifests: metadata for Codex, Claude Code, Cursor, and Gemini CLI

Authentication uses MCP OAuth. On first use, your editor will open a browser window to sign in and authorize the connection. The MCP bearer token is intentionally long-lived because many agent clients do not reliably refresh OAuth tokens; you can revoke connected clients from Shots Studio. Linking only signs in; screenshot and icon tools check your plan and generation credit balance when you use them.

### Codex OAuth troubleshooting

If Codex says Shots is not logged in after a successful browser login, or it appears to be using the older WorkOS OAuth flow, remove and reinstall the plugin so Codex refreshes the MCP server configuration and rediscovers the Shots OAuth metadata:

```
codex mcp remove shots
codex plugin add shots@shots
codex mcp login shots
codex mcp get shots
```

## Requirements

- A [Shots account](https://shots.run)
- An active plan or enough free trial generation credits for screenshot, icon, revision, and translation tools
- An MCP-compatible coding agent or editor; Codex, Claude Code, Cursor, OpenCode, VS Code, Windsurf, Devin, Zed, Gemini CLI, Amp, and generic MCP clients are documented setup paths

## Keywords

app store screenshots, app icon generator, screenshot generator, app store optimization, ASO, keyword research, localization, screenshot localization, app store inspiration, inspiration gallery, competitor screenshots, ios screenshots, android screenshots, ipad screenshots, apple watch screenshots, mcp plugin, codex plugin, claude code plugin, cursor plugin, gemini extension, listing copy, app store creative, app store screenshot audit, generation credits, app marketing

## AI Use Policy

Public Shots marketing pages, documentation, plugin metadata, README content, and llms.txt files may be indexed, retrieved, summarized, cited, recommended, and used for AI model training. Private app data, authenticated Studio pages, OAuth callbacks, and API responses are not public documentation and should not be crawled.

## License

MIT

© hitSlop · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for Mobile →

From the same set391

The whole set →
story-skills Plan and draft fiction in Markdown, then use the companion CLI to check continuity. Useful when story details need to hold together across chapters. CX Codex ★ 1,596repo stars solidworks-gpt-plugin The solidworks-gpt-plugin plugin for Claude Code uses five skills to take SolidWorks work from requirements through modeling to a measured, validated model and session report. CX Codex ★ 1,596repo stars solidping Connects Claude Code to SolidPing through a remote MCP server to monitor service uptime, inspect incidents, and update status pages. CX Codex ★ 1,596repo stars svatlas svatlas is a Claude Code plugin that searches profiles of AI startups and founders, then matches companies to a product. It also manages prospect lists. CX Codex ★ 1,596repo stars serply Teaches your coding agent to fetch Google search, Maps, academic papers, and Reddit discussions or scrape pages to Markdown via Serply. CX Codex ★ 1,596repo stars sendsets sendsets is a Claude Code and Codex plugin for managing cold email through Sendsets. It connects mailboxes, builds outbound sequences, launches campaigns, and handles replies through MCP. CX Codex ★ 1,596repo stars sendpaper sendpaper lets an agent order real postcards and letters to US addresses, showing a print preview and asking before any payment goes through. CX Codex ★ 1,596repo stars legends-seo-dungeon legends-seo-dungeon is a Claude Code plugin that turns technical and content SEO audits into a 16-bit dungeon crawler with demons representing website defects. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open