mtuck

    Moonbit 实现的终端剪贴板历史 cli 工具

    clipboard
    history
    cli
    productivity
    Download zip
    Version
    0.1.1
    License
    Apache-2.0
    Last updated
    6 hours ago
    Downloads
    12

    #mtuck — 跨平台剪贴板历史工具

    名字取自 MoonBit + tuck(把东西塞进兜里、收起来)——剪下来的片段随手收好,需要时再拿出来。 mtuck 是一个用 MoonBit 写的终端剪贴板管理器: 常驻后台记录你复制过的每一段内容,需要时按编号找回来、搜出来、再写回剪贴板。

    • 跨平台:macOS、Windows、Linux(Wayland / X11)一套代码,原生编译(native 后端)。
    • 不离开终端:list / show / copy,配合 shell 别名和管道即可接入任何工作流。
    • 默认安全:识别出的密钥、Token、带口令的连接串会自动打码,避免明文进历史文件。

    $ mtuck list #0 刚刚 ×3 [url] https://github.com/moonbitlang/moon #1 1 分钟前 ×1 [text] cargo test --workspace ★ #2 15 分钟前 ×1 [token] ghp_•••••••• #3 1 小时前 ×1 [text] 会议纪要:下周一对齐

    #安装

    需要 MoonBit CLI(国内可用 镜像)。 macOS / Windows 的剪贴板走系统原生接口,无需额外依赖;Linux 需要 wl-clipboard(Wayland)或 xclip / xsel(X11):

    # Debian / Ubuntu sudo apt install xclip # Wayland 用 wl-clipboard # Fedora sudo dnf install xclip # Arch sudo pacman -S xclip

    从源码构建并安装:

    git clone https://github.com/SundayT1998/moonbit-language-clipboard_history_cli.git cd moonbit-language-clipboard_history_cli moon update moon build --release --target native install -m 755 _build/native/release/build/cmd/main/main.exe ~/.local/bin/mtuck

    确认 ~/.local/bin 在 PATH 里,然后 mtuck version 验证安装。

    #快速上手

    mtuck watch # 终端 1:开始记录(保持运行,Ctrl-C 退出) # …… 正常复制粘贴 …… mtuck list # 终端 2:看看记了什么 mtuck show 0 # 看最新一条的完整内容 mtuck copy 3 # 把第 3 条写回系统剪贴板,然后直接 Ctrl-V mtuck list -q moon # 按子串搜索

    watch 期间每记录一条都会立刻落盘并打印一行预览:

    监听剪贴板中(每 1000ms 检查一次,Ctrl-C 退出) 已有 12 条历史 + [text] git log --oneline -20 + [url] https://mooncakes.io/docs/moonbit-community/proton_clipboard + [secret] ghp•••••••• (40 字符)

    可以把 watch 交给系统托管,开机自动运行:见 docs/autostart.md。

    #命令

    命令别名作用
    mtuck watch持续监听剪贴板并写入历史,Ctrl-C 退出
    mtuck listls列出历史条目(-n 限制条数、-q 搜索、-p 只看固定)
    mtuck show <n>打印第 n 条的完整内容
    mtuck copy <n>cp把第 n 条写回系统剪贴板
    mtuck pin <n> / unpin <n>固定 / 取消固定条目
    mtuck rm <n>remove删除条目
    mtuck clear清空历史(默认保留固定条目,-f 全清)
    mtuck stats条目数、固定数、疑似密钥数、总字符 / 总字节
    mtuck help / version-h / --help、--version帮助 / 版本号

    <n> 是最新为 0 的编号,也支持 last、1,3,5、2-5 等写法。 完整选项、环境变量、--json 输出格式与退出码见 docs/commands.md。

    更多文档(工作原理与存储格式、开发指南、开机自启)见 docs/,贡献流程见 CONTRIBUTING.md。

    #路线图

    #许可

    Apache-2.0。内置的剪贴板能力来自 proton_clipboard。

    Source Files