README.md

wrap

wrap wraps text in a fenced code block or <paste> tags.

1. Wrap from stdin to stdout wrap [md|xml]

   • If format is md, fences the content with backticks.
     • If the longest run of backticks in the content is >= 3, the fence is (longest + 2) backticks.
     • Otherwise, uses 3 backticks.
   • If format is xml, wraps content in <paste> ... </paste> tags.

2. Unwrap from stdin to stdout wrap unwrap

   • Removes outer markdown fences or <paste>...</paste> tags.
   • Leaves content unchanged when no known wrapper is present.

3. Wrap clipboard content, then paste wrapctl paste [md|xml]

   • Sends the request to wrapd over $XDG_RUNTIME_DIR/wrap/wrapd.sock.
   • Reads the current clipboard text.
   • Checks whether the text is already wrapped.
   • Updates the clipboard with the requested wrapper when needed.
   • Emits Ctrl+Shift+V.

4. Unwrap clipboard content, then paste wrapctl unwrap-paste

   • Removes outer markdown fences or <paste>...</paste> tags from the clipboard.
   • Emits Ctrl+Shift+V.

5. Paste stdin wrapctl paste-stdin

   • Reads text from stdin.
   • Sets the clipboard to that text.
   • Emits Ctrl+Shift+V.

6. Emit paste wrapctl emit-paste

   • Emits Ctrl+Shift+V without changing the clipboard.

7. Check daemon status wrapctl status

Paste backends

On Linux, wrapd uses zwlr_data_control_manager_v1 for clipboard access and zwp_virtual_keyboard_manager_v1 for paste key events.

On macOS, wrapctl uses the system pasteboard; the managed Hammerspoon runtime emits Command-V.

Home Manager

{
  imports = [ inputs.wrap.homeManagerModules.default ];
  programs.wrap.enable = true;
}

For nix-darwin, also import inputs.wrap.darwinModules.default; it declares the Hammerspoon cask.