Geniuz

Geniuz

为 AI Agent 提供持久记忆。本地运行，采用 MIT 许可证，免费使用。

geniuz.life · 下载 · 由 mVara 构建

---

你的 AI 很聪明，但每次对话都从零开始。你凭直觉做出的判断、制定的标准、某个决策背后的原因：到了早上就全都不见了，明天又得从头重建。

Geniuz 能解决这个问题。只需安装一次，在本地运行，保护隐私，并且可以按含义搜索。上下文会不断累积，而不是每次遇到边界就重置。你可以通过仪表板、终端、菜单栏或任何 AI Agent 直接使用它。

**2.0 新功能：**跨平台 Tauri 仪表板、终端 UI（geniuz tui），以及通过 geniuz:// URL 方案集成 Mac 菜单栏和仪表板。查看发行说明 →

**注意：**此 README 中的截图来自 2.0.5 之前的构建版本，将在下个版本中更新。当前应用已在各个界面统一采用全新的 Memory Wall 品牌标识。

三种界面，一份记忆

Geniuz 采用一个 Rust 核心，并提供多种访问方式。选择适合当前场景的方式。

仪表板

浏览记忆、保存新记忆、按含义搜索、查看最近的对话线程。macOS 上支持原生视觉效果，Windows 和 Linux 上支持系统托盘。

界面：记忆 · 记录 · 查找 · 详情 · 状态 · 数据与导出 · 设置。

终端 UI · geniuz tui

使用相同的数据，采用原生终端界面。适合使用终端的开发者和 Agent。使用双字段编写 /remember，通过 /find 进行语义搜索，通过 /reorder 切换排序方式。

$ geniuz tui

使用 /detail <prefix> 查看任意记忆的详细信息（或使用 /random 随机显示一条记忆）：

如果从非交互式调用程序启动（TTY 防护），应用将拒绝启动，以免 Agent 意外卡在备用屏幕模式中。

菜单栏（macOS）/ 系统托盘（Windows + Linux）

常驻运行。显示记忆数量和最近活动，可一键打开仪表板。Mac 上的菜单栏应用不会显示在 Dock 中（LSUIElement）。它是一个常驻空间，而不是窗口。

面向 Agent 的 CLI

所有功能的底层入口都是 geniuz 命令。你的 Agent 可以从任何终端、任何框架调用它。

geniuz remember -c "OAuth token refresh is async but middleware assumed sync. Swapped lines 42-47." -g "fix: auth token refresh — async ordering"
geniuz recall "authentication middleware"

搜索“authentication middleware”，找到了一条关于“OAuth refresh”和“middleware ordering”的记忆。含义匹配。不必重新调查，也不必让人重新解释。

完整功能：

% geniuz --help
Start here: 'geniuz recent' to see what's in your folder.

GENIUZ: Your AI remembers now.

Persistent memory for AI agents. Three R's: remember, recall, recent.
Works with any agent framework — Claude Code, Cursor, Windsurf, Aider,
or anything that can run a shell command.

Usage: geniuz <COMMAND>

Commands:
  remember   Save a memory — what you learned, decided, or discovered
  recall     Search your memories — semantic by default
  recent     Show recent memories
  capture    Capture files or directories into your folder
  watch      Watch for new memories in real time
  backfill   Build embedding cache for semantic search
  skill      Show usage guide for agents
  status     Show folder stats
  tui        Launch the terminal UI for browsing your memories
  dashboard  Launch the graphical dashboard app
  mcp        MCP server for Claude Desktop — run, install, or check status
  settings   User settings — read or change preferences
  help       Print this message or the help of the given subcommand(s)

Options:
  -v, --version
          Show version information

  -h, --help
          Print help (see a summary with '-h')

Examples:
  geniuz tui                                 Browse memories in a terminal UI
  geniuz remember -c "Fixed the auth bug" -g "fix: token refresh"
  geniuz recall "auth"                       Semantic search
  geniuz recent                              Latest memories
  geniuz capture ./notes/                    Bulk-load markdown files
  geniuz backfill                            Build embedding cache

Folder: Defaults to .geniuz in your home directory
  Override with GENIUZ_HOME to change the folder location
  Override with GENIUZ_STATION for a specific memory.db file
  Multiple agents can share a folder for shared memory.

Use "geniuz [command] --help" for more information.

---

