{"id":30369456,"url":"https://github.com/niclasolofsson/mode-manager-mcp","last_synced_at":"2025-12-29T10:58:20.381Z","repository":{"id":307649337,"uuid":"1030243336","full_name":"NiclasOlofsson/mode-manager-mcp","owner":"NiclasOlofsson","description":"MCP Memory Agent Server - A VS Code chatmode and instruction manager with library integration","archived":false,"fork":false,"pushed_at":"2025-08-09T11:26:04.000Z","size":328,"stargazers_count":4,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-09T13:14:35.373Z","etag":null,"topics":["ai","ai-agents","automation","chatmode","developer-tools","github-copilot","instruction-management","llm","mcp","mcp-server","model-context-protocol","personal-ai","productivity","prompt-engineering","prompts","python","vscode"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NiclasOlofsson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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-01T10:10:57.000Z","updated_at":"2025-08-09T11:26:07.000Z","dependencies_parsed_at":"2025-08-02T01:24:17.301Z","dependency_job_id":null,"html_url":"https://github.com/NiclasOlofsson/mode-manager-mcp","commit_stats":null,"previous_names":["niclasolofsson/node-manager-mcp","niclasolofsson/mode-manager-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/NiclasOlofsson/mode-manager-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NiclasOlofsson%2Fmode-manager-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NiclasOlofsson%2Fmode-manager-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NiclasOlofsson%2Fmode-manager-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NiclasOlofsson%2Fmode-manager-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NiclasOlofsson","download_url":"https://codeload.github.com/NiclasOlofsson/mode-manager-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NiclasOlofsson%2Fmode-manager-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271252993,"owners_count":24726918,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-20T02:00:09.606Z","response_time":69,"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":["ai","ai-agents","automation","chatmode","developer-tools","github-copilot","instruction-management","llm","mcp","mcp-server","model-context-protocol","personal-ai","productivity","prompt-engineering","prompts","python","vscode"],"created_at":"2025-08-20T02:16:50.552Z","updated_at":"2025-12-29T10:58:20.360Z","avatar_url":"https://github.com/NiclasOlofsson.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"remember-new-logo-complete-white.svg\"\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"remember-new-logo-complete-black.svg\"\u003e\n  \u003cimg alt=\"GitHub Copilot Memory Tool\" src=\"https://raw.githubusercontent.com/NiclasOlofsson/mode-manager-mcp/refs/heads/main/remember-new-logo-complete-black.svg\" width=\"800\"\u003e\n\u003c/picture\u003e\n\n\n# Meet #remember -- Real Memory for You, Your Team, and Your AI\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square\u0026logo=visualstudiocode\u0026logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=modemanager\u0026config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mode-manager-mcp%22%5D%7D)\n[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=flat-square\u0026logo=visualstudiocode\u0026logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=modemanager\u0026config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mode-manager-mcp%22%5D%7D\u0026quality=insiders)\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.8+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n\nMode Manager MCP is an AI-powered memory and context system for developers and teams. It lets you and your team “remember” important facts, preferences, and best practices—so your AI assistant always has the right context, and your team’s knowledge is never lost.\n\nWith Mode Manager MCP, you can:\n- Instantly store and retrieve personal, team, and language-specific knowledge.\n- Share onboarding notes, coding conventions, and project wisdom—right where you work.\n- Make your AI assistant smarter, more helpful, and always in sync with your workflow.\n\n## Why “Remember”? (Features \u0026 Benefits)\n\n- **Personal AI Memory:** Instantly store preferences, facts, and reminders for yourself—your AI assistant will always know your context.\n- **Workspace (Team) Memory:** Share best practices, onboarding notes, and team knowledge directly in the repo. New team members ramp up faster, and everyone stays on the same page.\n- **Language-Specific Memory:** Save and retrieve language-specific tips and conventions. Your assistant adapts to each language’s best practices automatically.\n- **Natural Language Simplicity:** Just say “remember…”—no config files, no YAML, no technical hurdles.\n- **Smarter Coding, Fewer Repeated Questions:** Your team’s memory grows over time, reducing repeated questions and ensuring consistent practices.- **AI-Powered Memory Optimization:** Automatically consolidate and organize your memories to keep them clean and efficient.\n\u0026nbsp;  \n\u003e\u0026nbsp;  \n\u003e **Before this tool**  \n\u003e *\"Hey Copilot, write me a Python function...\"*  \n\u003e Copilot: *Gives generic Python code*\n\u003e\n\u003e **After using `remember`**  \n\u003e You: *\"Remember I'm a senior data architect at Oatly, prefer type hints, and use Black formatting\"*  \n\u003e Next conversation: *\"Write me a Python function...\"*  \n\u003e Copilot: *Generates perfectly styled code with type hints, following your exact preferences*  \n\u003e\u0026nbsp;  \n\n**Ready to have Copilot that actually remembers you? [Get started now!](#get-it-running-2-minutes)**\n\n## Real-World Examples: Just Say It!\n\nYou don’t need special syntax—just talk to Copilot naturally. Mode Manager MCP is extremely relaxed about how you phrase things. \nIf it sounds like something you want remembered, it will be!\n\n\u003e\u0026nbsp;  \n\u003e**Personal memory**  \n\u003e You: *I like detailed docstrings and use pytest for testing.\n\u003e (Copilot, keep that in mind.)*  \n\u003e\n\u003e ---  \n\u003e**Team memory**  \n\u003e You: *We alw\u0026nbsp;ays use the Oatly data pipeline template and follow our naming conventions.\n\u003e (Let’s make sure everyone remembers that.)*\n\u003e\n\u003e ---  \n\u003e**Language-specific memory**\n\u003e You: *For Python, use type hints and Black formatting.\n\u003e In C#, always use nullable reference types.*  \n\u003e\u0026nbsp;  \n\n## Get It Running (2 Minutes)\n\nIf you don't have Python installed, get it at [python.org/downloads](https://www.python.org/downloads/) - you'll need Python 3.10 or higher.\n\nDon't have `uv` yet? Install it with: `pip install uv` or see [docs.astral.sh/uv](https://docs.astral.sh/uv/getting-started/installation/)\n\n### Option 1: One-Click Install (Easiest)\n\nClick the badge for your VS Code version:\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square\u0026logo=visualstudiocode\u0026logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=modemanager\u0026config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mode-manager-mcp%22%5D%7D)\n[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=flat-square\u0026logo=visualstudiocode\u0026logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=modemanager\u0026config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mode-manager-mcp%22%5D%7D\u0026quality=insiders)\n\nThat's it! The server will automatically start when you open VS Code.\n\n### Option 2: Manual Configuration\n\nAdd this to your `.vscode/mcp.json` or global `mcp.json` file:\n\n```json\n{\n  \"servers\": {\n    \"mode-manager\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mode-manager-mcp\"]\n    }\n  }\n}\n```\n\nOr if you prefer `pipx`:\n\n```json\n{\n  \"servers\": {\n    \"mode-manager\": {\n      \"command\": \"pipx\",\n      \"args\": [\"run\", \"mode-manager-mcp\"]\n    }\n  }\n}\n```\n\n### Option 3: Development / Testing (Latest from GitHub)\n\nFor the impatient who want the latest features immediately:\n\nWith `uvx`:\n\n```json\n{\n  \"servers\": {\n    \"mode-manager\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"--from\",\n        \"git+https://github.com/NiclasOlofsson/mode-manager-mcp.git\",\n        \"mode-manager-mcp\"\n      ]\n    }\n  }\n}\n```\n\nWith `pipx`:\n\n```json\n{\n  \"servers\": {\n    \"mode-manager\": {\n      \"command\": \"pipx\",\n      \"args\": [\n        \"run\",\n        \"--no-cache\",\n        \"--spec\",\n        \"git+https://github.com/NiclasOlofsson/mode-manager-mcp.git\",\n        \"mode-manager-mcp\"\n      ]\n    }\n  }\n}\n```\n\nThis downloads and installs directly from GitHub every time - always bleeding edge!\n\n### Bonus: Interactive Onboarding\n\nAs a convenience, you can run the following prompt in VS Code to get started:\n\n\u003e\u0026nbsp;  \n\u003eYou: */mcp.mode-manager.onboarding*  \n\u003e\u0026nbsp;  \n\nThis will guide you through the onboarding process, set up your persistent memory, and ensure Copilot knows your preferences from the start.\n\n### For Development / Testing Latest from GitHub\n\nTo run the latest code directly from GitHub:\n\n```json\n{\n  \"servers\": {\n    \"mode-manager\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"run\",\n        \"--with\",\n        \"git+https://github.com/NiclasOlofsson/mode-manager-mcp.git\",\n        \"mode-manager-mcp\"\n      ],\n      \"env\": {\n        \"_RESTART\": \"1\"\n      }\n    }\n  }\n}\n```\n\n\n## Under the Hood: How Memory Magic Happens\n\nMode Manager MCP is designed to make memory persistent, context-aware, and \neasy to manage—without you having to think about the details. Here’s how \nit works under the hood:\n\n### Memory Scopes\n\n- **Personal Memory:**  \n  Stored in a user-specific file (`memory.instructions.md`) in your VS Code prompts directory. This is your private memory—preferences, habits, and facts that follow you across all projects.\n\n- **Workspace (Team) Memory:**  \n  Stored in a workspace-level file (also `memory.instructions.md`, but in the workspace’s `.github/instructions` directory). This is shared with everyone working in the same repo, so team conventions and onboarding notes are always available.\n\n- **Language-Specific Memory:**  \n  Stored in files like `memory-python.instructions.md`, `memory-csharp.instructions.md`, etc. These are automatically loaded when you’re working in a particular language, so language tips and conventions are always at hand.\n\n### How Memory is Stored\n\nAll memory is saved as Markdown files with a YAML frontmatter header, \nmaking it both human- and machine-readable. Each entry is timestamped and \nneatly organized, so you can always see when and what was remembered. You \nnever have to manage these files yourself—Mode Manager MCP automatically \ncreates and updates them as you add new memories.\n\n### How Memory is Loaded\n\nHere’s the magic: Mode Manager MCP writes and manages all your memory files, \nbut it’s actually the new VS Code Copilot Chat that automatically loads \nthem—every single turn. This deep integration means that, every time you send \na message or ask Copilot for help, your user, workspace, and language memories \nare instantly available to the AI.\n\nLanguage-specific memory is even smarter: it’s tied to file types using \nthe `applyTo` property in the YAML frontmatter (for example, `**/*.py` for Python \nor `**/*.cs` for C#). This means you get the right tips, conventions, and \nreminders only when you’re working in the relevant language or file type—no clutter, \njust the context you need, exactly when you need it.\n\nYou never have to worry about context being lost between messages or sessions; your \nmemory is always active and available. We’re simply leveraging this new, amazing \nVS Code feature to make your Copilot (and your team) smarter than ever.\n\n### No Special Syntax Needed\n\nThere’s no need to remember special commands or keywords—just talk naturally. Mode Manager \nMCP is flexible and understands a wide range of phrasing. You don’t have to say \n“workspace” to store team memory; it recognizes common alternatives like “project,” \n“repo,” or even just describing something as a team convention. Whether you’re \nmaking a personal note, a team guideline, or a language-specific tip, just say it \nin your own words—Mode Manager MCP figures out what you want to remember and where it belongs.\n\n## Contributing\n\nWant to help make this better? The best contribution you can make is actually using it - your feedback and bug reports are what really drive improvements.\n\nOf course, code contributions are welcome too! Check out [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines. But seriously, just using it and telling us what works (or doesn't) is incredibly valuable.\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fniclasolofsson%2Fmode-manager-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fniclasolofsson%2Fmode-manager-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fniclasolofsson%2Fmode-manager-mcp/lists"}