Wuniq

Memória de projeto estruturada local-first para agentes de codificação de IA. Requer o aplicativo gratuito de desktop Wuniq.

GitHubExperimente este MCPPatrocinado

Documentação

Wuniq MCP

Wuniq

Wuniq é gratuito. Este pacote MCP requer o aplicativo de desktop Wuniq, atualmente disponível para Windows e Linux. Baixe-o apenas pelos links oficiais e confiáveis em wuniq.com. Não use espelhos de terceiros.

Wuniq é um mecanismo de conhecimento para trabalho assistido por IA. Ele armazena decisões, restrições, intenções e raciocínio humano em arquivos .wuniq ao lado dos seus arquivos de projeto, para que qualquer IA compatível com MCP possa ler e manter o conhecimento exatamente onde o trabalho acontece.

Wuniq é local-first: sem conta, sem armazenamento em nuvem e sem telemetria.

O que este repositório contém

Este repositório contém o pequeno launcher MCP de código aberto publicado como @wuniq/mcp, o manifesto submetido ao Registro Oficial de MCP e wrappers leves para Claude, Codex, Antigravity e Gemini CLI, que todos iniciam o mesmo launcher.

O launcher não tem dependências. Ele conecta seu cliente MCP ao servidor MCP incluído no aplicativo de desktop Wuniq instalado:

MCP-compatible AI or IDE
          |
          v
    npx @wuniq/mcp
          |
          v
Installed Wuniq desktop app
          |
          v
Local projects and .wuniq knowledge

O Wuniq Knowledge Engine em si não está contido neste repositório e não é distribuído via npm. A licença MIT neste repositório se aplica apenas ao launcher.

Instalar e conectar

  1. Instale o aplicativo de desktop Wuniq gratuito usando um link de download oficial de wuniq.com.
  2. Adicione Wuniq pela galeria do registro MCP do seu IDE, quando suportado, ou configure manualmente:
{
  "mcpServers": {
    "wuniq": {
      "command": "npx",
      "args": ["-y", "@wuniq/mcp"]
    }
  }
}

Já tem o aplicativo instalado? Você também pode apontar sua configuração MCP diretamente para o comando wuniq-mcp colocado no seu PATH pela instalação oficial do Wuniq. Ambos os métodos conectam ao mesmo mecanismo local.

Instruções por IDE e disponibilidade atual de plataformas são mantidas em wuniq.com.

OpenCode

OpenCode usa um arquivo opencode.json no nível do projeto. Adicione Wuniq sob a chave mcp, mantendo quaisquer provedores, permissões ou outros servidores MCP já presentes:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "wuniq": {
      "type": "local",
      "command": ["npx", "-y", "@wuniq/mcp"],
      "enabled": true,
      "timeout": 30000
    }
  }
}

Em seguida, adicione o fluxo de trabalho Wuniq ao AGENTS.md do projeto sem remover instruções existentes:

# Wuniq KE (Knowledge Engine)

At 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.

Before working on any code file, `read` its Wuniq sidecar for context. After changing code, run `sync`.

Esta rota foi validada no Windows com OpenCode Desktop 1.18.4, Wuniq 1.15.1 e @wuniq/mcp 1.0.1. A conexão MCP e as chamadas open, read e sync funcionaram corretamente. Os modelos variam em quão confiavelmente agem em AGENTS.md sem solicitação, então open list pode sempre ser solicitado explicitamente.

Veja o guia completo de integração Wuniq + OpenCode para verificação, instruções para Linux, modo Precise e solução de problemas.

Plugin Claude

A raiz do repositório também é um plugin Claude. Ele não contém um segundo servidor MCP: .mcp.json inicia o launcher @wuniq/mcp publicado, que conecta Claude ao servidor MCP dentro do aplicativo Wuniq instalado.

O plugin inclui uma skill compacta que ensina ao Claude o fluxo de trabalho seguro do Wuniq: descobrir projetos visíveis primeiro, ler o contexto antes de trabalhar, preservar decisões confirmadas e sincronizar após mudanças. Ele não pré-aprova ferramentas nem eleva permissões.

Antes da submissão ao marketplace, o plugin pode ser verificado e carregado localmente com Claude Code:

