Jarvis Orb is a persistent memory MCP server that gives AI tools long-term memory across sessions, with a desktop orb that visualizes thought processes in real time.
Memory Management
Save memories — Store information across 4 tiers (episodic, semantic, project, procedural) with optional tags, source, and project context
Search memories — Full-text search (FTS5) with temporal scoring that prioritizes recent memories using a 30-day half-life decay, plus contradiction filtering
Verify/manage memories — Mark memories as verified, superseded (replacing old with new), or contradicted (flagging conflicts), keeping the knowledge base accurate
Entity Tracking
Create entities — Track structured objects (people, projects, decisions, tools) with an initial state
Update entity state — Modify state while automatically recording the full transition history with an optional reason
Query entities — Look up entities by type, name, or both to retrieve current state and history
Relate entities — Define subject–predicate–object relationships between entities to build a lightweight knowledge graph
Integration & Visualization
Works with MCP-compatible tools like Claude Code, Cursor, and Windsurf
Desktop orb visualizes real-time brain activity in response to memory operations, searches, contradictions, and entity changes
Maintains persistent context across sessions, eliminating the need to re-explain decisions, preferences, and project context
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.
Without Jarvis Orb | With Jarvis Orb | |
Context | Every session starts from zero | Carries over automatically |
Decisions | Reversed decisions come back | Contradictions detected and filtered |
State | "What's the status?" → guess | Exact state + transition history |
Visibility | No idea what it's thinking | Every thought, live on your screen |
Install
macOS (Apple Silicon) / Linux:
curl -fsSL https://raw.githubusercontent.com/thestack-ai/jarvis-orb/main/install.sh | bashRequires 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 | iexThat's it. Brain starts. Orb floats. Claude Code connects.
Verify your install:
jarvis-orb --doctorSupported Platforms
Platform | Brain (MCP) | Orb (Desktop) |
macOS Apple Silicon (M1+) | Yes | Yes |
macOS Intel | Yes | Yes |
Windows x64 | Yes | Yes |
Linux | Yes | Not yet |
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.
# | Feature | Description |
01 | 4-Tier Memory | Episodic, semantic, project, procedural — auto-classified and ranked by recency |
02 | Temporal Scoring | 30-day half-life decay. Recent memories surface first. Old context fades naturally |
03 | Contradiction Detection | Conflicting memories flagged. Superseded decisions marked stale. Only truth surfaces |
04 | Entity Tracking | Projects, PRs, decisions tracked as objects with full state transition history |
05 | Relationship Storage | People → projects → decisions connected as a lightweight knowledge graph |
06 | FTS5 Search | Full-text search across all memories with observation filtering |
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 entitiesWorks 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.
Brain Event | Orb Response |
Memory saved | Particles absorb into orb |
Contradiction detected | Red/orange pulse wave |
Entity state changed | Cyan flash + scale pulse |
Search executed | Violet color shift |
Context compressed | Shrink, brighten, expand |
Team dispatched | Orb splits into sub-orbs |
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-top3MB | App size. Not 150MB. |
7 | MCP tools. Memory, entities, search. |
0 | Cloud dependencies. Everything local. |
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 devLicense
MIT
Your AI will start remembering.