copyq-scripting

Authoritative reference for the CopyQ command-line interface and scripting language on Ubuntu Linux. Load this before authoring any other CopyQ skill output so generated commands and scripts are syntactically valid. Covers `copyq` subcommands (read, write, add, remove, tab, select, eval, edit), the embedded ECMAScript-flavoured scripting language, MIME-type handling, and item formats.

Export CopyQ Custom Commands to a versionable `.ini` bundle and import them on another machine or after a reinstall. Use when the user wants to back up their CopyQ commands, sync between workstations, or ship a curated bundle as part of a dotfiles repo.

Install CopyQ on Ubuntu (apt or upstream PPA), enable autostart, and apply a sensible baseline configuration — clipboard history limit, store images, monitor selections, and tray behaviour. Use when the user says CopyQ is missing, freshly installed, or behaving with default settings they want changed.

Create, rename, reorder, and remove CopyQ tabs; move or copy items between tabs; deduplicate; pin items; and clear history selectively. Use when organising clipboard history into named buckets (Links, Snippets, Code, etc.) or doing bulk cleanup.

Author a CopyQ Custom Command — automatic clipboard transformations, menu actions, or global-shortcut handlers. Produces a valid `.ini` snippet that can be imported via Preferences → Commands → Load, or via `copyq loadCommands`. Use when the user wants CopyQ to react automatically to clipboard events (e.g. strip formatting, route URLs to a tab, redact secrets).

Bind a system-wide keyboard shortcut to a CopyQ Custom Command — show menu, paste-as-plain-text, run a transformation on the current clipboard, etc. Covers both the in-CopyQ `GlobalShortcut` field and the alternative of binding the shortcut at the desktop-environment level (KDE / GNOME) to a `copyq` CLI invocation.

Read the current clipboard, the X11 PRIMARY selection, or any item from CopyQ history — by row, by MIME type, or filtered by regex. Use when the user wants to inspect what's on the clipboard, dump history to a file, or pipe clipboard contents into another tool.