clipboard manager. 100% vibecoded.
cmd-shift-c to open and select recent clipboard entries
- Clipboard history — stores last 50 entries in memory (never on disk)
- cmd-shift-c or click
[F]in menu bar to open - Fuzzy search, ctrl-n/ctrl-p navigation, click or Enter to paste
- Password detection — masks entries that look like passwords (
********), auto-expires after 60s - Bitwarden support — recognizes
org.nspasteboard.ConcealedTypepasteboard marker - Bilingual UI — English and Chinese, switchable from menu.
- Fully local. Zero internet. Zero disk. All in-memory.
make build # build Debug
make run # build, kill existing, launch
make prod # build Release, install to /Applications, launch
make clean # remove build artifacts
Requires Accessibility permissions for paste simulation (prompted on first launch).
make test
Runs 282 tests covering clipboard management, password detection, fuzzy search, localization, language detection, syntax highlighting, code coverage, and integration flows.
Tests use xcodebuild build-for-testing + xcrun xctest (not xcodebuild test, which fails with "Pseudo Terminal Setup Error" in sandboxed environments).
After tests pass, a code coverage summary is printed. GUI-heavy files (AppDelegate, ClipboardHistoryViewController, PopupWindow, etc.) are excluded from the coverage report since they require a running GUI event loop.
make testadvancedrequireshuman
Automated UI test that drives Freeboard via the macOS accessibility tree using AppleScript. Covers sections 1-10 of the tester guide (menu bar, clipboard capture, pasting, search, star/delete, tab expand, editor, help, context menu, settings, password detection).
This test must be run by a human (never by an agent). It prompts for confirmation before starting and requires the human to watch the screen. Some checks are automated (pass/fail); others require manual visual verification (reported as SKIP).
Right-click the [F] menu bar icon, or use the Quit button in the popup footer.
All UI strings with pinyin for learners:
| English | 汉字 | Pīnyīn |
|---|---|---|
| Search clipboard history | 搜索剪贴板历史 | sōusuǒ jiǎntiēbǎn lìshǐ |
| navigate | 导航 | dǎoháng |
| paste | 粘贴 | zhāntiē |
| close | 关闭 | guānbì |
| expand | 展开 | zhǎnkāi |
| edit | 编辑 | biānjí |
| delete | 删除 | shānchú |
| Quit | 退出 | tuìchū |
| Quit Freeboard | 退出 Freeboard | tuìchū Freeboard |
| just now | 刚刚 | gānggāng |
| Chinese | 中文 | zhōngwén |
| N minutes ago | N分钟前 | N fēnzhōng qián |
| N hours ago | N小时前 | N xiǎoshí qián |
| N days ago | N天前 | N tiān qián |
| Language | 语言 | yǔyán |
| Text you copy will show up here | 复制的文本将显示在这里 | fùzhì de wénběn jiāng xiǎnshì zài zhèlǐ |
| open/close | 打开/关闭 | dǎkāi/guānbì |
| quick select | 快速选择 | kuàisù xuǎnzé |
| search | 搜索 | sōusuǒ |