HyperFocache 🧠⚡

Your External Brain, Amplified - An ADHD-optimized memory augmentation system for developers who leverage hyperfocus as a superpower.

Table of Contents

• Overview
• Key Features
• Installation
  • Requirements
  • Cursor
  • Windsurf
  • Claude Desktop
  • Claude Code
  • VS Code
  • Visual Studio 2022
  • Zed
  • Cline
  • Trae
  • Gemini CLI
  • BoltAI
  • Augment Code
  • Roo Code
  • Zencoder
  • Amazon Q Developer CLI
  • Qodo Gen
  • JetBrains AI Assistant
  • Warp
  • Opencode
  • Copilot Coding Agent
  • Kiro
  • LM Studio
  • Perplexity Desktop
  • Smithery
  • Docker
  • Windows
• Feedback & Support
• Getting Started
• About

Overview

HyperFocache is a high-performance cognitive tool designed specifically for developers with ADHD. It provides seamless memory management and retrieval, helping you maintain context across interruptions, track your problem-solving journeys, and build a searchable knowledge base that grows with you.

Key Features

• 20+ Memory Tools: Comprehensive suite for saving, searching, evolving, and organizing memories
• Semantic Search: Find memories by meaning, not just keywords
• Context Preservation: Save and restore work states when switching tasks or getting interrupted
• Problem-Solving Breadcrumbs: Track your debugging journeys, including dead ends and breakthroughs
• Memory Evolution: Update existing memories without losing history
• Intelligent Consolidation: Automatically merge related memories to reduce clutter
• Time-Based Retrieval: Navigate your memory timeline effortlessly
• Relationship Mapping: Visualize connections between memories
• ADHD-Optimized: Built by and for developers with ADHD

Installation

Requirements

• Node.js >= v18.0.0 (for local installations)
• Cursor, Windsurf, Claude Desktop, or another MCP Client

Note: HyperFocache is entirely remote-based, so most installations will use the remote server endpoints. For Docker-based installations, you'll need the mcp-remote fork with Docker support.

Cursor

Install in Cursor

Go to: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Since Cursor 1.0, you can use one-click installation or paste the configuration into your ~/.cursor/mcp.json file.

Remote Server Connection (Recommended)

{
  "mcpServers": {
    "hyperfocache": {
      "url": "https://hyperfocache.offendingcommit.com/mcp"
    }
  }
}

Docker-based Connection (Alternative)

{
  "mcpServers": {
    "hyperfocache": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-auth:/home/mcp/.mcp-auth",
        "ghcr.io/offendingcommit/mcp-remote:latest",
        "https://hyperfocache.offendingcommit.com/sse"
      ]
    }
  }
}

Windsurf

Install in Windsurf

Add this to your Windsurf MCP config file. See Windsurf MCP docs for more info.

Remote Server Connection (Recommended)

{
  "mcpServers": {
    "hyperfocache": {
      "serverUrl": "https://hyperfocache.offendingcommit.com/sse"
    }
  }
}

Docker-based Connection (Alternative)

{
  "mcpServers": {
    "hyperfocache": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-auth:/home/mcp/.mcp-auth",
        "ghcr.io/offendingcommit/mcp-remote:latest",
        "https://hyperfocache.offendingcommit.com/sse"
      ]
    }
  }
}

Claude Desktop

Install in Claude Desktop

Add this to your Claude Desktop claude_desktop_config.json file. See Claude Desktop MCP docs for more info.

Since Claude Desktop primarily supports stdio connections, you'll need to use the Docker-based mcp-remote fork:

{
  "mcpServers": {
    "hyperfocache": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-auth:/home/mcp/.mcp-auth",
        "ghcr.io/offendingcommit/mcp-remote:latest",
        "https://hyperfocache.offendingcommit.com/sse"
      ]
    }
  }
}

Claude Code

Install in Claude Code

Run this command. See Claude Code MCP docs for more info.

Remote Server Connection (Recommended)

claude mcp add --transport http hyperfocache https://hyperfocache.offendingcommit.com/mcp

Or using SSE transport:

claude mcp add --transport sse hyperfocache https://hyperfocache.offendingcommit.com/sse