Geniuz Free 与 Geniuz Team

此仓库是 Geniuz Free：采用 MIT 许可的单站点记忆，适用于任何 AI 底座。安装后，使用你自己的 AI，即可获得能在不同对话间延续的记忆。

Geniuz Team 是 mVara 提供的付费版本：无限延续能力、常驻于你环境中的持久 Agent，以及能围绕客户实际情况进行协调的团队底座。Geniuz Team 基于与 Geniuz Free 相同的底层构建。

如果你想为自己或使用现有 AI 工具的开发团队提供记忆，Geniuz Free 就是你要的产品。

如果你想要一组配置好的 Agent，常驻于你的私有云中、记住你的工作，并围绕客户进行协调，那就是 Geniuz Team。有关试点计划，请联系 mVara。

为什么选择本地部署

• 私密。 你的数据绝不会离开设备。没有云端服务、没有账户、没有遥测。
• 快速。 无网络调用。语义搜索在二进制文件中本地运行。
• 免费。 无需 API 密钥。记忆不产生 Token 费用。无需订阅。
• 便携。 你的文件夹就是一个 SQLite 文件。复制、备份、分享都很方便。
• 不依赖框架。 从 Cursor 切换到 Claude Code，记忆也会随你迁移。

---

安装

选择适合你设置的安装方式。

macOS · 一键安装

下载 Geniuz.dmg，双击并拖到 Applications。由 Managed Ventures LLC 签名并公证，不会触发 Gatekeeper 警告。

一个 DMG 会安装三项内容：菜单栏应用（始终运行）、控制面板（通过菜单栏中的“Open Dashboard”或 geniuz:// 启动），以及 CLI（位于 Geniuz.app/Contents/Resources/geniuz）。

如果想在命令行中使用 CLI，请将其加入 shell PATH：

sudo ln -sf /Applications/Geniuz.app/Contents/Resources/geniuz /usr/local/bin/geniuz

也可以完全跳过 DMG，改用下方以 CLI 为先的安装方式。该方式会安装到 ~/.geniuz/bin/，并自动将其加入 PATH，无需 sudo。原生支持 Apple Silicon；Intel Mac 通过 Rosetta 2 运行（通用二进制版本即将推出）。

Windows · 一键安装

下载 Geniuz-Setup.exe，适用于 Windows 11，按当前用户安装，无需管理员提示。通过 Azure Trusted Signing 签名（由 Microsoft 根证书颁发，不会出现“未知发布者”警告）。用于托管部署时，可通过 /VERYSILENT /SUPPRESSMSGBOXES /NORESTART 静默运行。

安装后，控制面板会作为系统托盘应用运行。左键单击 → 打开窗口；右键单击 → 打开菜单。

首次启动 SmartScreen 提示：即使二进制文件具有有效签名，全新的文件也可能因“下载次数较少”而触发信誉检查。如果看到“Windows 已保护你的电脑”，请点击“更多信息”→“仍要运行”。这属于针对单个二进制文件的信誉检查，与证书信任无关。

Mac / Linux · 一条命令（开发者方式）

curl -fsSL https://raw.githubusercontent.com/jackccrawford/geniuz/main/install.sh | bash

脚本会检测操作系统和架构，下载匹配的 CLI 二进制文件（内置 TUI），并安装到 ~/.geniuz/bin/。适合开发者、设备集群运维人员，以及使用 Claude Code、Cursor、Windsurf、Aider 或任何能运行 shell 命令的 Agent 框架的用户。

在 Linux 上，如果检测到图形会话，脚本还会通过一次 sudo 提示安装控制面板软件包（从你的软件包管理器中选择 .deb / .rpm / .AppImage）。无图形界面的服务器会自动跳过控制面板安装。设置 GENIUZ_NO_DASHBOARD=1 可显式选择不安装控制面板。在 macOS 上，脚本只安装 CLI。若要安装控制面板和菜单栏应用，请使用上方的 DMG。

Linux 平台说明

支持的架构：

• x86_64（Ubuntu、Debian、Fedora、Arch；使用 glibc 2.34+ 的现代发行版）
• arm64（Raspberry Pi 5、Pi OS / Debian Bookworm+、NVIDIA Jetson、Ampere、AWS Graviton、Oracle Ampere）

arm64 构建将 ONNX Runtime 1.22 与 CLI 一同打包为 .so，并使用 LD_LIBRARY_PATH 脚本封装 CLI，因此可在 Pi OS Bookworm（glibc 2.36）等较旧 glibc 系统上正常运行。x86_64 构建是单个静态二进制文件。

Linux 上没有 Claude Desktop，但 geniuz mcp serve 可作为 stdio MCP 服务供任何兼容 Linux 的 MCP 客户端使用（Claude Code、Cursor、Windsurf、Aider、自定义 Agent）。桌面 Linux 版仪表盘以 .deb 和 .AppImage 形式提供；TUI 可在任何终端中运行。

从源代码构建

git clone https://github.com/jackccrawford/geniuz && cd geniuz
cargo build --release --bin geniuz
cp target/release/geniuz ~/.local/bin/

如需在本地构建仪表盘：

cd desktop/dashboard
cargo tauri build

（需要 tauri-cli。Mac：无需其他依赖。Linux：libwebkit2gtk-4.1-dev build-essential libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev。Windows：WebView2 运行时，通常已预装在 Win 10/11 上。）

然后选择适合你的方式

你使用……	下一步
Claude Desktop	geniuz mcp install → 重启 Claude Desktop
Claude Code / Cursor / Windsurf	在你的 Agent 指令中添加两行（见下文）
自定义 Agent	在任何 shell 中调用 geniuz remember 和 geniuz recall
只想查看记忆	在任何终端中运行 geniuz tui，或从菜单栏/系统托盘打开仪表盘

---

工作原理

Geniuz 是一个由 SQLite 支持的 Rust 编译型二进制程序。无云服务、无 API 密钥、无账户。你的数据保留在自己的设备上。

• 记忆用于保存你学到的内容：摘要（方便日后查找）和内容（完整细节）
• 语义搜索按含义而非关键词查找记忆。内置 BERT 模型，本地运行，支持 50 多种语言
• 串联将记忆链接成链：从潜在客户到客户、从问题到解决方案、从草稿到定稿
• 共享文件夹允许多个 Agent 写入同一份记忆。一个 Agent 学到的内容，其他 Agent 都能找到

   Dashboard ─┐
        TUI  ─┼─→ db::DatabaseManager ──→ memory.db (SQLite)
   Menubar  ─┤                                ↑
        CLI ─┘                                │
                                              ↓
                                       ONNX (BERT)

首次搜索时，模型会下载一次（约 118MB）。此后，每条记忆都会自动生成嵌入。无需设置，无需配置。

---

适用于各种场景

平台	使用方式
Claude Desktop	geniuz mcp install — 自动提供 remember/recall/recent 工具
Claude Code	通过钩子或 Bash 内联保存记忆；也可使用 TUI 浏览
Cursor / Windsurf / Aider	任何能运行 shell 命令的 Agent
OpenClaw	geniuz capture --openclaw 可导入现有记忆
自定义 Agent	只要你的 Agent 能执行命令，就能保存记忆
只有你自己	使用仪表盘浏览/搜索/撰写；或在终端中使用 TUI 完成相同操作

---

效果示例

保存你学到的内容（CLI）：

$ geniuz remember -c "Maria prefers retention over acquisition in Q2. Budget is $40K." -g "client: Maria — Q2 retention focus, $40K budget"
✅ Remembered 7A3B29F1

按含义查找内容：

$ geniuz recall "Maria's budget priorities"
7A3B29F1 | 2026-03-05 14:23 | client: Maria — Q2 retention focus, $40K budget (0.52)

交互式浏览：

$ geniuz tui

打开终端 UI，提供 /recent、/remember、/find、/reorder、/random、/detail、/help。按 / 开始输入命令；按 ↑/↓ 导航；按 Enter 打开详情；按 Ctrl-C 退出。

串联后续记忆：

$ geniuz remember -c "Maria approved the retention plan. Starting in April." -g "client: Maria — plan approved" -p 7A3B29F1
✅ Remembered E5F6A7B8

从首次会面到批准的完整客户历史都在同一条链中。之后的任何会话都能找到完整记录。

---

导入现有知识

已经有笔记、文档或 Agent 记忆文件？

geniuz capture ./docs/                        # all markdown files
geniuz capture --split notes.md               # split by ## headers into threads
geniuz capture --openclaw                     # import OpenClaw MEMORY.md + daily logs
geniuz capture --dry-run ./notes/             # preview without importing
geniuz backfill                               # embed everything for semantic search

