Service DBus Linux Mint

KatKlips

A DBus service for Linux Mint that manages clipboard history, bookmarks, and notes — giving AI agents instant, programmatic access to the context you've been collecting.

Quick Start

bash

# Install
sudo apt install katklips

# Enable and start the service
systemctl --user enable --now katklips

# Verify it's running on DBus
dbus-send --session --print-reply \
  --dest=com.amberlinux.KatKlips \
  /com/amberlinux/KatKlips \
  com.amberlinux.KatKlips.GetHistory \
  uint32:10

Features

Clipboard history

Every copy is stored and searchable. Pull any previous clipboard entry back on demand — perfect for feeding context to agents.

Bookmarks

Pin any snippet, URL, or text block as a named bookmark. Access it instantly from the command line or via DBus.

Notes

Lightweight inline notes attached to bookmarks. Annotate why you saved something, link it to a project, or leave a breadcrumb for later.

DBus interface

First-class DBus API so any Amber Linux tool — or your own scripts — can read, write, and query your clipboard context programmatically.

Kat800 integration

Send pane output straight into KatKlips from your terminal multiplexer with a single keypress.

Search

Full-text search across your entire clipboard history, bookmarks, and notes from the CLI or a minimal GTK popup.

DBus API

KatKlips is exposed at com.amberlinux.KatKlips on the session bus. Every method is also available via the katklips CLI wrapper.

Method	Returns	Description
`GetHistory(limit)`	Array<Entry>	Return the N most recent clipboard entries.
`SaveBookmark(text, name)`	String id	Save a named bookmark and return its UUID.
`GetBookmarks()`	Array<Bookmark>	Return all saved bookmarks.
`AddNote(bookmark_id, note)`	Boolean	Attach a note to an existing bookmark.
`Search(query)`	Array<Result>	Full-text search across history, bookmarks, and notes.
`Purge(older_than_days)`	Integer	Delete history entries older than N days.

CLI Examples