clipmon
Clipboard monitor with history tracking. Watch for clipboard changes, maintain a searchable history, and quickly access past clips.
Installation
pip install clipmon
Quick Start
# Get current clipboard
clipmon get
# Set clipboard
clipmon set "Hello, world!"
# Watch for changes (saves to history automatically)
clipmon watch
# View history
clipmon history
# Copy a history entry back to clipboard
clipmon copy 5
Commands
| Command | Description |
|---|---|
get |
Get current clipboard content |
set |
Set clipboard content |
history |
Show clipboard history |
show <id> |
Show full content of a history entry |
copy <id> |
Copy a history entry back to clipboard |
delete <id> |
Delete a history entry |
clear |
Clear all history |
watch |
Watch clipboard for changes |
save |
Save current clipboard to history |
stats |
Show history statistics |
Usage Examples
Basic Operations
# Get clipboard content
clipmon get
# Set from argument
clipmon set "Hello, world!"
# Set from file
clipmon set --file document.txt
# Set from stdin
echo "piped content" | clipmon set --stdin
# Set and save to history
clipmon set "important text" --save
History Management
# Show last 20 entries
clipmon history
# Show more entries
clipmon history --limit 50
# Search history
clipmon history --search "password"
# Show full content (not truncated)
clipmon history --full
# View specific entry
clipmon show 42
# Copy entry back to clipboard
clipmon copy 42
# Delete entry
clipmon delete 42
# Clear all history
clipmon clear
Watch Mode
# Watch and save to history
clipmon watch
# Watch without saving
clipmon watch --no-save
# Faster polling
clipmon watch --interval 0.5
# Quiet mode (just save, no output)
clipmon watch --quiet
# JSON output for automation
clipmon watch --json
Statistics
# Show stats
clipmon stats
# JSON output
clipmon stats --json
JSON Output
All commands support --json for machine-readable output:
clipmon get --json
# {"content": "clipboard text", "length": 14}
clipmon history --json
# [{"id": 1, "content": "...", "timestamp": 1234567890, ...}]
clipmon stats --json
# {"total_entries": 42, "total_size_bytes": 12345, ...}
Storage
History is stored in a SQLite database:
- macOS:
~/Library/Application Support/clipmon/history.db - Linux:
~/.local/share/clipmon/history.db - Windows:
%LOCALAPPDATA%/clipmon/history.db
For AI Agents
See SKILL.md for AI agent integration documentation.
License
MIT
Metadata
Release files for clipmon-cli 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| clipmon_cli-0.1.0.tar.gz | 7.2 kB | Without provenance | Details for clipmon_cli-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| clipmon_cli-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for clipmon_cli-0.1.0-py3-none-any.whl |
Total release size: 15.1 kB
Release files / clipmon_cli-0.1.0.tar.gz
| Download URL | clipmon_cli-0.1.0.tar.gz |
|---|---|
| Size | 7.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
11884ed7c3f9bae2987e213cbda5dcb8d7bf49e4865fa9804fca2a6349aac036
|
|
BLAKE2b-256 checksum How to use checksums |
6ed9cb5a145985b0cab4235d802a79e4e42a102b3f6952ad8406d0b3da3e63d7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.2
|
Release files / clipmon_cli-0.1.0-py3-none-any.whl
| Download URL | clipmon_cli-0.1.0-py3-none-any.whl |
|---|---|
| Size | 7.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ce05ed7eb047662e898bd3bf05b22328e9f515ee8f36be00824361d7d5aec2e3
|
|
BLAKE2b-256 checksum How to use checksums |
784f87e69be2a2d36cd1f6222cc4a13c8a9068e117b96d792271936fcdd8e5a3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.2
|
Security for clipmon-cli 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.