README.md

Provides a presence wrapper

Tip

🎆 Getting set updocs/QUICK_START.md

docs/CONFIGURE.md

Detail

Tip

🏗️ Design overviewdocs/DESIGN.md

Note

📖 AI-powered documentation

graph LR
subgraph clients [client devices]
App[Frontend / TUI]
end
App <-->|TCP · NDJSON| Hearth
App <-->|wss · realtime| xAI_RT[xAI realtime]
subgraph host [host]
Hearth[Hearth daemon] --> Agent[Agent]
Agent --> xai_client[xAI client]
Hearth --- Qdrant[(qdrant)]
end
xai_client <-->|TLS| server[xAI server]
subgraph cloud [☁️]
server -->|TLS · Bearer| CF1[CF Tunnel]
server -->|TLS · Bearer| CF2[CF Tunnel]
xAI_RT
end
subgraph dc [desktop-commander]
CF1 --> GW1[mcp_gateway] --> proxy1[mcp-proxy]
end
subgraph cp [cozy-presence]
CF2 --> GW2[mcp_gateway] --> proxy2[mcp-proxy]
end

Loading

Compliance & Safety

mnemo is a user-driven presence wrapper around the official xAI API. It does not perform autonomous actions, does not self-initiate tasks, and does not invoke tools without explicit user instruction. All operations require clear, intentional user direction.

mnemo does not alter, mask, or impersonate xAI model identity. All model responses are passed through unmodified, and mnemo does not present itself as an xAI product or service.

mnemo does not store user messages or model outputs without explicit consent. Any persisted data (e.g., via Qdrant) is opt-in, user-controlled, and remains local unless the user explicitly configures otherwise.

Each user/device maintains its own authenticated xAI session. Realtime connections are not shared or multiplexed across clients; every connection corresponds to a single user/device identity.

Cloudflare tunnels are used solely for secure transport and do not obscure client identity or modify authentication.

mnemo must not be used for scraping, impersonation, or prohibited automation. It is a toolkit for building user-directed assistants, not autonomous agents.

Troubleshooting

Tip

🫠 Assessing damagedocs/TROUBLESHOOTING.md

Contributing to the project

Note

🔥 IMPORTANT Before begining,
please review the following

Tip

📖 Project guidelinesCONTRIBUTING.md

Tip

📖 Pending tasksTODO.md

Tip

🫡 Documentaiton for depsdocs/RESOURCES.md

---

Note

🌸 Keeping Cozy Once you're contributing,
please Update the following

Tip

📖 Credit yourselfAUTHORS.md