{"id":51417679,"url":"https://github.com/offendingcommit/hyperfocache","last_synced_at":"2026-07-04T21:30:22.076Z","repository":{"id":308570355,"uuid":"1033291618","full_name":"offendingcommit/hyperfocache","owner":"offendingcommit","description":"Your External Brain, Amplified 🧠 An ADHD-optimized memory augmentation system with 20+ cognitive tools, semantic search, and hyperfocus-powered knowledge management","archived":false,"fork":false,"pushed_at":"2025-08-06T18:51:57.000Z","size":11,"stargazers_count":13,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-04T21:48:19.562Z","etag":null,"topics":["adhd","ai-powered","claude","claude-code","cloudflare","cloudflare-workers","cognitive-tools","d1-database","developer-tools","external-brain","knowledge-management","llms","mcp","memory","rag","semantic-search","vectorize"],"latest_commit_sha":null,"homepage":"https://hyperfocache.com","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/offendingcommit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-06T15:30:57.000Z","updated_at":"2026-05-21T00:30:52.000Z","dependencies_parsed_at":"2025-08-06T17:51:54.063Z","dependency_job_id":"69a0295e-b570-456c-86d3-20706c2f4b56","html_url":"https://github.com/offendingcommit/hyperfocache","commit_stats":null,"previous_names":["offendingcommit/hyperfocache"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/offendingcommit/hyperfocache","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/offendingcommit%2Fhyperfocache","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/offendingcommit%2Fhyperfocache/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/offendingcommit%2Fhyperfocache/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/offendingcommit%2Fhyperfocache/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/offendingcommit","download_url":"https://codeload.github.com/offendingcommit/hyperfocache/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/offendingcommit%2Fhyperfocache/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35136712,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-04T02:00:05.987Z","response_time":113,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adhd","ai-powered","claude","claude-code","cloudflare","cloudflare-workers","cognitive-tools","d1-database","developer-tools","external-brain","knowledge-management","llms","mcp","memory","rag","semantic-search","vectorize"],"created_at":"2026-07-04T21:30:21.438Z","updated_at":"2026-07-04T21:30:22.069Z","avatar_url":"https://github.com/offendingcommit.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# HyperFocache 🧠⚡\n\nYour External Brain, Amplified - An ADHD-optimized memory augmentation system for developers who leverage hyperfocus as a superpower.\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Key Features](#key-features)\n- [Installation](#installation)\n  - [Requirements](#requirements)\n  - [Cursor](#cursor)\n  - [Windsurf](#windsurf)\n  - [Claude Desktop](#claude-desktop)\n  - [Claude Code](#claude-code)\n  - [VS Code](#vs-code)\n  - [Visual Studio 2022](#visual-studio-2022)\n  - [Zed](#zed)\n  - [Cline](#cline)\n  - [Trae](#trae)\n  - [Gemini CLI](#gemini-cli)\n  - [BoltAI](#boltai)\n  - [Augment Code](#augment-code)\n  - [Roo Code](#roo-code)\n  - [Zencoder](#zencoder)\n  - [Amazon Q Developer CLI](#amazon-q-developer-cli)\n  - [Qodo Gen](#qodo-gen)\n  - [JetBrains AI Assistant](#jetbrains-ai-assistant)\n  - [Warp](#warp)\n  - [Opencode](#opencode)\n  - [Copilot Coding Agent](#copilot-coding-agent)\n  - [Kiro](#kiro)\n  - [LM Studio](#lm-studio)\n  - [Perplexity Desktop](#perplexity-desktop)\n  - [Smithery](#smithery)\n  - [Docker](#docker)\n  - [Windows](#windows)\n- [Feedback \u0026 Support](#feedback--support)\n- [Getting Started](#getting-started)\n- [About](#about)\n\n## Overview\n\nHyperFocache 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.\n\n## Key Features\n\n- **20+ Memory Tools**: Comprehensive suite for saving, searching, evolving, and organizing memories\n- **Semantic Search**: Find memories by meaning, not just keywords\n- **Context Preservation**: Save and restore work states when switching tasks or getting interrupted\n- **Problem-Solving Breadcrumbs**: Track your debugging journeys, including dead ends and breakthroughs\n- **Memory Evolution**: Update existing memories without losing history\n- **Intelligent Consolidation**: Automatically merge related memories to reduce clutter\n- **Time-Based Retrieval**: Navigate your memory timeline effortlessly\n- **Relationship Mapping**: Visualize connections between memories\n- **ADHD-Optimized**: Built by and for developers with ADHD\n\n## Installation\n\n### Requirements\n\n- Node.js \u003e= v18.0.0 (for local installations)\n- Cursor, Windsurf, Claude Desktop, or another MCP Client\n\n\u003e **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.\n\n### Cursor\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Cursor\u003c/b\u003e\u003c/summary\u003e\n\nGo to: `Settings` -\u003e `Cursor Settings` -\u003e `MCP` -\u003e `Add new global MCP server`\n\nSince Cursor 1.0, you can use one-click installation or paste the configuration into your `~/.cursor/mcp.json` file.\n\n#### Remote Server Connection (Recommended)\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"url\": \"https://hyperfocache.offendingcommit.com/mcp\"\n    }\n  }\n}\n```\n\n#### Docker-based Connection (Alternative)\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-v\",\n        \"mcp-auth:/home/mcp/.mcp-auth\",\n        \"ghcr.io/offendingcommit/mcp-remote:latest\",\n        \"https://hyperfocache.offendingcommit.com/sse\"\n      ]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n### Windsurf\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Windsurf\u003c/b\u003e\u003c/summary\u003e\n\nAdd this to your Windsurf MCP config file. See [Windsurf MCP docs](https://docs.windsurf.com/windsurf/mcp) for more info.\n\n#### Remote Server Connection (Recommended)\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"serverUrl\": \"https://hyperfocache.offendingcommit.com/sse\"\n    }\n  }\n}\n```\n\n#### Docker-based Connection (Alternative)\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-v\",\n        \"mcp-auth:/home/mcp/.mcp-auth\",\n        \"ghcr.io/offendingcommit/mcp-remote:latest\",\n        \"https://hyperfocache.offendingcommit.com/sse\"\n      ]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n### Claude Desktop\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Claude Desktop\u003c/b\u003e\u003c/summary\u003e\n\nAdd this to your Claude Desktop `claude_desktop_config.json` file. See [Claude Desktop MCP docs](https://modelcontextprotocol.io/quickstart/user) for more info.\n\nSince Claude Desktop primarily supports stdio connections, you'll need to use the Docker-based mcp-remote fork:\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-v\",\n        \"mcp-auth:/home/mcp/.mcp-auth\",\n        \"ghcr.io/offendingcommit/mcp-remote:latest\",\n        \"https://hyperfocache.offendingcommit.com/sse\"\n      ]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n### Claude Code\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Claude Code\u003c/b\u003e\u003c/summary\u003e\n\nRun this command. See [Claude Code MCP docs](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#set-up-model-context-protocol-mcp) for more info.\n\n#### Remote Server Connection (Recommended)\n\n```sh\nclaude mcp add --transport http hyperfocache https://hyperfocache.offendingcommit.com/mcp\n```\n\nOr using SSE transport:\n\n```sh\nclaude mcp add --transport sse hyperfocache https://hyperfocache.offendingcommit.com/sse\n```\n\n#### Docker-based Connection (Alternative)\n\n```sh\nclaude 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\n```\n\n\u003c/details\u003e\n\n### VS Code\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in VS Code\u003c/b\u003e\u003c/summary\u003e\n\nAdd this to your VS Code MCP config file. See [VS Code MCP docs](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) for more info.\n\n#### Remote Server Connection (Recommended)\n\n```json\n\"mcp\": {\n  \"servers\": {\n    \"hyperfocache\": {\n      \"type\": \"http\",\n      \"url\": \"https://hyperfocache.offendingcommit.com/mcp\"\n    }\n  }\n}\n```\n\n#### Docker-based Connection (Alternative)\n\n```json\n\"mcp\": {\n  \"servers\": {\n    \"hyperfocache\": {\n      \"type\": \"stdio\",\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-v\",\n        \"mcp-auth:/home/mcp/.mcp-auth\",\n        \"ghcr.io/offendingcommit/mcp-remote:latest\",\n        \"https://hyperfocache.offendingcommit.com/sse\"\n      ]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n### Visual Studio 2022\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Visual Studio 2022\u003c/b\u003e\u003c/summary\u003e\n\nFollow the [Visual Studio MCP Servers documentation](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022).\n\nAdd this to your Visual Studio MCP config file:\n\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"hyperfocache\": {\n        \"type\": \"http\",\n        \"url\": \"https://hyperfocache.offendingcommit.com/mcp\"\n      }\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n### Zed\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Zed\u003c/b\u003e\u003c/summary\u003e\n\nAdd this to your Zed `settings.json`. See [Zed Context Server docs](https://zed.dev/docs/assistant/context-servers) for more info.\n\n```json\n{\n  \"context_servers\": {\n    \"hyperfocache\": {\n      \"command\": {\n        \"path\": \"docker\",\n        \"args\": [\n          \"run\",\n          \"-i\",\n          \"--rm\",\n          \"-v\",\n          \"mcp-auth:/home/mcp/.mcp-auth\",\n          \"ghcr.io/offendingcommit/mcp-remote:latest\",\n          \"https://hyperfocache.offendingcommit.com/sse\"\n        ]\n      },\n      \"settings\": {}\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n### Cline\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Cline\u003c/b\u003e\u003c/summary\u003e\n\nAdd this to your Cline MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-v\",\n        \"mcp-auth:/home/mcp/.mcp-auth\",\n        \"ghcr.io/offendingcommit/mcp-remote:latest\",\n        \"https://hyperfocache.offendingcommit.com/sse\"\n      ],\n      \"disabled\": false,\n      \"autoApprove\": []\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n### Trae\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Trae\u003c/b\u003e\u003c/summary\u003e\n\nUse the Add manually feature and fill in the JSON configuration. For more details, visit the [Trae documentation](https://docs.trae.ai/ide/model-context-protocol?_lang=en).\n\n#### Remote Server Connection (Recommended)\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"url\": \"https://hyperfocache.offendingcommit.com/mcp\"\n    }\n  }\n}\n```\n\n#### Docker-based Connection (Alternative)\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-v\",\n        \"mcp-auth:/home/mcp/.mcp-auth\",\n        \"ghcr.io/offendingcommit/mcp-remote:latest\",\n        \"https://hyperfocache.offendingcommit.com/sse\"\n      ]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n### Gemini CLI\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Gemini CLI\u003c/b\u003e\u003c/summary\u003e\n\nSee [Gemini CLI Configuration](https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/configuration.md) for details.\n\n1. Open the Gemini CLI settings file at `~/.gemini/settings.json`\n2. Add the following to the `mcpServers` object:\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"httpUrl\": \"https://hyperfocache.offendingcommit.com/mcp\"\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n### BoltAI\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in BoltAI\u003c/b\u003e\u003c/summary\u003e\n\nOpen the \"Settings\" page, navigate to \"Plugins,\" and enter:\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-v\",\n        \"mcp-auth:/home/mcp/.mcp-auth\",\n        \"ghcr.io/offendingcommit/mcp-remote:latest\",\n        \"https://hyperfocache.offendingcommit.com/sse\"\n      ]\n    }\n  }\n}\n```\n\nMore information available on [BoltAI's Documentation site](https://docs.boltai.com/docs/plugins/mcp-servers).\n\n\u003c/details\u003e\n\n### Augment Code\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Augment Code\u003c/b\u003e\u003c/summary\u003e\n\n#### Using the Augment Code UI\n\n1. Click the hamburger menu\n2. Select **Settings**\n3. Navigate to the **Tools** section\n4. Click the **+ Add MCP** button\n5. Enter the following command:\n   ```\n   docker run -i --rm -v mcp-auth:/home/mcp/.mcp-auth ghcr.io/offendingcommit/mcp-remote:latest https://hyperfocache.offendingcommit.com/sse\n   ```\n6. Name the MCP: **HyperFocache**\n7. Click the **Add** button\n\n#### Manual Configuration\n\nAdd to your `settings.json`:\n\n```json\n\"augment.advanced\": {\n  \"mcpServers\": [\n    {\n      \"name\": \"hyperfocache\",\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-v\",\n        \"mcp-auth:/home/mcp/.mcp-auth\",\n        \"ghcr.io/offendingcommit/mcp-remote:latest\",\n        \"https://hyperfocache.offendingcommit.com/sse\"\n      ]\n    }\n  ]\n}\n```\n\n\u003c/details\u003e\n\n### Roo Code\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Roo Code\u003c/b\u003e\u003c/summary\u003e\n\nAdd this to your Roo Code MCP configuration file. See [Roo Code MCP docs](https://docs.roocode.com/features/mcp/using-mcp-in-roo) for more info.\n\n#### Remote Server Connection (Recommended)\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://hyperfocache.offendingcommit.com/mcp\"\n    }\n  }\n}\n```\n\n#### Docker-based Connection (Alternative)\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-v\",\n        \"mcp-auth:/home/mcp/.mcp-auth\",\n        \"ghcr.io/offendingcommit/mcp-remote:latest\",\n        \"https://hyperfocache.offendingcommit.com/sse\"\n      ]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n### Zencoder\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Zencoder\u003c/b\u003e\u003c/summary\u003e\n\n1. Go to the Zencoder menu (...)\n2. Select Agent tools\n3. Click on Add custom MCP\n4. Add the name and configuration:\n\n```json\n{\n  \"command\": \"docker\",\n  \"args\": [\n    \"run\",\n    \"-i\",\n    \"--rm\",\n    \"-v\",\n    \"mcp-auth:/home/mcp/.mcp-auth\",\n    \"ghcr.io/offendingcommit/mcp-remote:latest\",\n    \"https://hyperfocache.offendingcommit.com/sse\"\n  ]\n}\n```\n\n5. Click the Install button\n\n\u003c/details\u003e\n\n### Amazon Q Developer CLI\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Amazon Q Developer CLI\u003c/b\u003e\u003c/summary\u003e\n\nAdd this to your Amazon Q Developer CLI configuration file. See [Amazon Q Developer CLI docs](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html) for more details.\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-v\",\n        \"mcp-auth:/home/mcp/.mcp-auth\",\n        \"ghcr.io/offendingcommit/mcp-remote:latest\",\n        \"https://hyperfocache.offendingcommit.com/sse\"\n      ]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n### Qodo Gen\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Qodo Gen\u003c/b\u003e\u003c/summary\u003e\n\nSee [Qodo Gen docs](https://docs.qodo.ai/qodo-documentation/qodo-gen/qodo-gen-chat/agentic-mode/agentic-tools-mcps) for more details.\n\n1. Open Qodo Gen chat panel in VSCode or IntelliJ\n2. Click Connect more tools\n3. Click + Add new MCP\n4. Add the following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"url\": \"https://hyperfocache.offendingcommit.com/mcp\"\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n### JetBrains AI Assistant\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in JetBrains AI Assistant\u003c/b\u003e\u003c/summary\u003e\n\nSee [JetBrains AI Assistant Documentation](https://www.jetbrains.com/help/ai-assistant/configure-an-mcp-server.html) for more details.\n\n1. Go to `Settings` -\u003e `Tools` -\u003e `AI Assistant` -\u003e `Model Context Protocol (MCP)`\n2. Click `+ Add`\n3. Select `As JSON` option\n4. Add this configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-v\",\n        \"mcp-auth:/home/mcp/.mcp-auth\",\n        \"ghcr.io/offendingcommit/mcp-remote:latest\",\n        \"https://hyperfocache.offendingcommit.com/sse\"\n      ]\n    }\n  }\n}\n```\n\n5. Click `OK` and then `Apply`\n\n\u003c/details\u003e\n\n### Warp\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Warp\u003c/b\u003e\u003c/summary\u003e\n\nSee [Warp Model Context Protocol Documentation](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server) for details.\n\n1. Navigate `Settings` \u003e `AI` \u003e `Manage MCP servers`\n2. Click the `+ Add` button\n3. Paste the configuration:\n\n```json\n{\n  \"hyperfocache\": {\n    \"command\": \"docker\",\n    \"args\": [\n      \"run\",\n      \"-i\",\n      \"--rm\",\n      \"-v\",\n      \"mcp-auth:/home/mcp/.mcp-auth\",\n      \"ghcr.io/offendingcommit/mcp-remote:latest\",\n      \"https://hyperfocache.offendingcommit.com/sse\"\n    ],\n    \"env\": {},\n    \"working_directory\": null,\n    \"start_on_launch\": true\n  }\n}\n```\n\n4. Click `Save`\n\n\u003c/details\u003e\n\n### Opencode\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Opencode\u003c/b\u003e\u003c/summary\u003e\n\nAdd this to your Opencode configuration file. See [Opencode MCP docs](https://opencode.ai/docs/mcp-servers) for more info.\n\n#### Remote Server Connection (Recommended)\n\n```json\n\"mcp\": {\n  \"hyperfocache\": {\n    \"type\": \"remote\",\n    \"url\": \"https://hyperfocache.offendingcommit.com/mcp\",\n    \"enabled\": true\n  }\n}\n```\n\n#### Docker-based Connection (Alternative)\n\n```json\n{\n  \"mcp\": {\n    \"hyperfocache\": {\n      \"type\": \"local\",\n      \"command\": [\n        \"docker\",\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-v\",\n        \"mcp-auth:/home/mcp/.mcp-auth\",\n        \"ghcr.io/offendingcommit/mcp-remote:latest\",\n        \"https://hyperfocache.offendingcommit.com/sse\"\n      ],\n      \"enabled\": true\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n### Copilot Coding Agent\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Copilot Coding Agent\u003c/b\u003e\u003c/summary\u003e\n\nAdd to your Repository-\u003eSettings-\u003eCopilot-\u003eCoding agent-\u003eMCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"type\": \"http\",\n      \"url\": \"https://hyperfocache.offendingcommit.com/mcp\"\n    }\n  }\n}\n```\n\nFor more information, see the [official GitHub documentation](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp).\n\n\u003c/details\u003e\n\n### Kiro\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Kiro\u003c/b\u003e\u003c/summary\u003e\n\nSee [Kiro Model Context Protocol Documentation](https://kiro.dev/docs/mcp/configuration/) for details.\n\n1. Navigate `Kiro` \u003e `MCP Servers`\n2. Click the `+ Add` button\n3. Paste the configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-v\",\n        \"mcp-auth:/home/mcp/.mcp-auth\",\n        \"ghcr.io/offendingcommit/mcp-remote:latest\",\n        \"https://hyperfocache.offendingcommit.com/sse\"\n      ],\n      \"env\": {},\n      \"disabled\": false,\n      \"autoApprove\": []\n    }\n  }\n}\n```\n\n4. Click `Save`\n\n\u003c/details\u003e\n\n### LM Studio\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in LM Studio\u003c/b\u003e\u003c/summary\u003e\n\nSee [LM Studio MCP Support](https://lmstudio.ai/blog/lmstudio-v0.3.17) for more information.\n\n1. Navigate to `Program` (right side) \u003e `Install` \u003e `Edit mcp.json`\n2. Paste the configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-v\",\n        \"mcp-auth:/home/mcp/.mcp-auth\",\n        \"ghcr.io/offendingcommit/mcp-remote:latest\",\n        \"https://hyperfocache.offendingcommit.com/sse\"\n      ]\n    }\n  }\n}\n```\n\n3. Click `Save`\n4. Toggle the MCP server on/off from the right side under `Program`\n\n\u003c/details\u003e\n\n### Perplexity Desktop\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Perplexity Desktop\u003c/b\u003e\u003c/summary\u003e\n\nSee [Local and Remote MCPs for Perplexity](https://www.perplexity.ai/help-center/en/articles/11502712-local-and-remote-mcps-for-perplexity) for more information.\n\n1. Navigate `Perplexity` \u003e `Settings`\n2. Select `Connectors`\n3. Click `Add Connector`\n4. Select `Advanced`\n5. Enter Server Name: `HyperFocache`\n6. Paste the following JSON:\n\n```json\n{\n  \"command\": \"docker\",\n  \"args\": [\n    \"run\",\n    \"-i\",\n    \"--rm\",\n    \"-v\",\n    \"mcp-auth:/home/mcp/.mcp-auth\",\n    \"ghcr.io/offendingcommit/mcp-remote:latest\",\n    \"https://hyperfocache.offendingcommit.com/sse\"\n  ],\n  \"env\": {}\n}\n```\n\n7. Click `Save`\n\n\u003c/details\u003e\n\n### Docker\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eUsing Docker Directly\u003c/b\u003e\u003c/summary\u003e\n\nIf you prefer to run the MCP server in a Docker container without a specific client:\n\n#### Pull and Run the mcp-remote Image\n\n```bash\n# Pull the latest image\ndocker pull ghcr.io/offendingcommit/mcp-remote:latest\n\n# Run with persistent token storage\ndocker run -it \\\n  -v mcp-auth:/home/mcp/.mcp-auth \\\n  ghcr.io/offendingcommit/mcp-remote:latest \\\n  https://hyperfocache.offendingcommit.com/sse\n```\n\n#### Using Docker Compose\n\nCreate a `docker-compose.yml` file:\n\n```yaml\nversion: '3.8'\n\nservices:\n  hyperfocache:\n    image: ghcr.io/offendingcommit/mcp-remote:latest\n    container_name: hyperfocache\n    volumes:\n      - mcp-auth:/home/mcp/.mcp-auth\n    ports:\n      - \"3334:3334\"  # For OAuth callback if needed\n    command: [\"https://hyperfocache.offendingcommit.com/sse\"]\n    restart: unless-stopped\n\nvolumes:\n  mcp-auth:\n    driver: local\n```\n\nRun with: `docker-compose up`\n\n#### Building from Source\n\n```bash\n# Clone the mcp-remote repository\ngit clone https://github.com/offendingcommit/mcp-remote.git\ncd mcp-remote\n\n# Build the image\ndocker build -t mcp-remote:local .\n\n# Run HyperFocache\ndocker run -it \\\n  -v mcp-auth:/home/mcp/.mcp-auth \\\n  mcp-remote:local \\\n  https://hyperfocache.offendingcommit.com/sse\n```\n\n\u003c/details\u003e\n\n### Windows\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall on Windows\u003c/b\u003e\u003c/summary\u003e\n\nFor Windows users, the configuration differs slightly from Linux/macOS. Here's an example using Cline:\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperfocache\": {\n      \"command\": \"cmd\",\n      \"args\": [\n        \"/c\",\n        \"docker\",\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-v\",\n        \"mcp-auth:/home/mcp/.mcp-auth\",\n        \"ghcr.io/offendingcommit/mcp-remote:latest\",\n        \"https://hyperfocache.offendingcommit.com/sse\"\n      ],\n      \"disabled\": false,\n      \"autoApprove\": []\n    }\n  }\n}\n```\n\nMake sure Docker Desktop for Windows is installed and running before using the configuration.\n\n\u003c/details\u003e\n\n## Feedback \u0026 Support\n\nWe value your input and want to make HyperFocache better for everyone!\n\n### 📝 Submit Feedback\n**Google Form**: [https://forms.gle/rPSh6xeeSUbngAbu7](https://forms.gle/rPSh6xeeSUbngAbu7)\n- Feature requests\n- Bug reports\n- UX/UI feedback\n- General suggestions\n\n### 🐛 Report Issues\nFor technical issues, bugs, or feature requests, please use our feedback form above. We're actively monitoring all submissions and prioritize based on community needs.\n\n### 💡 Suggestions Welcome\n- Workflow improvements\n- Integration ideas\n- Performance optimizations\n- Accessibility enhancements\n\n### 🤝 Community\nJoin our growing community of developers using HyperFocache to amplify their cognitive abilities. Your experiences and insights help shape the future of the project.\n\n## Getting Started\n\nVisit [hyperfocache.com](https://hyperfocache.com) to begin using HyperFocache with your GitHub account.\n\n## About\n\nHyperFocache 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.\n\n---\n\n*Built with ❤️ for the ADHD developer community*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foffendingcommit%2Fhyperfocache","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foffendingcommit%2Fhyperfocache","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foffendingcommit%2Fhyperfocache/lists"}