_{Actual footage. Not a mockup.}

Jarvis Orb — Persistent Memory MCP Server + AI Brain Visualizer

Not a tool. A presence.

It remembers your decisions. It tracks your world. It glows on your desktop, alive.

Website · Download · Report Bug

English | 한국어

The Problem

Every session, your AI starts over. Your decisions, your preferences, your project context — gone. You explain yourself again. And again. And again.

• "We decided to use SQLite." → Three days later, it suggests PostgreSQL.
• "This PR was merged yesterday." → It doesn't know. It never remembers state.
• "What was the architecture decision?" → Gone. The session ended.

The Solution

Jarvis Orb gives your AI a persistent brain and shows its thought process as a living orb on your desktop.

Install

macOS (Apple Silicon) / Linux:

curl -fsSL https://raw.githubusercontent.com/thestack-ai/jarvis-orb/main/install.sh | bash

Requires Apple Silicon (M1/M2/M3/M4). Use the terminal command above for the smoothest install experience.

Windows (PowerShell):

irm https://raw.githubusercontent.com/thestack-ai/jarvis-orb/main/install.ps1 | iex

That's it. Brain starts. Orb floats. Claude Code connects.

Verify your install:

jarvis-orb --doctor

Supported Platforms

Cursor / Windsurf Setup

Add to your MCP config (~/.cursor/mcp.json or equivalent):

{
  "mcpServers": {
    "jarvis-brain": {
      "command": "python3",
      "args": ["-m", "jarvis_brain.mcp_server"],
      "env": {
        "PYTHONPATH": "~/.jarvis-orb/lib:~/.jarvis-orb"
      }
    }
  }
}

Uninstall

# Remove Brain + data
rm -rf ~/.jarvis-orb

# Remove from Claude Code
claude mcp remove jarvis-brain

# Remove Orb app (macOS)
rm -rf "/Applications/Jarvis Orb.app"

# Remove PATH entry from ~/.zshrc or ~/.bashrc
# Delete the line: export PATH="$HOME/.jarvis-orb/bin:$PATH"

Brain Lite

Watch it think.

MCP Tools

memory_save      Save a memory (auto-classified into 4 tiers)
memory_search    Search with temporal scoring + contradiction filtering
memory_verify    Mark memories as verified, superseded, or contradicted
entity_create    Track a project, person, decision, or tool
entity_update    Update entity state (records transition history)
entity_query     Query entities by type or name
entity_relate    Create relationships between entities

Works with Claude Code, Cursor, and any MCP-compatible tool.

Orb

Every thought, visible.

The orb is not decorative. It shows you what the brain is doing, in real time.

3MB desktop app. Always-on-top. Draggable. Click to see logs.

In Practice

Monday morning standup — "What did we work on last week?" Brain searches episodic memories with temporal scoring. Returns a ranked summary. No digging through chat history.

Mid-project contradiction — "We should use Redis for caching." Brain detects this contradicts a previous decision. Flags the conflict. The orb pulses red. You see it happening.

New session, no context loss — "Continue where we left off." Brain loads project state, recent decisions, and your preferences. No re-explaining.

Architecture

Claude Code / Cursor
     ↕  MCP (stdio)
Brain Lite  —  Python · aiosqlite · FTS5 · ~/.jarvis-orb/brain.db
     ↕  WebSocket
Orb  —  Tauri · Three.js · WebGL · 3MB · Always-on-top

Origin

Jarvis Orb was extracted from a working AI control plane — Jarvis — running 19 modules, a knowledge graph with 100+ entities, 500+ memories, and 22 agent teams. This is the lightweight, open-source version of that brain.

"I built a personal AI operating system. After months of using it, I realized the core — the brain and the visualization — should be available to everyone."

Roadmap

• Orb Customization — Custom orb skins, color themes, animation profiles
• Brain Pro — Advanced memory with full knowledge graph, multi-model routing, autonomous reasoning loop
• Auto-update — Seamless in-app updates
• Plugin System — Extend Brain with custom MCP tools

Contributing

PRs welcome. See CONTRIBUTING.md.

git clone https://github.com/thestack-ai/jarvis-orb.git
cd jarvis-orb

# Brain
cd brain && uv venv .venv && source .venv/bin/activate
uv pip install aiosqlite websockets mcp pytest pytest-asyncio
python -m pytest tests/ -v

# Orb
cd ../orb && pnpm install && pnpm tauri dev

License

MIT