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

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