Menu bar on macOS · System tray on Windows
mclip lives in the menu bar or system tray. Open it when you need a previous text snippet, image, or file, then return to work without a large window taking over.
v0.2.0 was published on September 19, 2026 and is available from GitHub Releases.
The page mirrors the product flow: open the tray window, search, preview, copy, then get back to the task you were doing.
Click the menu bar or system tray icon, or press CommandOrControl+Shift+V. v0.2.0 keeps only the main window on the startup path, warms previews, and creates low-frequency windows on demand; the recorded Apple M2 protocol measured a 51.3% tray-ready median improvement.
mclip keeps text snippets, screenshots, and files from Finder or File Explorer. The pin limit defaults to 10, adjustable from 5 to 20 in History settings. Lowering the limit keeps existing pins. Pin frequently reused items ahead of ordinary history without consuming the main or archive count. Selecting file history restores a system file list rather than path-only text, while details still show the full absolute path and name.
The latest 10 items stay compact by default, with tighter text/file rows that do not shrink image rows. Older history stays grouped and hover details remain independent. Image details can open in a dedicated maximized viewer, restore, and close with Escape.
Type to filter, use arrow keys to move, press Enter to copy, and hit Escape to hide. Search, keyboard, and pointer input share one active target across history, groups, and footer actions.
Clipboard history, settings, and image assets stay on your computer. v0.2.0 uses bounded heuristics to classify and mask high-confidence sensitive text by default and can exclude configured source applications; both controls can miss or misclassify content.
mclip supports macOS and Windows, follows system appearance and language, and offers Chinese, English, and Japanese. New installs keep 200 items by default, configurable up to 1000, with controls for list counts, row numbers, and branding. The Agent CLI tab safely installs, upgrades, or reinstalls the matching version.
For developers and AI agents
mclip-cli gives Codex, Claude Code, Cursor, and Cline a local terminal entry into clipboard history. Agent Mode bundles recent history, available commands, and safety boundaries so agents do not need you to paste the same snippet again.
mclip-cli agent --last 5 --json emits recent history, command capabilities, and safety boundaries for Codex, Claude Code, Cursor, and Cline.
agent/list/get/search/context are read-only and support pinned filtering. pin/unpin mutate one stable item; clear --yes --keep-pinned removes ordinary history while preserving pins.
Agent Mode defaults to Markdown and supports JSON. transform composes JSON, Base64, and URL-component operations over stdin/stdout, while copy accepts one stdin source. Neither mode directly mutates history.
Install mclip-cli
curl -fsSL https://www.mclip.cn/install.sh | shCommon commands
mclip-cli agent --last 5 --jsonmclip-cli list --limit 5 --jsonmclip-cli context --last 3 --format markdownmclip-cli add "note from agent"mclip-cli copy --index 1printf '%s' '{"ok":true}' | mclip-cli transform json-prettifyprintf '%s' 'pipeline clipboard text' | mclip-cli copymclip-cli pin --id h_xxxmclip-cli list --pinned --jsonmclip-cli list --json --with-metaThe 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.
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.
Choose a platform asset from the published GitHub Release, with macOS notarization, Windows signing, and Linux preview limits visible before install.
Download the DMG from GitHub Releases and drag mclip.app into Applications. The current build is not notarized, so macOS may quarantine it after browser download.
Download the MSI or EXE installer and follow the setup wizard. The current installer is unsigned, so Windows SmartScreen may show an unknown-publisher warning.
Download the DEB or AppImage from the v0.2.0 Release. Tray, shortcut, auto-paste, source-identity, and panel-positioning behavior can degrade independently across X11, XWayland, and Wayland sessions. ARM64 packages are not provided.
The source code is open on GitHub. The app uses Tauri 2, React 19, TypeScript, and Rust, and runs locally with pnpm run tauri:dev.
Signing, notarization, WebView2, and the local data boundary are visible before anyone downloads the app.
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.
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.
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.
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.
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.