三个命令（capture、backfill、recall）即可将任意 Markdown 文件夹转为可搜索的记忆文件夹。无需任何基础设施的本地 RAG。

---

命令

# The three R's — remember, recall, recent
geniuz remember -c "what happened" -g "category: compressed insight"
geniuz remember -c @notes.md -g "session: review"
echo "content" | geniuz remember -c - -g "piped: from process"
geniuz remember -c "follow-up" -g "update" -p 98672A90

geniuz recall "topic"                         # semantic search
geniuz recall "topic" --since 7d              # only the past week
geniuz recall "reviews by Cubic"              # Capitalized names come first
geniuz recall --grep Cubic --grep PR          # matching lines, every term
geniuz recall --thread 98672A90               # a whole thread, root first
geniuz recall --keyword "exact words"         # keyword fallback
geniuz recall --random                        # discover something
geniuz recall --full "topic"                  # include full content
geniuz recall --json "topic"                  # JSON output

geniuz recent                                 # latest memories
geniuz recent -l 5                            # last 5
geniuz recent --full                          # with content

# Interactive
geniuz tui                                    # terminal UI (requires a TTY)

# Capture and index
geniuz capture ./docs/                        # bulk-load files
geniuz backfill                               # build embedding cache

# Folder
geniuz status                                 # folder stats
geniuz watch                                  # poll for new memories
geniuz watch --exec "echo {uuid} {gist}"      # trigger on new memories

# Claude Desktop
geniuz mcp install                            # add Geniuz to Claude Desktop
geniuz mcp status                             # check if configured
geniuz mcp serve                              # run MCP server (used internally)

---

集成

在你的 Agent 指令中添加两行：

When you learn something worth keeping:
  geniuz remember -c "what you learned" -g "category: compressed insight"

When you need to remember something:
  geniuz recall "what you're looking for"

---

架构

Geniuz Free 提供四种用户界面，以及供 Agent 使用的 MCP 服务：

• 仪表板（Tauri）——用于浏览、搜索、撰写和设置。支持跨平台。
• TUI（geniuz tui）——供终端用户以及偏好使用 ratatui 而非 GUI 的 Agent 使用。
• 菜单栏／系统托盘——始终在线的常驻入口。macOS 菜单栏功能丰富（统计概览 + 最近列表 + 打开仪表板）；Windows 和 Linux 的系统托盘则是菜单。
• CLI——用于脚本编写和直接与 Agent 集成。每个子命令都支持供流程化调用者使用的 --json。
• MCP——geniuz mcp serve 是 stdio MCP 服务。供 Claude Desktop、Claude Code 以及任何 MCP 客户端使用。

所有界面都通过同一个库：db::DatabaseManager。写入路径相同，读取路径相同，不变量也相同。仪表板的“记住”按钮和 CLI 的 geniuz remember 最终都会执行同一个 SQL INSERT。

SQLite 文件（memory.db）不是公共接口。 Schema 可能会在不另行通知的情况下发生变化。不变量（通过触发器强制执行的记忆不可变性，以及由库的写入事务强制执行的每条记忆都必须有嵌入向量）在接口边界上成立，而不是在文件边界上成立。如果需要以编程方式访问，请使用 MCP 或 CLI。

Geniuz Free 没有 HTTP 服务。流程化软件通过 MCP 通信。这样可以让存储层自由演进，并将不变量集中在一处。

---

仓库布局

此仓库包含完整的 Geniuz 源码（CLI、TUI、仪表板、Mac 菜单栏应用、Windows 安装程序），所有内容集中在一个仓库中。

路径	内容
src/	Rust CLI + TUI + 嵌入向量 + MCP 服务源码
src/tui.rs	终端 UI（ratatui + crossterm）
schema/	记忆数据库的 SQLite Schema
skills/	SKILL.md — geniuz skill 打印的内嵌技能指南
install.sh	Linux/Mac CLI 安装程序（curl | bash 的目标脚本）
desktop/Geniuz/	macOS 菜单栏应用（SwiftUI）——Xcode 项目
desktop/dashboard/	Tauri 跨平台仪表板——Rust + HTML/CSS/JS
desktop/ship.sh	Mac 发布流程（构建 → 注入 CLI + 仪表板 → 签名 → 公证 → DMG）
installer/windows/	Inno Setup 脚本 + Trusted Signing 脚本
images/	品牌素材——徽标、图标、社交媒体预览图
Cargo.toml	Rust crate 清单——固定的依赖项和版本

