onboard

name	onboard
description	First-run setup for the GIMP plugin. Detects how GIMP is installed on the user's Linux machine (native package, Flatpak, Snap, AppImage), captures version and CLI binary path, and persists a profile to $CLAUDE_USER_DATA so the other skills can shell out without re-detecting. Use the first time the plugin is invoked, after a GIMP upgrade, or whenever skills report a stale path.

Onboard

Detect the local GIMP installation and write a profile.

Steps

1. Resolve the data root:

   DATA_ROOT="${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/gimp"
   mkdir -p "$DATA_ROOT"
   

2. Probe for GIMP in this order, recording the first hit. Capture both binary path and version (<bin> --version):
   • Native (apt/dnf/pacman): command -v gimp, command -v gimp-2.10, command -v gimp-console, command -v gimp-console-2.10. GIMP 3 ships gimp-console-3.0.
   • Flatpak: flatpak info org.gimp.GIMP — if installed, the run command is flatpak run org.gimp.GIMP and headless is flatpak run --command=gimp-console org.gimp.GIMP.
   • Snap: snap list gimp — run command is snap run gimp.
   • AppImage: ask the user for the AppImage path if none of the above hit.
3. Detect the user config directory: ~/.config/GIMP/<MAJOR.MINOR>/ (e.g. 2.10, 3.0). This is where Script-Fu scripts and plug-ins live.
4. Write $DATA_ROOT/config.json:

   {
     "install_type": "native|flatpak|snap|appimage",
     "gimp_bin": "/usr/bin/gimp",
     "gimp_console_bin": "/usr/bin/gimp-console-2.10",
     "version": "2.10.34",
     "config_dir": "/home/<user>/.config/GIMP/2.10",
     "scripts_dir": "/home/<user>/.config/GIMP/2.10/scripts",
     "plug_ins_dir": "/home/<user>/.config/GIMP/2.10/plug-ins",
     "detected_at": "<ISO timestamp>"
   }
   

5. Print a one-line summary: install type, version, console binary.

Notes

• Prefer gimp-console over gimp -i -b when available — same behavior, no display dependency.
• If both GIMP 2 and GIMP 3 are installed, prompt the user to pick which to profile.
• Never write under ~/.claude/plugins/gimp/ — that's the install dir and gets clobbered on update.