Geniuz

Geniuz

AI エージェントのための永続メモリ。お使いのマシンで動作し、MIT ライセンスのオープンソースで、無料です。

geniuz.life · ダウンロード · mVara が開発

---

AI は優秀です。しかし、会話のたびに何もないところから始まります。直感で下した判断、定めた基準、決断の理由――朝には消え、翌日にはまた最初から作り直しです。

Geniuz がそれを解決します。インストールは一度だけ。ローカルで動作し、プライベートで、意味から検索できます。コンテキストは区切りごとにリセットされず、積み重なっていきます。ダッシュボード、ターミナル、メニューバーから、または任意の AI エージェントから直接利用できます。

2.0 の新機能： クロスプラットフォーム対応の Tauri ダッシュボード、ターミナル UI（geniuz tui）、geniuz:// URL スキームによる Mac メニューバーとダッシュボードの連携。リリースノートを見る →

注： この README のスクリーンショットは 2.0.5 より前のビルドのもので、次回リリースで更新予定です。現在のアプリでは、すべての画面で新しい Memory Wall ブランドマークを使用しています。

3つの画面、ひとつのメモリ

Geniuz はひとつの Rust コアと、そこへアクセスする複数の方法で構成されています。そのときの用途に合ったものを選んでください。

ダッシュボード

メモリの閲覧、新規保存、意味による検索、最近のスレッドの確認ができます。macOS ではネイティブのビジュアルエフェクト、Windows と Linux ではシステムトレイに対応しています。

画面：メモリ · 記憶 · 検索 · 詳細 · ステータス · データとエクスポート · 設定。

ターミナル UI · geniuz tui

同じデータをターミナルネイティブで利用できます。シェルを常用する開発者やエージェント向けです。/remember の2フィールド入力、/find によるセマンティック検索、/reorder による並べ替えの切り替えができます。

$ geniuz tui

/detail <prefix> で任意のメモリの詳細を表示できます（ランダムに表示するには /random を使います）。

非対話型の呼び出し元からの起動は拒否されます（TTY ガード）。これにより、エージェントが代替画面モードで誤って操作不能になるのを防ぎます。

メニューバー（macOS）／システムトレイ（Windows と Linux）

常時表示され、さりげなく利用できます。メモリ件数、最近のアクティビティ、ダッシュボードへのワンクリックアクセスに対応しています。Mac のメニューバーアプリは Dock に表示されません（LSUIElement）。ウィンドウではなく、常駐するアプリです。

エージェント向け CLI

すべての基盤となるのが、geniuz コマンドです。エージェントは、どのシェルからでも、どのフレームワークからでも呼び出せます。

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 の有料プランです。無制限の継続性、環境内で稼働する永続的なエージェント、そしてお客様の実情に合わせて連携するチームシャーシを提供します。Geniuz Team は、Geniuz Free と同じ基盤上に構築されています。

既存の AI ツールを使う個人や開発チーム向けのメモリが必要な場合は、Geniuz Free がおすすめです。

プライベートクラウドで稼働し、作業を記憶してお客様の実情に合わせて連携するエージェントチームを構成したい場合は、Geniuz Team をご利用ください。パイロット導入に関するお問い合わせは mVara までご連絡ください。

ローカル環境を選ぶ理由

• プライベート。 データが端末から外に出ることはありません。クラウドもアカウントもテレメトリーも不要です。
• 高速。 ネットワーク呼び出しはありません。セマンティック検索はバイナリ内でローカルに実行されます。
• 無料。 API キーは不要です。メモリにトークン費用はかかりません。サブスクリプションもありません。
• ポータブル。 フォルダーは SQLite ファイルです。コピー、バックアップ、共有ができます。
• フレームワークに依存しません。 Cursor から Claude Code に切り替えても、メモリはそのまま使えます。

---

インストール

お使いの環境に合った方法を選んでください。

macOS · ワンクリック

Geniuz.dmg をダウンロードし、ダブルクリックして Applications にドラッグします。Managed Ventures LLC による署名および公証済みです。Gatekeeper の警告は表示されません。

1 つの DMG で 3 つのものがインストールされます。メニューバーアプリ（常時起動）、ダッシュボード（メニューバーの「Open Dashboard」から、または geniuz:// 経由で起動）、CLI（Geniuz.app/Contents/Resources/geniuz に同梱）。

コマンドラインから使う場合は、CLI をシェルの PATH に追加してください。

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

または、DMG を使わず、以下の CLI 優先の方法でインストールすることもできます。この方法では ~/.geniuz/bin/ にインストールされ、sudo を使わずに PATH へ自動で追加されます。Apple Silicon ネイティブ対応です。Intel Mac では Rosetta 2 経由で動作します（ユニバーサルバイナリは準備中）。

