Open from the tray
Click the menu bar or system tray icon. Open mclip when you need it, then get back to work.
Keep copy history close.
Text, images, and files
Keep snippets, screenshots, and files together. File history restores a system file list; details show the full absolute path and name.
Independent previews
Preview without widening the main window. Open images in a dedicated viewer, maximize or restore, and close with Escape.
Keyboard first
Type to search, use arrow keys to select, and press Enter to copy. Pin the items you reach for most.
Local by default
Your clipboard history stays on your computer. Sensitive-text masking and source-app exclusions are optional local controls.
Three platforms
Available for macOS, Windows, and Linux. Follow the system theme and choose Chinese, English, or Japanese.
AI Agent and CLI
Give Codex, Claude Code, Cursor, and Cline local context from what you already copied. mclip-cli reads your history and returns Markdown or JSON.
Context in one command
Agent Mode bundles recent history, command capabilities, and safety boundaries.
Read first, act explicitly
Read commands leave history untouched. Copy, pin, and clear are separate actions.
Composable text tools
Transform JSON, Base64, or URL components through stdin and stdout.
Install mclip-cli
curl -fsSL https://www.mclip.cn/install.sh | shCommon commands
mclip-cli agent --last 5 --json
mclip-cli list --limit 5 --json
mclip-cli context --last 3 --format markdownMore commands
mclip-cli add "note from agent"
mclip-cli copy --index 1
printf '%s' '{"ok":true}' | mclip-cli transform json-prettify
printf '%s' 'pipeline clipboard text' | mclip-cli copy
mclip-cli pin --id h_xxx
mclip-cli list --pinned --json
mclip-cli list --json --with-metaCLI installation notes · Git Bash on Windows
The installer downloads the prebuilt mclip-cli and SHA-256 companion from the same GitHub Release, verifies it before replacing an older CLI, and accepts MCLIP_VERSION for pinned installs. It falls back to a source build only when the binary asset is missing. Windows CLI users should run it from Git Bash or another POSIX-compatible shell.
Your clipboard history stays on your computer.
mclip does not upload clipboard contents. v0.2.0 masks detected sensitive text by default, but history remains local plaintext: masking is not encryption at rest, and heuristic detection or source exclusions are not DLP or breach-prevention guarantees.
Download v0.2.0
Choose a package for your platform. Installation notes are listed below.
macOS
ARM64 · DMG
Open the DMG and drag mclip.app into Applications. Not notarized; macOS may quarantine the first launch.
Windows
x64 · EXE / MSI
Run the EXE or MSI installer. Unsigned; Windows SmartScreen may show an unknown-publisher warning.
Linux
x86_64 · DEB / AppImage
Linux x86_64 preview with DEB and AppImage. Tray, shortcuts, auto-paste, source identity, and positioning vary by desktop session. No ARM64 packages.
v0.2.0 was published on September 19, 2026 and is available from GitHub Releases.
All release assets Source codeCommon questions before installing
Installation, privacy, and everyday use.
Does mclip upload my clipboard contents?
No. History, settings, and generated image assets stay on your computer in the local app configuration directory. The Windows installer may only access the network to install WebView2 when it is missing.
Is sensitive-content masking encryption?
No. The v0.2.0 mask protects the UI and default CLI output, while original history remains local plaintext so copy stays exact. Detection and source identity are best-effort and can produce false results; source-application exclusion is currently unavailable on pure Wayland.
What if macOS says the app is damaged?
The current macOS build uses ad-hoc signing and is not notarized with an Apple Developer ID. After dragging mclip.app into Applications, you can run xattr -dr com.apple.quarantine /Applications/mclip.app if you trust the release.
Is the Windows SmartScreen warning expected?
Yes for now. The Windows package is not code-signed yet, so SmartScreen may warn about an unknown publisher. Install only GitHub Releases you trust.
How many items can mclip keep?
New installs keep up to 200 items by default, configurable from 10 to 1000. Main-window and archive-group counts are separate, and mclip can save text, images, files, or only selected types. The pin limit defaults to 10, adjustable from 5 to 20 in History settings. Lowering it keeps existing pins; pins do not consume ordinary history or display counts.