TheStack-ai/jarvis-orb

# 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:
bash
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):
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:
bash
jarvis-orb --doctor
### Supported 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):
json
"mcpServers": {
"jarvis-brain": {
"command": "python3",
"args": ["-m", "jarvisbrain.mcpserver"],
"env": {
"PYTHONPATH": "~/.jarvis-orb/lib:~/.jarvis-orb"
### Uninstall
bash
# 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
memorysave Save a memory (auto-classified into 4 tiers)
memorysearch Search with temporal scoring + contradiction filtering
memoryverify Mark memories as verified, superseded, or contradicted