claude plugin validate --strict .
claude --plugin-dir .

Plugin Codex

O mesmo repositório também é um plugin Codex. Seu .codex-plugin/plugin.json reutiliza a mesma skill e .mcp.json; ele inicia @wuniq/mcp localmente e não cria um serviço hospedado nem envia dados do projeto.

Adicione o marketplace público Wuniq pelo Codex:

codex plugin marketplace add Wuniq/wuniq-mcp --ref main

Em seguida, abra o diretório Plugins no aplicativo de desktop ChatGPT, selecione o marketplace Wuniq e instale Wuniq. Inicie uma nova sessão Codex após a instalação para que a skill e o servidor MCP sejam carregados.

ChatGPT na web não pode executar este servidor MCP stdio local. A integração completa do Wuniq é, portanto, para clientes Codex locais: o aplicativo de desktop ChatGPT, Codex CLI e a extensão Codex para IDE.

Plugin Antigravity

A raiz do repositório é um plugin nativo Antigravity. Seu mcp_config.json inicia o launcher @wuniq/mcp publicado, enquanto skills/wuniq/SKILL.md fornece o fluxo de trabalho seguro do Wuniq. Ele não contém um segundo servidor MCP nem envia dados do projeto.

Instale-o no Antigravity CLI a partir do repositório público:

agy plugin install https://github.com/Wuniq/wuniq-mcp

No Antigravity 2.0, Wuniq também pode ser configurado como um servidor MCP personalizado com o mesmo comando npx -y @wuniq/mcp enquanto sua listagem na MCP Store está em revisão.

Extensão Gemini CLI

A raiz do repositório também é uma extensão Gemini CLI. Seu gemini-extension.json inicia o mesmo launcher @wuniq/mcp publicado, enquanto skills/wuniq/SKILL.md fornece o fluxo de trabalho seguro do Wuniq como uma Agent Skill. Ele não contém um segundo servidor MCP nem envia dados do projeto.

Instale-o diretamente do repositório público:

gemini extensions install https://github.com/Wuniq/wuniq-mcp

Reinicie o Gemini CLI após a instalação para que a extensão e suas ferramentas MCP sejam carregadas.

O Google migrou usuários pessoais, Pro e Ultra do Gemini CLI para o Antigravity CLI. A extensão Gemini CLI permanece disponível para ambientes Enterprise, Google Cloud e baseados em API suportados.

Exemplos de prompts

  • "Abra os projetos Wuniq visíveis para você e resuma o contexto importante para esta tarefa."
  • "Antes de modificar o módulo de autenticação, leia o contexto Wuniq dele e preserve as restrições já decididas."
  • "Registre a decisão que acabamos de tomar, implemente a mudança e execute a sincronização Wuniq ao terminar."

Solução de problemas

  • O aplicativo Wuniq está ausente: instale-o apenas pelos links oficiais em wuniq.com e inicie uma nova sessão Claude, Codex, Antigravity ou Gemini CLI.
  • open list não retorna projetos: abra o projeto pretendido na interface desktop do Wuniq e peça ao seu cliente de IA para tentar novamente.
  • O launcher não consegue iniciar: confirme que Node.js e npx estão disponíveis, ou use a configuração direta por cliente documentada em wuniq.com.

Como o launcher funciona

O launcher passa a entrada e saída padrão do cliente MCP diretamente para o servidor MCP incluído no aplicativo instalado. Se Wuniq não estiver instalado, ele expõe apenas uma resposta MCP mínima explicando como obter o aplicativo oficial.

Ele não configura IDEs, não contém lógica de produto Wuniq, não envia dados do projeto nem fornece um segundo Knowledge Engine.

Segurança

Instale Wuniq apenas por links publicados em wuniq.com. Não use espelhos de terceiros ou instaladores reempacotados.

Para relatar um problema de segurança, use o relatório privado de vulnerabilidades deste repositório em vez de abrir um problema público. Veja SECURITY.md.

Links

Licença

O launcher MCP e os wrappers Claude, Codex, Antigravity e Gemini CLI neste repositório são licenciados sob a Licença MIT. O aplicativo de desktop Wuniq e o Knowledge Engine são softwares separados e não são cobertos pela licença deste repositório.