Docker-based Connection (Alternative)

claude mcp add hyperfocache -- docker run -i --rm -v mcp-auth:/home/mcp/.mcp-auth ghcr.io/offendingcommit/mcp-remote:latest https://hyperfocache.offendingcommit.com/sse

VS Code

Install in VS Code

Add this to your VS Code MCP config file. See VS Code MCP docs for more info.

Remote Server Connection (Recommended)

"mcp": {
  "servers": {
    "hyperfocache": {
      "type": "http",
      "url": "https://hyperfocache.offendingcommit.com/mcp"
    }
  }
}

Docker-based Connection (Alternative)

"mcp": {
  "servers": {
    "hyperfocache": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-auth:/home/mcp/.mcp-auth",
        "ghcr.io/offendingcommit/mcp-remote:latest",
        "https://hyperfocache.offendingcommit.com/sse"
      ]
    }
  }
}

Visual Studio 2022

Install in Visual Studio 2022

Follow the Visual Studio MCP Servers documentation.

Add this to your Visual Studio MCP config file:

{
  "mcp": {
    "servers": {
      "hyperfocache": {
        "type": "http",
        "url": "https://hyperfocache.offendingcommit.com/mcp"
      }
    }
  }
}

Zed

Install in Zed

Add this to your Zed settings.json. See Zed Context Server docs for more info.

{
  "context_servers": {
    "hyperfocache": {
      "command": {
        "path": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-v",
          "mcp-auth:/home/mcp/.mcp-auth",
          "ghcr.io/offendingcommit/mcp-remote:latest",
          "https://hyperfocache.offendingcommit.com/sse"
        ]
      },
      "settings": {}
    }
  }
}

Cline

Install in Cline

Add this to your Cline MCP settings:

{
  "mcpServers": {
    "hyperfocache": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-auth:/home/mcp/.mcp-auth",
        "ghcr.io/offendingcommit/mcp-remote:latest",
        "https://hyperfocache.offendingcommit.com/sse"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Trae

Install in Trae

Use the Add manually feature and fill in the JSON configuration. For more details, visit the Trae documentation.

Remote Server Connection (Recommended)

{
  "mcpServers": {
    "hyperfocache": {
      "url": "https://hyperfocache.offendingcommit.com/mcp"
    }
  }
}

Docker-based Connection (Alternative)

{
  "mcpServers": {
    "hyperfocache": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-auth:/home/mcp/.mcp-auth",
        "ghcr.io/offendingcommit/mcp-remote:latest",
        "https://hyperfocache.offendingcommit.com/sse"
      ]
    }
  }
}

Gemini CLI

Install in Gemini CLI

See Gemini CLI Configuration for details.

1. Open the Gemini CLI settings file at ~/.gemini/settings.json
2. Add the following to the mcpServers object:

{
  "mcpServers": {
    "hyperfocache": {
      "httpUrl": "https://hyperfocache.offendingcommit.com/mcp"
    }
  }
}

BoltAI

Install in BoltAI

Open the "Settings" page, navigate to "Plugins," and enter:

{
  "mcpServers": {
    "hyperfocache": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-auth:/home/mcp/.mcp-auth",
        "ghcr.io/offendingcommit/mcp-remote:latest",
        "https://hyperfocache.offendingcommit.com/sse"
      ]
    }
  }
}

More information available on BoltAI's Documentation site.

Augment Code

Install in Augment Code

Using the Augment Code UI

1. Click the hamburger menu
2. Select Settings
3. Navigate to the Tools section
4. Click the + Add MCP button
5. Enter the following command:

   docker run -i --rm -v mcp-auth:/home/mcp/.mcp-auth ghcr.io/offendingcommit/mcp-remote:latest https://hyperfocache.offendingcommit.com/sse
   

6. Name the MCP: HyperFocache
7. Click the Add button

Manual Configuration

Add to your settings.json:

"augment.advanced": {
  "mcpServers": [
    {
      "name": "hyperfocache",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-auth:/home/mcp/.mcp-auth",
        "ghcr.io/offendingcommit/mcp-remote:latest",
        "https://hyperfocache.offendingcommit.com/sse"
      ]
    }
  ]
}

Roo Code

