Skip to content

mamba-1024/clipVault

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ClipVault

Smart clipboard history & text snippet manager for Chrome (Manifest V3)

ClipVault keeps a local history of what you copy, manages reusable snippets, searches across open tabs, and offers optional AI tools. Data stays in your browser by default—nothing is sent to a ClipVault server.

English · 中文 · Detailed guide (中文)


Features

Module Description
Clipboard history Auto-capture copies; detect URLs, emails, code, etc.
Snippets Reusable text with groups, tags, search, and inline edit
Cross-tab search Find text across all tabs in the current window
Floating ball Quick history access on any webpage
Popup / Side panel Toolbar popup or Chrome Side Panel
Appearance & i18n Light / dark / follow browser; English & 中文 UI
AI (optional) Summarize, translate, rewrite, auto-tag, semantic search (BYOK)

Installation

Load unpacked (development)

  1. Clone or download this repository
  2. Open chrome://extensions in Chrome
  3. Enable Developer mode
  4. Click Load unpacked and select the project root (folder containing manifest.json)

Chrome Web Store

If published, search for ClipVault in the store. Publishing requires a ZIP bundle, screenshots, and a privacy policy URL.


Quick start

  1. Copy text on any page—it is recorded automatically (can be disabled in settings)
  2. Click the ClipVault toolbar icon to open the popup (History, Snippets, Search tabs)
  3. Use Side panel at the bottom for a larger view (Chrome 116+)
  4. Right-click the extension icon → Options for full settings

Shortcuts

Shortcut Action
Ctrl+Shift+V / ⌘+Shift+V Open popup
Ctrl+Shift+S / ⌘+Shift+S Toggle side panel
19 in popup Quick-copy the first 9 history items

Main features

Clipboard history

  • Sort by time, length, or source; keyword search
  • Favorite items; batch favorite / delete
  • Expand long previews; store source page title
  • Duplicate copies merged within a time window (default 60s, configurable)

Snippets

  • Create, edit, and delete snippets
  • Groups: + New group in the group bar, or + New group… in the editor
  • Filter by All, custom groups, or Ungrouped
  • Tags (comma-separated)

Cross-tab search

  • Use the Search tabs tab
  • Case-sensitive and regex options
  • Jump to a tab and highlight matches

Floating ball

  • Click the ball → history panel → copy an item
  • Hover and click × → shrink / hide options
  • Draggable; disable per site or permanently

AI (off by default)

Enable under Settings → AI. Configure an API provider (OpenAI-compatible key recommended):

  • Auto-tag, semantic search
  • Summarize / Translate / Rewrite on history items
  • Configurable translation target language
  • Translation shown in-card with one-click copy

API keys are stored locally only. When AI is used, content is sent to your chosen provider—review their privacy policy.


Settings overview

Section Options
Language Follow browser / English / 中文
AI Provider, API key, model, feature toggles
Appearance Follow browser / Light / Dark
General History limit, max length, auto-delete, default sort
Monitoring Auto-monitor, dedup interval, excluded sites
Search Cross-tab case sensitivity / regex
Floating ball Enable, shrink, disabled sites
Data Export / import JSON, clear data, error logs

Defaults: 500 history items · 5000 chars per item · 30-day auto-delete · 60s dedup window


Privacy & security

  • History, snippets, and settings live in chrome.storage.local—not on ClipVault servers
  • Excluded sites skip recording on sensitive domains
  • Turn off monitoring, floating ball, or AI anytime; clear all data in one action
  • Copies triggered inside the extension (e.g. 19 shortcuts) do not create duplicate history entries

Documentation


Version

1.0.0 (see manifest.json)


License

MIT © ClipVault Contributors


中文

功能概览

模块 说明
剪贴板历史 自动捕获复制内容,识别链接 / 邮箱 / 代码等
文本片段 常用模板,支持分组、标签、搜索与编辑
跨标签搜索 在当前窗口所有标签页中搜索并跳转高亮
网页悬浮球 页面右下角快速查看历史并复制
Popup / 侧边栏 工具栏弹窗与 Side Panel
外观与语言 浅色 / 深色 / 跟随浏览器;中 / 英界面
AI(可选) 摘要、翻译、改写、自动标签、语义搜索(自带 Key)

安装

  1. 克隆或下载仓库
  2. 打开 chrome://extensions,开启 开发者模式
  3. 加载已解压的扩展程序,选择含 manifest.json 的根目录

快速上手

  1. 在网页复制文本即可自动记录(可在设置关闭)
  2. 点击工具栏 ClipVault 图标 打开 Popup
  3. 底部 侧栏 打开 Side Panel(需 Chrome 116+)
  4. 扩展图标右键 → 选项 进入设置

快捷键

快捷键 功能
Ctrl+Shift+V / ⌘+Shift+V 打开 Popup
Ctrl+Shift+S / ⌘+Shift+S 切换侧边栏
Popup 内 19 快速复制前 9 条历史

主要功能

  • 历史: 排序、搜索、收藏、批量操作、去重合并
  • 片段: 分组(+ 新建分组)、标签、编辑
  • 搜全站: 大小写、正则、跳转高亮
  • 悬浮球: 历史面板、隐藏 / 缩小、按站点禁用
  • AI: 设置中启用,支持摘要 / 翻译 / 改写;译文卡片内可复制

隐私

数据保存在本地 chrome.storage.local,不上传 ClipVault 服务器。可配置排除网站、关闭监听与 AI,或清空全部数据。


文档与许可

当前版本:1.0.0

About

是一款 Chrome 扩展(Manifest V3),用于记录剪贴板历史、管理常用文本片段,并在已打开的标签页中快速搜索内容

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors