cmdclip 📋
A smart, cross-platform command clipboard manager for the terminal. Built by M5 Dev — 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
pip install cmdclip
Quick start
# 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)
# 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.
Command templates
Use {variable} or {variable=default} syntax:
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.
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
© M5 Dev
1 maintainer
Metadata
1 maintainer
Release files for cmdclip 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cmdclip-1.0.1.tar.gz | 24.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cmdclip-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 49.3 kB
Release files / cmdclip-1.0.1.tar.gz
| Download URL | cmdclip-1.0.1.tar.gz |
|---|---|
| Size | 24.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0c66141e927dfc4874de3f2a00e1a385afd283f8bc8f210b713e83a05b4b689c
|
|
BLAKE2b-256 checksum How to use checksums |
61343b4da4ce560e2cff572fd5a3d73c1a99997faa662dcae0098f2eda2c2242
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 12, 2026.
Transparency logRelease files / cmdclip-1.0.1-py3-none-any.whl
| Download URL | cmdclip-1.0.1-py3-none-any.whl |
|---|---|
| Size | 24.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
af0f5baf7e50396a49e404ec6c5a008c2b38f16b78714257670bc1564014253f
|
|
BLAKE2b-256 checksum How to use checksums |
82731f66006f0050bf7fdf7a65deb677c7822a23859f341f0a569f7251b40de8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 12, 2026.
Transparency log
