Scenario for Photoshop

Generate, edit, upscale and cut out with Scenario models without leaving Photoshop. Select something, pick an action, see its price on the button, click. The result lands as a layer you can compare, keep or undo in one step.

Remove on a selection, recorded in Photoshop 27.11 (3x speed). MP4.

Not yet on the Adobe Marketplace, and the agent helper is not on npm yet. You install the plugin from the .ccx package of a release.

What it does

• Reads what you are working on. No document, a layer, a cut-out, a selection or a set of takes: the panel offers the actions that fit, at most six at a time, and More for the rest.
• Shows the price first. Every action button carries its price in Scenario credits (CU), checked for free before you click. Nothing is spent until you click, and a price that changes after an upload asks you again.
• Lands results the Photoshop way. Each run is one History state, results are smart object layers masked to your selection, takes come as a group to compare, and every layer keeps its Scenario metadata (model, prompt, settings, price).
• Lets agents work in Photoshop. A local Scenario MCP server, scenario-photoshop, lets Claude Code, Codex, Cursor or Claude Desktop read your document, run generations and land results, with an approval card in the panel before any credit is spent.

Actions in this build
On a selection	Replace inside (Inside selection or Bolder), Remove, Make versions, Cut out subject, Select by description
On a layer or image	Make versions, New layer, Extend canvas, Upscale, Remove background, Add background, Render sketch, New angle, Relight to scene, Split into layers, Remove text, Split text, Formats, Animate
On takes	Compare takes, Keep take, More like this, Refine, Upscale kept take
From your project	Place from Library, Library images as references, trained models and styles

Before and after pictures for each action are in the User Guide.

Install

You need Photoshop 2026 (27.x; tested on 27.11 on macOS) and a Scenario account on a plan with API access (Starter or above).

1. Download the package of the latest release, scenario-photoshop-<version>.ccx, from photoshop.scenario.com/download/latest or the releases page, which also lists its SHA256SUMS and a build attestation (gh attestation verify "$HOME/Downloads/scenario-photoshop-<version>.ccx" -R scenario-labs/photoshop-plugin).

2. Install it with Creative Cloud's plugin installer, then restart Photoshop (the plugin loads at the next launch). Replace <version> with the one in the file name:

   "/Library/Application Support/Adobe/Adobe Desktop Common/RemoteComponents/UPI/UnifiedPluginInstallerAgent/UnifiedPluginInstallerAgent.app/Contents/MacOS/UnifiedPluginInstallerAgent" --install "$HOME/Downloads/scenario-photoshop-<version>.ccx"

   Verified live with the release package on macOS on 2026-10-23, with Photoshop's Developer Mode on (whether the installer needs it was not tested): install, restart, sign-in and a first image took 1 min 53 s. A script did the clicks and typing, so this time has no reading in it, and 59 s of it was the generation. Double-clicking the .ccx should do the same through Creative Cloud; not tested.

3. In Photoshop, open Plugins > Scenario.

To build the package yourself instead (Node.js 20 or later), run npm ci, then npm run package, which prints the file it writes, build/scenario-photoshop-<version>.ccx, and install that file.

First generation

1. In the panel, click Sign in with Scenario. Photoshop may ask before it opens Scenario's sign-in page in your browser; approve there (if the page asks for a code, enter the panel's). If your account can use several projects, choose one.
2. Or use an API key: on app.scenario.com, open your project's API keys and create a Project key with the Editor role, then paste the key and its secret in the panel (pasting key:secret fills both fields) and click Save and test.
3. Open or create a document. On a blank canvas the panel offers Create image, and on an image or a layer New layer. Type what you want and click the blue button. It shows the price, for example Create image · 13 CU for four takes.

The full walkthrough, with every action, is in the User Guide.

Guides

• User Guide: every action with before and after pictures, selection edits, references, styles and trained models, Library, Jobs, prices and approvals, settings, troubleshooting.
• Agents and the Scenario MCP: connect Claude Code, Codex, Cursor or Claude Desktop, and approve what agents do.
• Known limitations: what this build does not do yet, and what was not tested.
• Privacy and Security: what leaves your computer, and how to report a problem.
• Build status: each part of the plugin with how it was checked.
• Changelog.

Build and test

npm ci
npm test          # unit and integration tests (Node's built-in test runner)
npm run lint      # syntax, typography and public-content checks
npm run package   # build/scenario-photoshop-<version>.ccx
npm run handbook  # build/handbook/: the handbook as a web page, one HTML file and a PDF

Contributors and coding agents: AGENTS.md. Design: docs/spec/SPEC.md and the tool reference docs/spec/MCP.md.

License

MIT, see LICENSE. Third-party code: THIRD_PARTY_NOTICES.md.

Adobe and Photoshop are trademarks of Adobe. This project is not affiliated with or endorsed by Adobe.