Jarvis Orb MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
git clone https://github.com/whynowlab/jarvis-orb
cd jarvis-orb

Then follow the repository README for any remaining dependency or build steps before continuing.

2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add -e "PYTHONPATH=${PYTHONPATH}" jarvis-orb -- node "<FULL_PATH_TO_JARVIS_ORB>/dist/index.js"

Replace <FULL_PATH_TO_JARVIS_ORB>/dist/index.js with the actual folder you prepared in step 1.

Required:PYTHONPATH
README.md

Persistent 4-tier AI memory with real-time desktop visualization

Actual footage. Not a mockup.

Jarvis Orb

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/whynowlab/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/whynowlab/jarvis-orb/main/install.ps1 | iex

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

Verify your install:

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):

{
  "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 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.

Brain Event Orb Response
Memory saved Particles absorb into or

Tools (7)

memory_saveSave a memory auto-classified into 4 tiers
memory_searchSearch with temporal scoring and contradiction filtering
memory_verifyMark memories as verified, superseded, or contradicted
entity_createTrack a project, person, decision, or tool
entity_updateUpdate entity state and record transition history
entity_queryQuery entities by type or name
entity_relateCreate relationships between entities

Environment Variables

PYTHONPATHrequiredPath to the jarvis-orb library and configuration directory

Configuration

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

Try it

Save the decision that we are using SQLite for the current project.
Search my memory for recent architecture decisions regarding the database.
Update the status of the current PR to merged and record the transition.
Create a new entity for the project lead and relate them to the current task.

Frequently Asked Questions

What are the key features of Jarvis Orb?

4-Tier Memory system (episodic, semantic, project, procedural). Temporal scoring with 30-day half-life decay. Automatic contradiction detection and filtering. Entity tracking with full state transition history. Real-time desktop orb visualization of AI thought processes.

What can I use Jarvis Orb for?

Maintaining project context across multiple AI chat sessions. Tracking architecture decisions to prevent conflicting suggestions. Managing complex project state and PR transition history. Building a lightweight knowledge graph of project entities and relationships.

How do I install Jarvis Orb?

Install Jarvis Orb by running: curl -fsSL https://raw.githubusercontent.com/whynowlab/jarvis-orb/main/install.sh | bash

What MCP clients work with Jarvis Orb?

Jarvis Orb works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Jarvis Orb docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare