# OpenReflex

> OpenReflex is an open-source MCP server for developer tools. Local project memory for coding agents that suggests paths and flags stalled work. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Website:** https://openreflex.cc
- **Repository:** https://github.com/vishnu-77/openreflex
- **MCP Registry name:** io.github.vishnu-77/openreflex
- **Categories:** developer tools, AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

This is the optional diagnostics side of OpenReflex. The plugin itself works through lifecycle hooks in Claude Code, Codex, Cursor and OpenCode, so the model does not need to call it. The MCP server exists for inspecting what the memory has learned without loading it into normal agent context.

The README describes how it works: hooks record how tasks go, repeated behaviour is compiled into project-scoped procedures called Reflexes, and relevant ones are injected into new tasks. A path check only names a better approach when comparable past tasks back it up. It raises a single alert when it sees repeated failing commands, identical retries or stalled progress, suggesting whether to continue, pivot or stop.

Data stays in a local SQLite database, with no account or hosted service. Only coarse project-relative metadata is stored, never file contents, commands, tool output or transcripts, and capture stays off until you approve a project. It needs Python 3.11 or newer.

## Features

- **Ambient project memory:** Hooks record how work went and reuse it in later tasks without the model asking.
- **Path recommendations:** Compares past approaches by success, time, tool calls and context cost.
- **Continue, pivot or stop:** Raises one alert on loops, stalled progress or runaway context.
- **Local only storage:** Keeps a SQLite database on your machine with no account.
- **Opt-in per project:** Capture stays off until you approve each project.
- **Diagnostics over MCP:** Optional server for inspecting memory without bloating agent context.

## Good for

- Stop an agent re-reading the same files and retrying failing commands
- Reuse the approach that worked for a similar past bug
- Preview the context a new task would receive
- Inspect what OpenReflex has learned about a project

## Install

### Claude Code (Terminal)

```sh
claude mcp add openreflex -- uvx openreflex
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "openreflex": {
      "command": "uvx",
      "args": [
        "openreflex"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "openreflex": {
      "command": "uvx",
      "args": [
        "openreflex"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "openreflex": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "openreflex"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "openreflex": {
      "command": "uvx",
      "args": [
        "openreflex"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "openreflex": {
      "command": "uvx",
      "args": [
        "openreflex"
      ]
    }
  }
}
```

## FAQ

### Does it read my files or transcripts?

No. The README says only coarse, project-relative metadata is stored, never contents, commands, tool output or transcripts.

### Which agents does it support?

Claude Code, Codex, Cursor and OpenCode.

### What does it need?

Python 3.11 or newer, installed through the Claude plugin or pipx or uv.

### Is it free?

Yes, it is MIT licensed.

### Is OpenReflex free?

Yes. OpenReflex is open source, so you can use and self-host it for free.

### How do I add OpenReflex to Claude Code?

Run this command in your terminal: claude mcp add openreflex -- uvx openreflex

### What are the best alternatives to OpenReflex?

The closest alternatives to OpenReflex are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/openreflex
