herdr-pouch

Overview

Pouch is a Herdr plugin for stashing prompts before an agent needs them and inserting them when it is ready. It lets users queue instructions while an agent is still working and hand them over one keypress at a time. Text is typed into the input, never submitted, so the user always presses Enter. The plugin requires Herdr 0.7+ and Node 22.6+ or Bun, with no build step or clone. Setup writes one marked block to ~/.config/herdr/config.toml, and uninstall keeps stashed messages because they are the user's writing, not a cache. Users can stash from a shell, a script, or one agent preparing work for another. The CLI includes add, list, show, insert, rm, clear, strip, unstrip, open, browse, sync, key, setup, update, and uninstall. A popup supports moving, filtering, copying, editing, deleting, reordering, switching pouches, and choosing which pane inserts go to. Storage uses one JSON file per pouch under pouches/, keyed by workspace label, cwd, and agent, never by pane id. Every write takes a lock and re-reads inside it.