# supragnosis

> supragnosis is an open-source MCP server for knowledge and memory. Local, append-only agent memory that records who said what and keeps conflicts visible. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, CLI, self-hosted
- **Website:** https://supragnosis.dev
- **Repository:** https://github.com/ashon/supragnosis
- **MCP Registry name:** io.github.Ashon/supragnosis
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-15

## About

Instead of storing facts as flat truths, supragnosis stores assertions: which host noted something, for whom, from what source, when and with what confidence. A deterministic projector turns the log into a graph of entities and relations, so deleting the graph and replaying the log rebuilds the same result on any machine. Entries are never edited, only superseded.

When two agents give one thing different types, both versions stay and the conflict waits for a human. Merges, trust promotions and schema changes arrive as proposals you accept or reject on a Review page, and a merge can be reversed. Credential-shaped text is refused at ingest.

It runs as one Rust binary with an embedded store and no account, serving MCP on a local port plus a desktop viewer. A second machine can join a hub with a one-time invite code and sync workspace by workspace, with each machine verifying signatures. Workspaces leave a machine only if you list them. The README names Claude Code, Codex, Cursor, VS Code, Gemini and opencode as connectable clients.

## Features

- **Provenance on claims:** Each entry keeps host, principal, source, time, confidence and a locally computed trust tier.
- **Visible conflicts:** Contradicting assertions coexist until you settle them.
- **Review gate:** Merges and trust changes go through proposals with a computed diff.
- **Append-only log:** Corrections are new entries and merges can be undone.
- **Opt-in sync:** Machines sync per workspace and verify every signature.
- **Secret refusal:** Credential-shaped text is rejected at ingest.

## Good for

- Share project memory between a few teammates without a vendor cloud
- Trace where an agent's remembered claim came from
- Resolve disagreeing agent notes
- Keep coding-agent decisions across machines

## Install

### Claude Code (Terminal)

```sh
claude mcp add supragnosis -- docker run -i --rm ghcr.io/ashon/supragnosis:0.11.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "supragnosis": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ashon/supragnosis:0.11.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "supragnosis": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ashon/supragnosis:0.11.0"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "supragnosis": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ashon/supragnosis:0.11.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "supragnosis": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ashon/supragnosis:0.11.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "supragnosis": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ashon/supragnosis:0.11.0"
      ]
    }
  }
}
```

## Tools

- `observe`: Record a note with optional entities and structure
- `search_knowledge`: Hybrid search over stored knowledge
- `get_entity`: Read an entity and the entries behind it

## FAQ

### Does it need an account?

No. It is a single local binary with an embedded store.

### Which platforms does it run on?

macOS on Apple silicon and Linux with glibc 2.39 or newer, per the site.

### What licence?

MIT or Apache-2.0.

### Which clients can connect?

Claude Code, Claude Desktop, Cursor, VS Code, Codex, Gemini and opencode via supragnosis connect.

### Is supragnosis free?

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

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

Run this command in your terminal: claude mcp add supragnosis -- docker run -i --rm ghcr.io/ashon/supragnosis:0.11.0

### What are the best alternatives to supragnosis?

The closest alternatives to supragnosis 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.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

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