MundoX OS

An AI operating system that gives any AI model persistent memory, a knowledge graph, and intelligent context management. MundoX OS sits between you and your AI — it remembers everything, learns over time, and never loses context.

Built for Buy Box Club members.

What is MundoX OS?

MundoX OS is not a chatbot. It's an operating system layer that makes any AI model smarter by giving it capabilities no single model has on its own:

• Persistent memory — Every conversation is stored permanently. Nothing is ever lost or forgotten, even across sessions.
• Knowledge graph — Automatically extracts and connects people, properties, deals, facts, and relationships from your conversations. Recalls them when relevant.
• Lossless context management — When conversations get long, older messages are intelligently summarized while originals stay fully searchable. You get unlimited conversation length without losing detail.
• Intelligent model routing — Automatically picks the best AI model for each question (CRE domain knowledge, complex reasoning, code, vision) instead of forcing everything through one model.
• Full-text search — Instantly search across every conversation you've ever had.
• Security scanning — All inputs scanned for injection attacks and data protection.

Install

Open Terminal (Mac) or PowerShell (Windows) and run these two commands:

npm install -g mundox-os
deal setup

That's it. deal setup opens your browser where you paste your API key. It also auto-configures Claude Code so MundoX tools appear automatically.

What's Terminal? On Mac, press Cmd + Space, type "Terminal", and hit Enter. On Windows, search "PowerShell" in the Start menu.

Don't have an API key? Log in to your Buy Box Club dashboard and look for "API Keys" in your account settings.

Need Node.js? MundoX requires Node.js 22+. Install it from nodejs.org if you don't have it.

3 Ways to Use MundoX OS

The installer configures all three automatically. All three share the same memory, knowledge graph, and search — a deal analyzed in Terminal is remembered in Claude Code and vice versa.

1. Terminal

Open Terminal anytime and type:

deal

MundoX OS runs locally with the full engine — persistent memory, knowledge graph, model routing, and context management. Every conversation is stored, facts are extracted, and the system gets smarter the more you use it.

• "Analyze the deal at 123 Main St — 10 units, asking $2.5M, NOI $180K"
• "What cap rate did we discuss for the Phoenix property last month?"
• "Compare my last 3 deals by cash-on-cash return"

Type exit or press Ctrl+C to end a session.

2. Claude Code

The installer automatically adds MundoX OS as an MCP server in Claude Code. Open Claude Code and use it normally — Claude now has access to MundoX OS's full memory and knowledge system as tools it can call.

What this means in practice:

• Claude remembers past sessions — it can search your conversation history and recall facts you discussed weeks ago
• Claude knows your deals — the knowledge graph tracks properties, people, numbers, and relationships across all your interactions
• Claude has context — no more re-explaining your situation every time you start a new session

3. Discord / Telegram

Connect MundoX OS to your community channels so members can interact with it directly:

deal connect

Follow the prompts to add your Discord bot token or Telegram bot token. The bot runs MundoX OS's full engine — same persistent memory, same knowledge graph, same intelligence.

Commands Reference

| Command | What it does | |---------|-------------| | deal | Start a conversation with MundoX | | deal setup | Open the setup wizard in your browser | | deal connect | Connect Discord or Telegram | | deal doctor | Check if everything is configured correctly | | deal stats | See your usage statistics | | deal gateway | Start the API server (advanced) |

Useful first commands

# Check that everything is working
deal doctor

# See your usage so far
deal stats

How Memory Works

MundoX has three layers of memory:

1. Conversation history — Every message is saved permanently. When conversations get long, older messages are automatically summarized (but the originals are always searchable).

2. Knowledge graph — MundoX extracts facts, people, properties, and relationships from your conversations. It can recall these across different chat sessions.

3. Daily notes — Key events and decisions are logged by date for easy lookback.

You don't need to do anything special — memory works automatically. MundoX gets better the more you use it.

FAQ

Where is my data stored? Everything is stored locally on your computer at ~/.mundox/. Your conversations never leave your machine unless you explicitly use the gateway server.

Can I use MundoX from my phone? Not directly, but you can connect it to Discord or Telegram using the gateway server. Run deal gateway and configure your preferred messaging channel.

How do I update MundoX? Run the install command again — it always installs the latest version.

How do I uninstall MundoX? Run npm uninstall -g mundox-os in Terminal. Your data at ~/.mundox/ is preserved. Delete that folder manually if you want a clean removal.

Something isn't working Run deal doctor — it checks your configuration, API keys, database health, and search capabilities, then tells you exactly what's wrong.

For Developers

Architecture

• LCM (Lossless Context Management) — SQLite-backed persistent memory with DAG-based compaction and FTS5 full-text search
• Knowledge Graph — Three-layer system: entities/facts/edges, daily notes, tacit knowledge with retrieval cascade
• Model Router — Task-based routing to the best model per request (domain, code, reasoning, vision)
• Permission Engine — 4-tier tool permission system (safe/moderate/risky/dangerous) with channel-aware escalation
• InputGuard — Security scanning for prompt injection, credential access, and destructive operations
• MCP Server — Model Context Protocol server exposing 9 tools for external AI clients

Local Development

git clone https://github.com/munsanco13/mundoXOS.git
cd mundoXOS
npm install
npm run dev          # Dev mode with hot reload
npm run typecheck    # TypeScript strict check
npm run test:run     # Run tests (167 passing)
npm run build        # Production build

Configuration

Config is stored at ~/.mundox/config.json with owner-only permissions.

| Field | Description | Default | |-------|-------------|---------| | apiKey | Your MundoX API key | — | | name | How MundoX addresses you | "MundoX" | | dataDir | Where data is stored | ~/.mundox |

Gateway Server

Self-host the API for team or multi-client access:

deal gateway

Configure in ~/.mundox/config.json:

{
  "gateway": {
    "port": 18789,
    "host": "127.0.0.1",
    "token": "your-secret-token"
  }
}

Headless Mode

Run tasks non-interactively for automation and scripting:

deal headless --task "Analyze the deal at 123 Main St"
deal headless --file task.txt
echo "Underwrite this property" | deal headless
deal headless --task "..." --json          # JSON output
deal headless --task "..." --max-turns 100 # Custom limits

Security

• API keys stored locally with restricted file permissions (chmod 600)
• Setup server runs on localhost only with CSRF protection
• Gateway uses timing-safe token comparison
• All inputs scanned for injection patterns
• Request body validation and size limits

License

MIT