agent-bridge-for-photoshop

SKILL.md

Agent Bridge for Photoshop Skill

Product summary

Agent Bridge for Photoshop is a local automation stack for Photoshop that provides a stable command surface, operation payload schema, and runtime bridge between CLI workflows and Photoshop UXP APIs. Agents use the psagent CLI to control Photoshop documents, layers, and operations through JSON operation envelopes. The bridge daemon runs on http://127.0.0.1:43120 and brokers calls between the CLI and a UXP plugin inside Photoshop. Key files: .psagent.json (project config), ~/.config/psagent/config.json (user config), operation envelope JSON payloads. Primary CLI: psagent with subcommands for sessions, documents, layers, operations, rendering, checkpoints, and diagnostics. MCP server available via psagent mcp-serve for agent tool integration.

When to use

Reach for this skill when:

  • Automating Photoshop document and layer operations (create, rename, delete, style, export)
  • Building reproducible creative workflows with deterministic operation sequences
  • Managing document state with checkpoints and rollback capabilities
  • Querying document structure (manifest, layers, properties)
  • Exporting renders (PNG/JPG) from Photoshop programmatically
  • Testing operation payloads before production use (dry-run mode)
  • Integrating Photoshop automation into agent-driven workflows via MCP tools
  • Debugging operation failures and validating bridge connectivity
Installs
36
First Seen
Mar 10, 2026