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.
Current version 0.1.1. Downloads are served 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.1.1 keeps only the main window on the startup path, warms previews, and creates low-frequency windows on demand; measured tray-ready median improved 51.3% on an Apple M2.
mclip keeps text snippets, screenshots, and files from Finder or File Explorer. 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. mclip does not upload clipboard contents.
mclip supports macOS and Windows and follows system appearance and language. New installs keep 200 items by default, configurable up to 500, 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. add writes history without replacing the system clipboard; copy writes one selected item back to the clipboard.
Agent Mode defaults to Markdown and supports JSON. Regular commands support text, JSON, raw, and Markdown for copied errors, code snippets, and recent context.
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 1The 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 is a desktop utility, not a cloud service. History files, settings, and image assets live in the local app configuration directory.
Downloads stay direct, and the current macOS notarization and Windows signing limitations are 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.
The source code is open on GitHub. The app uses Tauri 2, React 19, TypeScript, and Rust, and runs locally with npm 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.
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 500. Main-window and archive-group counts are separate, and mclip can save text, images, files, or only selected types.