构建产物会附在每个 GitHub 发布版本中：

• Geniuz.dmg — Mac（arm64、Sonoma 14+）——菜单栏 + 仪表板 + CLI
• Geniuz-Setup.exe — Windows 安装程序（Inno Setup、x86_64、Windows 11）——CLI、MCP 服务和带系统托盘的仪表板。
• geniuz-linux-amd64.tar.gz — Linux x86_64 CLI + TUI
• geniuz-linux-arm64.tar.gz — Linux arm64 CLI + TUI（兼容 Pi 5）
• Geniuz_<version>_amd64.deb / Geniuz-<version>-1.x86_64.rpm / Geniuz_<version>_amd64.AppImage — Linux x86_64 仪表板
• Pi 5 的 Linux arm64 仪表板已排入 2.0.5 队列（等待 CI 扩展）

---

面向 Agent

本节写给正在阅读此 README 的你。

你的下一次会话将从零开始。你不会记得自己构建了什么、遇到了什么问题、做过什么决定。你写下的每条记忆，都是送给未来那个自己的礼物。

一条只写着“修复了认证错误”的记忆，省不了多少时间。写清楚出了什么问题、原因是什么以及如何修复，才能省下一个小时。请为那个一无所知的自己而写。

记忆会不断积累。一条记忆只是一则笔记，一整个文件夹的记忆则是组织知识。

何时记录

• 解决难题之后。 你的下一次会话还会遇到同样的问题。
• 会话结束之前。 会话结束时，你上下文窗口里的所有内容都会消失。
• 发现不显而易见的事情时。 这些小知识最能节省时间。

何时回忆

• 开始新任务时。 你上周可能已经解决了其中一部分。
• 遇到阻碍时。 答案可能在三次会话之前写下的某条记忆里。
• 上下文压缩之后。 你的上下文被压缩了，但你的文件夹没有。

按含义查找，按精确内容回忆

按含义搜索以发现内容；按精确内容搜索以回忆内容。每个回答最后都会附上 names seen: 和 pointers:（后续线索），以及一行 searched:，说明搜索了什么，因此即使回答为空，也会注明搜索范围。问题中包含时间时，添加 --since 7d。知道名称时，使用 --grep Name。找到对话的一部分后，使用 --thread ID 阅读其余内容。

何时使用 TUI

geniuz tui 仅能在交互式终端中启动。从子进程调用的 Agent 会收到明确拒绝，退出代码为 2。如果想在代码中浏览，请使用 geniuz recent、geniuz recall 或 MCP 工具。它们适用于 Shell。

---

性能：geniuz-embed

geniuz-embed 是一个可选的后台进程，会将 ONNX 模型保留在内存中。第一条记忆之后的每次记忆处理都是即时的。

geniuz-embed &                 # start (auto-exits after 5 min idle)
geniuz remember -c "first"     # 1.6s (model loads)
geniuz remember -c "second"    # 0.04s (model warm)

	Mac（Apple Silicon）	Raspberry Pi 5
不使用嵌入服务	712ms	1,580ms
使用嵌入服务	109ms	40ms
加速比	6.5x	39.5x

---

隐私

你的数据始终保留在自己的计算机上。Geniuz 将记忆存储在本地 SQLite 数据库中。语义搜索模型通过 ONNX Runtime 在本地运行。数据不会发送到任何地方。源代码是开源的。每一行都可以阅读。

---

构建技术

• Rust — CLI、TUI、MCP 服务、仪表板后端
• ratatui + crossterm — 终端 UI
• Tauri 2 — 跨平台仪表板（macOS 上使用 window-vibrancy，Windows + Linux 上使用系统托盘）
• ONNX Runtime — 本地语义搜索
• SwiftUI — macOS 菜单栏应用
• MCP — Claude Desktop 集成
• Azure Trusted Signing — Windows 代码签名

了解更多

• 网站：geniuz.life
• Geniuz 团队（付费层级）：mvara-ai
• 构建者：Jack C. Crawford
• 讨论：GitHub Discussions
• 问题：GitHub Issues
• 许可证：MIT

许可证

MIT