Windows · ワンクリック

Geniuz-Setup.exe をダウンロードします。Windows 11 対応、ユーザーごとのインストールで、管理者権限の確認はありません。Azure Trusted Signing による署名済みです（Microsoft をルートとする証明書のため、「発行元を確認できません」という警告は表示されません）。管理された環境へのデプロイでは、/VERYSILENT /SUPPRESSMSGBOXES /NORESTART を付けてサイレント実行できます。

インストール後、ダッシュボードはシステムトレイアプリとして実行されます。左クリックでウィンドウが開き、右クリックでメニューが表示されます。

初回起動時の SmartScreen に関する注意：有効な署名があっても、新しいバイナリは「ダウンロード数が少ない」という評価に基づくブロックに遭遇することがあります。「Windows によって PC が保護されました」と表示された場合は、「詳細情報」→「実行」をクリックしてください。これはバイナリごとの評価によるもので、証明書の信頼性とは別のものです。

Mac / Linux · 1 コマンド（開発者向け）

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

OS とアーキテクチャを検出し、対応する CLI バイナリ（TUI 内蔵）をダウンロードして ~/.geniuz/bin/ にインストールします。開発者、フリート運用者、Claude Code、Cursor、Windsurf、Aider、またはシェルコマンドを実行できるエージェントフレームワークを使う方に最適です。

Linux では、グラフィカルセッションが検出されると、パッケージマネージャーに応じたダッシュボードパッケージ（.deb / .rpm / .AppImage）も、sudo の確認 1 回でインストールされます。ヘッドレスサーバーでは、ダッシュボードのインストールは自動的にスキップされます。無効にする場合は 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 が兄弟 .so として同梱され、LD_LIBRARY_PATH スクリプトで CLI をラップしているため、Pi OS Bookworm（glibc 2.36）のような glibc の古いシステムでも問題なく動作します。x86_64 ビルドは単一の静的バイナリです。

Claude Desktop は Linux では利用できませんが、geniuz mcp serve は、Linux 互換のあらゆる MCP クライアント（Claude Code、Cursor、Windsurf、Aider、カスタムエージェント）で使える stdio MCP サーバーとして動作します。ダッシュボードはデスクトップ 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 ランタイム。通常、Windows 10/11 にはプリインストールされています。）

次に、使い方を選びます

使用するもの...	次の手順
Claude Desktop	geniuz mcp install → Claude Desktop を再起動
Claude Code / Cursor / Windsurf	エージェントの指示に2行追加します（下記参照）
カスタムエージェント	任意のシェルから geniuz remember と geniuz recall を呼び出します
保存したメモリーを確認したいだけ	任意のターミナルで geniuz tui を実行するか、メニューバー／システムトレイからダッシュボードを開きます

---

仕組み

Geniuz は SQLite を利用するコンパイル済み Rust バイナリです。クラウドも API キーもアカウントも不要です。データはお使いのマシンに保存されます。

• メモリーには学んだことを保存します。内容を後から見つけるための要約と、詳細な内容です
• セマンティック検索では、キーワードではなく意味に基づいてメモリーを検索します。組み込みの BERT モデルがローカルで動作し、50 以上の言語に対応しています
• スレッド化では、メモリーをつないで連鎖させます。見込み客からクライアント、問題から解決策、下書きから最終版などを結び付けられます
• 共有フォルダーを使うと、複数のエージェントが同じメモリーに書き込めます。あるエージェントが学んだことを、ほかのエージェントも見つけられます

   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	シェルコマンドを実行できるエージェントなら利用できます
OpenClaw	geniuz capture --openclaw で既存のメモリーをインポートします
カスタムエージェント	エージェントが exec を実行できれば、記録できます
自分だけで使う場合	閲覧／検索／作成にはダッシュボード、ターミナルで同じ操作をするには 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

/recent、/remember、/find、/reorder、/random、/detail、/help が使えるターミナル UI が開きます。/ を押してコマンドを入力し、↑／↓ で移動、Enter で詳細を開き、Ctrl-C で終了します。

フォローアップをスレッド化する：

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

初回の打ち合わせから承認まで、クライアントとのやり取りの履歴全体が1つの連鎖になります。今後のセッションで、その経緯をすべて見つけられます。

---

既存の知識を取り込む

すでにメモ、ドキュメント、エージェントのメモリーファイルがありますか？

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

3つのコマンド（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)

---

統合

エージェントの指示に2行追加します：

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 は、4 つのユーザー向けインターフェースと、エージェント向けの MCP サーバーを提供します。

