CLI Reference

CLI Reference

clipctl is the command-line client for the daemon. It talks to clipd over the Unix socket, so the daemon must be running.

			clipctl [options] <command> [arguments]

Global options

OptionDescriptionDefault
--socketPath to the clipd socket/tmp/clipd.sock
--timeoutRequest timeout5s
--versionPrint version information
-vVerbose output

If you started clipd with a custom --socket, pass the same path to clipctl.

Commands

list

Show the most recent entries, newest first.

			clipctl list        # last 10 entries
clipctl list 25     # last 25 entries

Full-text search across your history.

			clipctl search "docker run"

get

Show a single entry by its ID, including its full content.

			clipctl get 42

delete

Delete an entry by ID.

			clipctl delete 42

Warning

Deletion is permanent. There is no undo.

stats

Show statistics about your history: entry counts and database info.

			clipctl stats

help

Show usage for all commands, or one command in detail.

			clipctl help
clipctl help search

Troubleshooting

If every command fails with a connection error, check that:

  1. The daemon is running (ps aux | grep clipd)
  2. Both tools agree on the socket path (--socket on each side)
  3. The socket file exists and you own it (ls -l /tmp/clipd.sock)