Map

The parts of Geniuz and how they connect. There is no server: each part opens the same files, and everything stays on your computer.

Surfaces

The ways in, for you and for your AI.

Dashboard

The desktop app. Browse, keep and find across your folders, pin the ones you use most, and change your shortcuts.

Guardrail

A window stays with the folder it shows, so a draft can't land somewhere else.

Calls

Folders lists, switches and pins
Library app commands

Source

desktop/dashboard

Menubar

The folder in use, a way to switch, and your recent memories, always one click away. A tray menu on Windows and Linux.

Guardrail

The Mac menubar only ever reads your memories.

Calls

CLI asks which folder is in use
Store read-only SQL

Source

desktop/Geniuz, src/tray.rs

MCP

How your AI reaches Geniuz: keep, recall and folders, plus guidance on when to use them.

Guardrail

A wrong folder name is an error, never a different folder.

Calls

Folders finds the folder for each call
Library tool calls

Source

src/mcp.rs

CLI

Every command, for people, scripts and agents.

Guardrail

capture refuses files that are not prose unless you pass --force.

Calls

Folders finds the folder for each command
Library all commands

Called by

Menubar asks which folder is in use

Source

src/cli.rs, src/main.rs

Terminal UI

Browse and compose in a terminal.

Guardrail

Refuses to start without a real terminal.

Calls

Library browse and compose

Source

src/tui.rs

Core

Where memories are kept and found.

Folders

Finds, moves, pins and archives folders, and decides which one a command uses.

Guardrail

A duplicate is refused, and nothing is ever deleted.

Calls

Store reads identity without changing anything

Called by

Dashboard lists, switches and pins
MCP finds the folder for each call
CLI finds the folder for each command

Source

src/folders.rs

Library

Reads, writes and every kind of search.

Guardrail

An ambiguous ID prefix is an error, never a guess.

Calls

Store transactional writes
Embedding embeds text

Called by

Dashboard app commands
MCP tool calls
CLI all commands
Terminal UI browse and compose

Source

src/db.rs, src/dig.rs, src/window.rs

Store

One SQLite file per folder. Tables: memories, memory_embeddings, embedding_meta, _meta. View: memory_chains.

Guardrail

Triggers refuse update, delete and replace on memories.

Called by

Menubar read-only SQL
Folders reads identity without changing anything
Library transactional writes

Source

schema/schema.sql

Embedding

Turns text into numbers that capture its meaning, with ONNX or Ollama.

Guardrail

Rejects stored embeddings of the wrong size when reading them.

Calls

Embed helper socket first
Hugging Face model download
Ollama as a fallback

Called by

Library embeds text

Source

src/embedding.rs

Embed helper

Keeps the model ready between calls.

Guardrail

Local socket only. Exits after five idle minutes.

Called by

Embedding socket first

Source

src/embed_server.rs, src/embed_client.rs

Outside

Reached only when needed, and never with your memories by default.

Hugging Face

Where the model is downloaded from.

Guardrail

Once, then local.

Called by

Embedding model download

Source

src/embedding.rs

Ollama

A second way to embed, by default on your own machine.

Guardrail

Used only if the built-in model fails to load.

Called by

Embedding as a fallback

Source

src/embedding.rs