Install in Roo Code

Add this to your Roo Code MCP configuration file. See Roo Code MCP docs for more info.

Remote Server Connection (Recommended)

{
  "mcpServers": {
    "hyperfocache": {
      "type": "streamable-http",
      "url": "https://hyperfocache.offendingcommit.com/mcp"
    }
  }
}

Docker-based Connection (Alternative)

{
  "mcpServers": {
    "hyperfocache": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-auth:/home/mcp/.mcp-auth",
        "ghcr.io/offendingcommit/mcp-remote:latest",
        "https://hyperfocache.offendingcommit.com/sse"
      ]
    }
  }
}

Zencoder

Install in Zencoder

1. Go to the Zencoder menu (...)
2. Select Agent tools
3. Click on Add custom MCP
4. Add the name and configuration:

{
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-v",
    "mcp-auth:/home/mcp/.mcp-auth",
    "ghcr.io/offendingcommit/mcp-remote:latest",
    "https://hyperfocache.offendingcommit.com/sse"
  ]
}

5. Click the Install button

Amazon Q Developer CLI

Install in Amazon Q Developer CLI

Add this to your Amazon Q Developer CLI configuration file. See Amazon Q Developer CLI docs for more details.

{
  "mcpServers": {
    "hyperfocache": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-auth:/home/mcp/.mcp-auth",
        "ghcr.io/offendingcommit/mcp-remote:latest",
        "https://hyperfocache.offendingcommit.com/sse"
      ]
    }
  }
}

Qodo Gen

Install in Qodo Gen

See Qodo Gen docs for more details.

1. Open Qodo Gen chat panel in VSCode or IntelliJ
2. Click Connect more tools
3. Click + Add new MCP
4. Add the following configuration:

{
  "mcpServers": {
    "hyperfocache": {
      "url": "https://hyperfocache.offendingcommit.com/mcp"
    }
  }
}

JetBrains AI Assistant

Install in JetBrains AI Assistant

See JetBrains AI Assistant Documentation for more details.

1. Go to Settings -> Tools -> AI Assistant -> Model Context Protocol (MCP)
2. Click + Add
3. Select As JSON option
4. Add this configuration:

{
  "mcpServers": {
    "hyperfocache": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-auth:/home/mcp/.mcp-auth",
        "ghcr.io/offendingcommit/mcp-remote:latest",
        "https://hyperfocache.offendingcommit.com/sse"
      ]
    }
  }
}

5. Click OK and then Apply

Warp

Install in Warp

See Warp Model Context Protocol Documentation for details.

1. Navigate Settings > AI > Manage MCP servers
2. Click the + Add button
3. Paste the configuration:

{
  "hyperfocache": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-v",
      "mcp-auth:/home/mcp/.mcp-auth",
      "ghcr.io/offendingcommit/mcp-remote:latest",
      "https://hyperfocache.offendingcommit.com/sse"
    ],
    "env": {},
    "working_directory": null,
    "start_on_launch": true
  }
}

4. Click Save

Opencode

Install in Opencode

Add this to your Opencode configuration file. See Opencode MCP docs for more info.

Remote Server Connection (Recommended)

"mcp": {
  "hyperfocache": {
    "type": "remote",
    "url": "https://hyperfocache.offendingcommit.com/mcp",
    "enabled": true
  }
}

Docker-based Connection (Alternative)

{
  "mcp": {
    "hyperfocache": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-auth:/home/mcp/.mcp-auth",
        "ghcr.io/offendingcommit/mcp-remote:latest",
        "https://hyperfocache.offendingcommit.com/sse"
      ],
      "enabled": true
    }
  }
}

Copilot Coding Agent

Install in Copilot Coding Agent

Add to your Repository->Settings->Copilot->Coding agent->MCP configuration:

{
  "mcpServers": {
    "hyperfocache": {
      "type": "http",
      "url": "https://hyperfocache.offendingcommit.com/mcp"
    }
  }
}

For more information, see the official GitHub documentation.

Kiro

Install in Kiro

See Kiro Model Context Protocol Documentation for details.

1. Navigate Kiro > MCP Servers
2. Click the + Add button
3. Paste the configuration:

