herdr-paste-image

A Herdr plugin with two clipboard helpers for AI agent panes:

1. Paste image — gives every AI agent in Herdr the image-paste experience of Claude Code. Press a key → the plugin grabs the image from your clipboard, saves it as a PNG file, and types its absolute path into the focused agent pane (Codex, Gemini CLI). In Claude Code panes the path gets an [Image #N] prefix — the format of Claude Code's own image paste — because Claude Code ignores a bare path as plain text. The agent reads the file and sees the actual image — the same result as Claude Code's native clipboard paste, which other agent CLIs don't have. If the clipboard contains text instead of an image, the plugin pastes the text, so binding it to a direct key does not break normal pasting.

2. Dedent clipboard — TUI agents (Codex, …) render output with a left margin, so mouse-copied text carries extra leading spaces on every line. The dedent action strips the shared leading whitespace from all clipboard lines while preserving relative indentation (nested lists, code).

How it works

1. Reads an image from the clipboard:
   • WSL (Windows clipboard) via powershell.exe
   • Linux via wl-paste (Wayland) or xclip (X11)
2. Saves it as paste-YYYYMMDD-HHMMSS.png into a configurable directory (default: ~/.local/state/herdr-paste-images/)
3. Types the absolute path into the focused pane with herdr pane send-text
4. Shows a Herdr notification with the saved path

Requirements

• Herdr 0.7.4+
• WSL with powershell.exe on PATH, or Linux with wl-paste / xclip
• jq and base64

Install

From GitHub (after publishing):

herdr plugin install <owner>/herdr-paste-image

Local development:

git clone https://github.com/<owner>/herdr-paste-image
herdr plugin link /path/to/herdr-paste-image

Keybindings

Add to ~/.config/herdr/config.toml:

[[keys.command]]
key = "f9"
type = "shell"
command = "/home/qo0d/.local/bin/herdr plugin action invoke paste-image.dedent"
description = "strip shared indent from clipboard text"

[[keys.command]]
key = "f8"
type = "shell"
command = "/home/qo0d/.local/bin/herdr plugin action invoke paste-image.paste"
description = "paste clipboard image as path"

Reload the config with prefix+shift+r (or restart Herdr) after editing. Use the absolute path of your herdr binary in command.

Version notes (tested on Herdr 0.7.4 / WSL2 / Windows Terminal):

• type = "plugin_action" with command = "paste-image.paste" is the documented form, but it did not fire on 0.7.4 — use type = "shell" as above. On newer Herdr versions, try plugin_action first.
• Direct ctrl+v never reaches Herdr: Windows Terminal intercepts it as text paste. alt+v arrives as ESC+v and 0.7.4 does not reassemble it into a chord. Function keys (e.g. f8) and prefix bindings are reliable.
• Claude Code has native clipboard image paste of its own (Alt+V on Windows/WSL); other agents (Codex, …) do not — that is exactly the gap this plugin fills.

Configuration: where images are stored

Find the plugin config directory:

herdr plugin config-dir paste-image

Create a config.env file there:

image_dir=~/pictures/agent-pastes     # absolute path, ~ is expanded

Priority: HERDR_PASTE_IMAGE_DIR env var → image_dir in config.env → default ~/.local/state/herdr-paste-images/.

Test without the hotkey

# put an image in your clipboard (e.g. Win+Shift+S on Windows),
# then:
herdr plugin action invoke paste-image.paste
# copy text with extra indentation, then:
herdr plugin action invoke paste-image.dedent

A notification should appear and the path should be typed into the focused pane. Plugin logs: herdr plugin log list --plugin paste-image.

Publishing your own plugins

Herdr's marketplace indexes public GitHub repositories tagged herdr-plugin that contain a valid herdr-plugin.toml. Push this repo, add the topic herdr-plugin, and anyone can install it with herdr plugin install <owner>/herdr-paste-image.

License

MIT — see LICENSE.

---

Site & contact: grooni.com