Skip to main content

​
Add the skill (Codex / Claude Code)

npx skills add https://ps-agent-bridge.jaredverdi.com
This uses the hosted skill.md for PS Agent Bridge.

​
Users

Use this path if you want to use PS Agent Bridge without cloning the repository.

​
Prerequisites

  • Node.js 20+ and npm
  • Adobe Photoshop 24+
  • Creative Cloud Desktop app

​
Install CLI from npm

npm install -g @jverdi/ps-agent-bridge

​
Start bridge daemon

psagent bridge daemon

​
Install Photoshop plugin from Creative Cloud

  1. Open Creative Cloud Desktop.
  2. Navigate to Stock & Marketplace > Plugins.
  3. Search for PS Agent Bridge.
  4. Install the plugin.
  5. Open Photoshop, then open the PS Agent Bridge panel.
  6. Bridge should auto-connect; if not, click Connect Bridge.

​
Run first commands

psagent session start
psagent bridge status
psagent layer list
psagent doctor

​
Contributing

Use this path if you are developing PS Agent Bridge itself.

​
Prerequisites

  • Node.js 20+ and npm
  • Adobe Photoshop 24+
  • UXP Developer Tool

​
Install and build from repository

git clone https://github.com/jverdi/ps-agent-bridge.git
cd ps-agent-bridge
npm install
npm run build

​
Start bridge daemon (repo dev mode)

npm run dev -- bridge daemon

​
Load local UXP plugin in Photoshop

  1. Open UXP Developer Tool.
  2. Add the photoshop-uxp-bridge/ folder as a plugin.
  3. Load the plugin.
  4. In Photoshop, open the PS Agent Bridge panel.
  5. Click Connect Bridge.

​
Run contributor commands

npm run dev -- session start
npm run dev -- doc open ./examples/tests/input.psd
npm run dev -- layer list
npm run dev -- op apply -f examples/ops.cleanup.sample.json --checkpoint
npm run dev -- render --format png --out ./out/mock.png
npm run dev -- doctor
Next: local environment.