Metadata-Version: 2.4
Name: cmdclip
Version: 1.0.1
Summary: Smart cross-platform command clipboard manager — save, tag, search & run shell commands with AI-powered auto-tagging
Author-email: M5 Dev <m5dev@proton.me>
License: GPL-3.0
Project-URL: Homepage, https://github.com/M5Develop/cmdclip
Project-URL: Repository, https://github.com/M5Develop/cmdclip
Project-URL: Issues, https://github.com/M5Develop/cmdclip/issues
Keywords: cli,terminal,shell,command-manager,clipboard,snippets,productivity,ai,groq,cross-platform,linux,macos,windows,history,search,tags,devtools,sysadmin,automation,dotfiles
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Classifier: Topic :: System :: Shells
Classifier: Topic :: System :: System Shells
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Terminals
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.12
Requires-Dist: rich>=13
Requires-Dist: pyperclip>=1.8
Requires-Dist: groq>=0.9
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Dynamic: license-file

# cmdclip 📋

> A smart, cross-platform command clipboard manager for the terminal.
> Built by [M5 Dev](https://github.com/M5Develop) — GPL-3.0

---

## Why cmdclip?

`history` is short. `grep` is tedious. `pet` is Go-only.  
**cmdclip** is Python, works on Linux / macOS / Windows, and has AI built in.

---

## Install

```bash
pip install cmdclip
```

---

## Quick start

```bash
# Save a command
cmdclip add "docker ps -a --format '{{.Names}}'" --tags docker,ops --note "list container names"

# List all
cmdclip list

# Search
cmdclip search docker

# Run by ID
cmdclip run a3f9

# Dry-run with AI explanation
cmdclip run a3f9 --dry-run

# AI explain any saved command
cmdclip explain a3f9

# Import from shell history (smart — picks commands used 5+ times)
cmdclip history

# Export / import
cmdclip export --output backup.json
cmdclip import backup.json --safe

# Share as a snippet (copies to clipboard)
cmdclip share a3f9

# Usage stats
cmdclip stats
```

---

## AI features (Groq)

```bash
# Save your Groq API key once
cmdclip config set-key gsk_xxxxxxxxxxxx

# Now add / explain / dry-run all use AI automatically
```

Get a free key at [console.groq.com](https://console.groq.com).

---

## Command templates

Use `{variable}` or `{variable=default}` syntax:

```bash
cmdclip add "ssh {user}@{host} -p {port=22}" --name ssh-connect
cmdclip run <id>
# Fill in: user? host? port [22]?
```

---

## Safe mode

Import with `--safe` to automatically quarantine dangerous commands  
(`rm -rf`, `sudo rm`, `DROP TABLE`, etc.) into a separate file.

```bash
cmdclip import backup.json --safe
```

---

## Cross-platform paths

| OS | Data directory |
|----|---------------|
| Linux / macOS | `~/.cmdclip/` |
| Windows | `%LOCALAPPDATA%\cmdclip\` |

---

## License

GNU General Public License v3.0 — see [LICENSE](LICENSE)  
© M5 Dev
