{
  "markdown": "# Wuniq MCP\n\n<p align=\"center\">\n  <img src=\"assets/wuniq-icon.png\" alt=\"Wuniq\" width=\"128\" height=\"128\">\n</p>\n\n> **Wuniq is free. This MCP package requires the Wuniq desktop app, currently available for Windows and Linux. Download it only through the official, trusted links at [wuniq.com](https://www.wuniq.com). Do not use third-party mirrors.**\n\nWuniq is a knowledge engine for AI-assisted work. It stores decisions, constraints, intent, and human reasoning in `.wuniq` files beside your project files, so any MCP-compatible AI can read and maintain the knowledge exactly where the work lives.\n\nWuniq is local-first: no account, no cloud storage, and no telemetry.\n\n## What this repository contains\n\nThis repository contains the small, open-source MCP launcher published as [`@wuniq/mcp`](https://www.npmjs.com/package/@wuniq/mcp), the manifest submitted to the [official MCP Registry](https://registry.modelcontextprotocol.io/?search=com.wuniq), and thin wrappers for Claude, Codex, Antigravity, and Gemini CLI that all start the same launcher.\n\nThe launcher has zero dependencies. It connects your MCP client to the MCP server included with the installed Wuniq desktop app:\n\n```text\nMCP-compatible AI or IDE\n          |\n          v\n    npx @wuniq/mcp\n          |\n          v\nInstalled Wuniq desktop app\n          |\n          v\nLocal projects and .wuniq knowledge\n```\n\nThe Wuniq Knowledge Engine itself is not contained in this repository and is not distributed through npm. The MIT license in this repository applies only to the launcher.\n\n## Install and connect\n\n1. Install the free Wuniq desktop app using an official download link from [wuniq.com](https://www.wuniq.com).\n2. Add Wuniq from your IDE's MCP registry gallery, where supported, or configure it manually:\n\n```json\n{\n  \"mcpServers\": {\n    \"wuniq\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@wuniq/mcp\"]\n    }\n  }\n}\n```\n\nAlready have the app installed? You can also point your MCP configuration directly to the `wuniq-mcp` command placed on your PATH by the official Wuniq installation. Both methods connect to the same local engine.\n\nPer-IDE instructions and current platform availability are maintained at [wuniq.com](https://www.wuniq.com).\n\n## OpenCode\n\nOpenCode uses a project-level `opencode.json` file. Add Wuniq under its `mcp` key, keeping any providers, permissions, or other MCP servers already present:\n\n```json\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"mcp\": {\n    \"wuniq\": {\n      \"type\": \"local\",\n      \"command\": [\"npx\", \"-y\", \"@wuniq/mcp\"],\n      \"enabled\": true,\n      \"timeout\": 30000\n    }\n  }\n}\n```\n\nThen add the Wuniq workflow to the project's `AGENTS.md` without removing any existing instructions:\n\n```markdown\n# Wuniq KE (Knowledge Engine)\n\nAt the start of every session, run `open list` using the Wuniq MCP tool. If it returns projects, `open` each one. If the list is empty, proceed normally — the user may open projects later from the Wuniq UI. Never assume the working directory is a Wuniq project; the working directory may be a container folder holding multiple projects. Only open paths that `open list` explicitly returns.\n\nBefore working on any code file, `read` its Wuniq sidecar for context. After changing code, run `sync`.\n```\n\nThis route was validated on Windows with OpenCode Desktop 1.18.4, Wuniq 1.15.1, and `@wuniq/mcp` 1.0.1. MCP connection and the `open`, `read`, and `sync` calls worked correctly. Models vary in how reliably they act on `AGENTS.md` without prompting, so `open list` can always be requested explicitly.\n\nSee the full [Wuniq + OpenCode integration guide](https://www.wuniq.com/docs/integrations/opencode/) for verification, Linux instructions, Precise mode, and troubleshooting.\n\n## Claude plugin\n\nThe repository root is also a Claude plugin. It does not contain a second MCP server: `.mcp.json` starts the published `@wuniq/mcp` launcher, which connects Claude to the MCP server inside the installed Wuniq app.\n\nThe plugin includes one compact skill that teaches Claude the safe Wuniq workflow: discover visible projects first, read their context before working, preserve confirmed decisions, and synchronize after changes. It does not pre-approve tools or elevate permissions.\n\nBefore marketplace submission, the plugin can be checked and loaded locally with Claude Code:\n\n```text\nclaude plugin validate --strict .\nclaude --plugin-dir .\n```\n\n## Codex plugin\n\nThe same repository is also a Codex plugin. Its `.codex-plugin/plugin.json` reuses the same skill and `.mcp.json`; it starts `@wuniq/mcp` locally and does not create a hosted service or upload project data.\n\nAdd the public Wuniq marketplace from Codex:\n\n```text\ncodex plugin marketplace add Wuniq/wuniq-mcp --ref main\n```\n\nThen open the **Plugins** directory in the ChatGPT desktop app, select the **Wuniq** marketplace, and install **Wuniq**. Start a new Codex session after installation so the skill and MCP server are loaded.\n\nChatGPT on the web cannot run this local `stdio` MCP server. Wuniq's full integration is therefore for local Codex clients: the ChatGPT desktop app, Codex CLI, and the Codex IDE extension.\n\n## Antigravity plugin\n\nThe repository root is a native Antigravity plugin. Its `mcp_config.json` starts the published `@wuniq/mcp` launcher, while `skills/wuniq/SKILL.md` supplies the safe Wuniq workflow. It does not contain a second MCP server or upload project data.\n\nInstall it in Antigravity CLI from the public repository:\n\n```text\nagy plugin install https://github.com/Wuniq/wuniq-mcp\n```\n\nIn Antigravity 2.0, Wuniq can also be configured as a custom MCP server with the same `npx -y @wuniq/mcp` command while its MCP Store listing is under review.\n\n## Gemini CLI extension\n\nThe repository root is also a Gemini CLI extension. Its `gemini-extension.json` starts the same published `@wuniq/mcp` launcher, while `skills/wuniq/SKILL.md` supplies the safe Wuniq workflow as an Agent Skill. It does not contain a second MCP server or upload project data.\n\nInstall it directly from the public repository:\n\n```text\ngemini extensions install https://github.com/Wuniq/wuniq-mcp\n```\n\nRestart Gemini CLI after installation so the extension and its MCP tools are loaded.\n\nGoogle has transitioned personal, Pro, and Ultra users from Gemini CLI to Antigravity CLI. The Gemini CLI extension remains available for supported Enterprise, Google Cloud, and API-based environments.\n\n## Example prompts\n\n- \"Open the Wuniq projects visible to you and summarize the important context for this task.\"\n- \"Before changing the authentication module, read its Wuniq context and preserve the constraints already decided.\"\n- \"Record the decision we just made, implement the change, and run Wuniq sync when you finish.\"\n\n## Troubleshooting\n\n- **The Wuniq app is missing:** install it only from the official links at [wuniq.com](https://www.wuniq.com), then start a new Claude, Codex, Antigravity, or Gemini CLI session.\n- **`open list` returns no projects:** open the intended project in the Wuniq desktop interface and ask your AI client to try again.\n- **The launcher cannot start:** confirm that Node.js and `npx` are available, or use the direct per-client setup documented at [wuniq.com](https://www.wuniq.com).\n\n## How the launcher works\n\nThe launcher passes the MCP client's standard input and output directly to the MCP server included with the installed app. If Wuniq is not installed, it exposes only a minimal MCP response explaining how to obtain the official app.\n\nIt does not configure IDEs, contain Wuniq product logic, upload project data, or provide a second Knowledge Engine.\n\n## Security\n\nOnly install Wuniq through links published on [wuniq.com](https://www.wuniq.com). Do not use third-party mirrors or repackaged installers.\n\nTo report a security issue, use this repository's private vulnerability reporting instead of opening a public issue. See [SECURITY.md](SECURITY.md).\n\n## Links\n\n- [Wuniq website and official downloads](https://www.wuniq.com)\n- [Official MCP Registry entry](https://registry.modelcontextprotocol.io/?search=com.wuniq)\n- [`@wuniq/mcp` on npm](https://www.npmjs.com/package/@wuniq/mcp)\n\n## License\n\nThe MCP launcher and the Claude, Codex, Antigravity, and Gemini CLI wrappers in this repository are licensed under the [MIT License](LICENSE). The Wuniq desktop app and Knowledge Engine are separate software and are not covered by this repository's license.\n",
  "bytes": 8403,
  "sha": "29a60fa5d344db190382328151f0878df8dd7cb942eb3bf3ac010e4a60a70c23",
  "repo_slug": "wuniq/wuniq-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_wuniq_wuniq_aef63db9/readme"
}