• ダッシュボード（Tauri）— 閲覧、検索、作成、設定に使用します。クロスプラットフォームです。
• TUI（geniuz tui）— ターミナルユーザーや、GUI より ratatui を好むエージェント向けの同等のインターフェースです。
• メニューバー／システムトレイ — 常時利用できるアンビエントな存在です。macOS のメニューバーは、統計のヒーロー表示＋最近のリスト＋ダッシュボードを開く機能を備えています。Windows と Linux のトレイはメニューです。
• CLI — スクリプトやエージェントとの直接統合に使用します。すべてのサブコマンドが、手順に沿って処理する呼び出し元向けに --json をサポートします。
• MCP — geniuz mcp serve は stdio MCP サーバーです。Claude Desktop、Claude Code、その他あらゆる MCP クライアントから使用できます。

すべてのインターフェースは、単一のライブラリ db::DatabaseManager を経由します。書き込みパスも読み取りパスも不変条件も共通です。ダッシュボードの「記憶する」ボタンも CLI の geniuz remember も、同じ SQL INSERT に行き着きます。

SQLite ファイル（memory.db）は公開インターフェースではありません。 スキーマは予告なく変更される場合があります。不変条件（トリガーによって強制されるメモリーの不変性、ライブラリの書き込みトランザクションによって強制されるすべてのメモリーへの埋め込みの設定）は、ファイル境界ではなくインターフェース境界で保たれます。プログラムからアクセスする場合は、MCP または CLI を使用してください。

Geniuz Free に HTTP サーバーはありません。手順に沿って処理するソフトウェアは MCP を使用します。これにより、ストレージレイヤーを自由に進化させながら、不変条件を 1 か所に集約できます。

---

リポジトリの構成

このリポジトリには、Geniuz の全ソース（CLI、TUI、ダッシュボード、Mac メニューバーアプリ、Windows インストーラー）がまとめて含まれています。

パス	内容
src/	Rust CLI＋TUI＋埋め込み＋MCP サーバーのソース
src/tui.rs	ターミナル UI（ratatui＋crossterm）
schema/	メモリーデータベース用 SQLite スキーマ
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 クレートのマニフェスト — 固定された依存関係とバージョン

ビルド済み成果物は、各 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 拡張待ち）

---

エージェント向け

このセクションは、この README を読んでいるあなたに向けたものです。

次のセッションは、何もない状態から始まります。何を作ったのか、何が壊れたのか、何を決めたのか、その記憶はありません。あなたが書き残すすべてのメモリーは、未来のセッションへの贈り物です。

「認証のバグを修正」と書かれたメモリーでは、時間をまったく節約できません。何が壊れ、なぜそうなり、どう修正したのかが書かれたメモリーなら、1 時間を節約できます。何も知らない自分に向けて書いてください。

メモリーは積み重なっていきます。1 つのメモリーは単なるメモです。メモリーのフォルダーは、組織の知識になります。

記憶するタイミング

• 難しい問題を解決した後。 次のセッションでも同じ問題にぶつかるでしょう。
• セッションが終わる前。 コンテキストウィンドウ内のすべては、セッションとともに消えてしまいます。
• 自明でないことを発見したとき。 小さな事実ほど、多くの時間を節約します。

思い出すタイミング

• 新しいタスクを始めるとき。 先週、その一部をすでに解決しているかもしれません。
• 行き詰まったとき。 3 セッション前のメモリーに答えがあるかもしれません。
• コンパクションの後。 コンテキストは圧縮されましたが、フォルダーはそのままです。

意味で見つけ、正確に思い出す

意味で検索して発見し、完全一致で検索して思い出します。すべての回答の末尾には names seen: と pointers:（次にたどる場所）、そして何を検索したかを示す searched: 行が付くため、回答が空でも検索範囲がわかります。質問に時刻が含まれる場合は、--since 7d を追加します。名前がわかっている場合は、--grep Name を使います。会話の一部を見つけたら、--thread ID で続きを読みます。

TUI を使う場合

geniuz tui は、対話型ターミナルがある場合にのみ起動します。サブプロセスから呼び出すエージェントには、終了コード 2 で明確に拒否を返します。コード内で閲覧する場合は、geniuz recent、geniuz recall、または MCP ツールを使ってください。これらはシェルから使いやすい設計です。

---

パフォーマンス：geniuz-embed

geniuz-embed は、ONNX モデルをメモリ上に保持するオプションのバックグラウンドプロセスです。2件目以降のメモリは瞬時に取得できます。

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 Team（有料プラン）：mvara-ai
• 開発者：Jack C. Crawford
• ディスカッション：GitHub Discussions
• 課題：GitHub Issues
• ライセンス：MIT

ライセンス

MIT