AI Assistants and Developers

Geniuz is memory for AI agents. It runs on the user's own computer, and agents reach it over MCP or the command line. There is no account, API key or hosted service.

Want your AI to set it up? Paste this to it:

Install Geniuz so you can remember things across our conversations. Read https://geniuz.life/developers.md first, tell me what you'll run, and ask before you run it.

How agents use it

Geniuz works best when an agent checks its memory at the start of a conversation, and saves what a future session would need and could not get from the files: decisions and why, people, preferences, constraints.

A memory can't be moved or removed afterwards, so a folder is chosen first, and its description may say what belongs there. Passwords and other secrets don't belong in memory.

Installing changes the user's computer, so it's the user's decision.

Install

On Linux, or for the command line on a Mac:

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

This installs to ~/.geniuz/bin/. For the desktop app, use Geniuz.dmg on a Mac or Geniuz-Setup.exe on Windows. The first memory downloads a small model, about 130 MB, that runs locally.

Connect over MCP

For Claude Desktop, run geniuz mcp install and restart it. For any other MCP client, add this stdio server, using the full path to geniuz if it isn't on the client's PATH:

{
  "mcpServers": {
    "geniuz": {
      "command": "geniuz",
      "args": ["mcp", "serve"]
    }
  }
}

Tool	What it does	Arguments
`keep`	Saves a memory	`content` and `gist` required. `folder`, `thread`
`recall`	Finds memories. With no query, the newest. An address in `query` opens that memory	`query`, `folder`, `all`, `grep`, `thread`, `full`, `limit`, `since`, `until`
`folders`	Lists folders and their descriptions, and creates new ones	`name`, to read one in full

The server also tells a connecting agent when to use these, so most clients need no further instructions.

Or use the command line

Anything that can run a command can use Geniuz. Every command takes --in <folder>, and --json where it returns results.

geniuz keep -c "what happened and why" -g "category: short summary"
geniuz keep --in Work -c @notes.md -g "session: review"
geniuz recall                         # the newest memories
geniuz recall "topic"                 # by meaning
geniuz recall --grep Acme --since 7d  # exact words
geniuz recall --all "topic"           # every folder
geniuz recall 13625F6B:3487B9B0       # open an address
geniuz folder list
geniuz skill                          # the full guide for agents

What there isn't

Geniuz has no HTTP API, hosted MCP server or remote access. Your memories stay on your computer, so there's nothing for a site to serve. The schema is public: read it and borrow it, and write through Geniuz, which keeps embeddings and identity right.

Machine-readable versions

Every page has a Markdown version: add .md to its address, such as /developers.md or /wiki/using-it.md. A request with Accept: text/markdown gets it at the page's own address.
/llms.txt is the summary and /llms-full.txt is everything on one page. There's also a sitemap.
The source and issues are on GitHub. All the agent guidance is in the skill guide.