Local Art Sync — Data skill for Claude Code

Local Art Sync

Drop art into a folder on your PC (for example where ChatGPT saves generated images) and it appears in your Foundry world: on The Forge in your assets library, on a local Foundry in the Data folder. A GM window in the game lists the uploaded files with copy-URL and drag support, and the URLs are written to `manifest.json` next to the files so Claude Code, Codex/ChatGPT and macros can use them for skills, items, features and tokens.

Two parts:

Part	What it does
watcher/watch.mjs	Node script that runs on your PC, watches the folder and uploads every new or changed image/audio file. Zero dependencies.
The Foundry module	GM-only Art Inbox window (Settings sidebar button or Configure Settings > Art Inbox) that browses the inbox folder in the assets library: thumbnails, filter, copy URL, open, set as token image, drag a card into any image-path field. Also an API for scripts.

Why not a browser-only module? The GM plays in Firefox, which has no folder-access API, and The Forge only accepts uploads through its API. A small local script is the reliable way.

Setup (The Forge)

1. On forge-vtt.com: My Account > API Manager, create an API key with assets library access. Keep it secret.
2. Install this module in the world (manifest URL below) and enable it. Set the inbox path in its settings if you don't want art/inbox.
3. Start the watcher, replacing the folder with the one ChatGPT or you save images into:

$env:FORGE_API_KEY = "paste-your-key"
node "C:\Users\alexg\Documents\Foundry\Pillars of palor\local-art-sync\watcher\watch.mjs" --folder "C:\Users\alexg\Pictures\Foundry Art" --dest art/inbox

Leave that window open while you work. Every new file is uploaded within a few seconds and its URL printed. Add `--once` for a single pass, `--list` to print the manifest.

Setup (local Foundry)

No API key. Point the watcher at the Foundry Data folder instead of Forge:

node ".\watcher\