English | 中文

A keyboard-first link manager inspired by Raycast, built with Electron, React, TypeScript, and Vite.

KJump is a lightweight desktop app for quickly saving, searching, and opening links. It also includes a simple daily task view.

• Fast search over your saved links
• Keyboard-first navigation (no mouse required)
• Quick create from URL input
• Tag filtering
• Quick Notes with Markdown preview (secure, GFM) and full-screen editing
• Tag Manager for searching, renaming, and deleting tags across links and notes
• Local storage: SQLite in Electron, localStorage fallback in browser mode

Global (works system-wide)

• Toggle main window: Alt+Space
• Jump to tasks view: Alt+Shift+T

In-app

• Navigate list: ArrowUp / ArrowDown
• Open selected: Enter
• Close dialog / blur input: Escape
• Delete selected: Cmd+Backspace / Cmd+Delete (macOS), Ctrl+Backspace / Ctrl+Delete (Windows/Linux)
• Switch to tasks view: Cmd+T / Ctrl+T

Option A: Download

• Get the latest installer from GitHub Releases: https://github.com/kangyujian/kjump/releases

Option B: Build from source

Prerequisites:

• Node.js >=16 (recommended: latest LTS)
• npm

npm install

npm run dev

• Switch between Links / Notes / Tasks at the header controls
• Notes support Markdown preview and full-screen editing
• Tags can be filtered in the Notes view and managed via the Tag Manager

npm run lint

npm run build

Build artifacts are generated in release/<version>/:

• macOS: KJump-Mac-<version>-Installer.dmg
• Windows: KJump-Windows-<version>-Setup.exe
• Linux: KJump-Linux-<version>.AppImage

In Electron mode, the database file is links.db under Electron userData:

• macOS: ~/Library/Application Support/KJump/links.db
• Windows: %APPDATA%\\KJump\\links.db
• Linux: ~/.config/KJump/links.db

To back up, quit KJump and copy links.db to a safe location.

In browser mode (when window.electronAPI is not available), data is stored in localStorage under the key kjump_links.

• better-sqlite3 install errors: make sure native build tools are installed (macOS: xcode-select --install), then re-run npm install.
• Global shortcut not working: other apps may already bind Alt+Space. Change it in electron/main.ts and rebuild.

• src/: Renderer (React UI)
• electron/: Main & preload scripts
• dist-electron/: Compiled Electron output
• release/: Packaged installers

See RELEASE_NOTES.md.

KJump 是一款轻量的桌面链接管理工具，支持快速保存、搜索与打开链接；同时提供一个按天查看的任务页面。

• 快速搜索已保存链接
• 键盘优先交互（尽量不需要鼠标）
• 输入 URL 后快速创建
• 标签筛选
• 快速笔记：支持 Markdown 预览（安全，GFM）与全屏编辑
• 标签管理器：支持在链接与笔记中搜索、重命名、删除标签（批量）
• 本地存储：Electron 使用 SQLite，浏览器模式自动回退到 localStorage

全局快捷键（系统级）

• 显示/隐藏主窗口：Alt+Space
• 跳转到任务页面：Alt+Shift+T

应用内快捷键

• 列表上下移动：ArrowUp / ArrowDown
• 打开选中项：Enter
• 关闭弹窗/输入框失焦：Escape
• 删除选中项：macOS Cmd+Backspace / Cmd+Delete，Windows/Linux Ctrl+Backspace / Ctrl+Delete
• 切换到任务页面：macOS Cmd+T，Windows/Linux Ctrl+T

方式 A：直接下载

• 从 GitHub Releases 获取最新安装包：https://github.com/kangyujian/kjump/releases

方式 B：源码构建

环境要求：

• Node.js >=16（建议使用最新 LTS）
• npm

npm install

npm run dev

• 通过头部按钮在 链接 / 笔记 / 任务 视图间切换
• 笔记支持 Markdown 预览与全屏编辑
• 在笔记视图可按标签筛选；通过「标签」按钮进入标签管理器进行批量重命名或删除

npm run lint

npm run build

产物位于 release/<version>/：

• macOS：KJump-Mac-<version>-Installer.dmg
• Windows：KJump-Windows-<version>-Setup.exe
• Linux：KJump-Linux-<version>.AppImage

Electron 模式下，数据库为 links.db，位于 Electron 的 userData 目录：

• macOS：~/Library/Application Support/KJump/links.db
• Windows：%APPDATA%\\KJump\\links.db
• Linux：~/.config/KJump/links.db

备份方式：退出 KJump 后，将 links.db 复制到安全位置即可。

浏览器模式（即 window.electronAPI 不存在）会将数据写入 localStorage，key 为 kjump_links。

• better-sqlite3 安装失败：先安装本机构建工具（macOS：xcode-select --install），再重新执行 npm install。
• 全局快捷键无效：Alt+Space 可能被其他应用占用；可在 electron/main.ts 修改组合键后重新打包。

• src/：渲染进程（React UI）
• electron/：主进程与 preload
• dist-electron/：Electron 编译输出
• release/：各平台安装包

见 RELEASE_NOTES.md。

MIT