.. program:: kitty +kitten clipboard


.. highlight:: sh
.. code-block:: sh

  kitty +kitten clipboard [options] 

Read or write to the system clipboard.

To set the clipboard text, pipe in the new text on stdin. Use the
:option:`--get-clipboard` option to output the current clipboard contents to
:file:`stdout`. Note that you must enable reading of clipboard in
:file:`kitty.conf` first.


Options
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. option:: --get-clipboard

    Output the current contents of the clipboard to stdout. Note that this will not work if you have not enabled the option to allow reading the clipboard in kitty.conf
    Default: :code:`False`

.. option:: --use-primary

    Use the primary selection rather than the clipboard on systems that support it, such as X11.
    Default: :code:`False`

.. option:: --wait-for-completion

    Wait till the copy to clipboard is complete before exiting. Useful if running the kitten in a dedicated, ephemeral window.
    Default: :code:`False`

