Metadata-Version: 2.4
Name: clipmon-cli
Version: 0.1.0
Summary: Clipboard monitor with history tracking
Project-URL: Homepage, https://github.com/marcusbuildsthings-droid/clipmon
Project-URL: Repository, https://github.com/marcusbuildsthings-droid/clipmon
Project-URL: Issues, https://github.com/marcusbuildsthings-droid/clipmon/issues
Author-email: Marcus <marcus.builds.things@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: automation,cli,clipboard,history,monitor
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Requires-Dist: click>=8.0
Requires-Dist: pyperclip>=1.8
Description-Content-Type: text/markdown

# clipmon

Clipboard monitor with history tracking. Watch for clipboard changes, maintain a searchable history, and quickly access past clips.

## Installation

```bash
pip install clipmon
```

## Quick Start

```bash
# 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

```bash
# 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

```bash
# 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

```bash
# 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

```bash
# Show stats
clipmon stats

# JSON output
clipmon stats --json
```

## JSON Output

All commands support `--json` for machine-readable output:

```bash
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](SKILL.md) for AI agent integration documentation.

## License

MIT