{
  "mcpServers": {
    "hyperfocache": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-auth:/home/mcp/.mcp-auth",
        "ghcr.io/offendingcommit/mcp-remote:latest",
        "https://hyperfocache.offendingcommit.com/sse"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

4. Click Save

LM Studio

Install in LM Studio

See LM Studio MCP Support for more information.

1. Navigate to Program (right side) > Install > Edit mcp.json
2. Paste the configuration:

{
  "mcpServers": {
    "hyperfocache": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-auth:/home/mcp/.mcp-auth",
        "ghcr.io/offendingcommit/mcp-remote:latest",
        "https://hyperfocache.offendingcommit.com/sse"
      ]
    }
  }
}

3. Click Save
4. Toggle the MCP server on/off from the right side under Program

Perplexity Desktop

Install in Perplexity Desktop

See Local and Remote MCPs for Perplexity for more information.

1. Navigate Perplexity > Settings
2. Select Connectors
3. Click Add Connector
4. Select Advanced
5. Enter Server Name: HyperFocache
6. Paste the following JSON:

{
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-v",
    "mcp-auth:/home/mcp/.mcp-auth",
    "ghcr.io/offendingcommit/mcp-remote:latest",
    "https://hyperfocache.offendingcommit.com/sse"
  ],
  "env": {}
}

7. Click Save

Docker

Using Docker Directly

If you prefer to run the MCP server in a Docker container without a specific client:

Pull and Run the mcp-remote Image

# Pull the latest image
docker pull ghcr.io/offendingcommit/mcp-remote:latest

# Run with persistent token storage
docker run -it \
  -v mcp-auth:/home/mcp/.mcp-auth \
  ghcr.io/offendingcommit/mcp-remote:latest \
  https://hyperfocache.offendingcommit.com/sse

Using Docker Compose

Create a docker-compose.yml file:

version: '3.8'

services:
  hyperfocache:
    image: ghcr.io/offendingcommit/mcp-remote:latest
    container_name: hyperfocache
    volumes:
      - mcp-auth:/home/mcp/.mcp-auth
    ports:
      - "3334:3334"  # For OAuth callback if needed
    command: ["https://hyperfocache.offendingcommit.com/sse"]
    restart: unless-stopped

volumes:
  mcp-auth:
    driver: local

Run with: docker-compose up

Building from Source

# Clone the mcp-remote repository
git clone https://github.com/offendingcommit/mcp-remote.git
cd mcp-remote

# Build the image
docker build -t mcp-remote:local .

# Run HyperFocache
docker run -it \
  -v mcp-auth:/home/mcp/.mcp-auth \
  mcp-remote:local \
  https://hyperfocache.offendingcommit.com/sse

Windows

Install on Windows

For Windows users, the configuration differs slightly from Linux/macOS. Here's an example using Cline:

{
  "mcpServers": {
    "hyperfocache": {
      "command": "cmd",
      "args": [
        "/c",
        "docker",
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-auth:/home/mcp/.mcp-auth",
        "ghcr.io/offendingcommit/mcp-remote:latest",
        "https://hyperfocache.offendingcommit.com/sse"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Make sure Docker Desktop for Windows is installed and running before using the configuration.

Feedback & Support

We value your input and want to make HyperFocache better for everyone!

📝 Submit Feedback

Google Form: https://forms.gle/rPSh6xeeSUbngAbu7

• Feature requests
• Bug reports
• UX/UI feedback
• General suggestions

🐛 Report Issues

For technical issues, bugs, or feature requests, please use our feedback form above. We're actively monitoring all submissions and prioritize based on community needs.

💡 Suggestions Welcome

• Workflow improvements
• Integration ideas
• Performance optimizations
• Accessibility enhancements

🤝 Community

Join our growing community of developers using HyperFocache to amplify their cognitive abilities. Your experiences and insights help shape the future of the project.

Getting Started

Visit hyperfocache.com to begin using HyperFocache with your GitHub account.

About

HyperFocache combines neural network concepts with cache memory blocks, creating a modern tech-forward solution for cognitive augmentation. It's not just a tool - it's your external brain, designed to work the way your mind does.

---

Built with ❤️ for the ADHD developer community