/ Diretório / Playground / mex
← Todos os servidores ↗ GitHub
● Comunidade theDakshJaitly ⚡ Instantâneo

mex

por theDakshJaitly · theDakshJaitly/mex

Scaffold de memória de projeto + detector de deriva — mantém agentes de codificação IA ancorados no estado real do seu projeto, não em um snapshot de ontem.

mex instala um scaffold estruturado de memória no seu repositório (arquitetura, convenções, trabalho em andamento, bloqueadores) e vem com uma CLI que detecta deriva entre a memória e a realidade. Quando mudanças no código contradizem a memória, a CLI sinaliza para você atualizar ou re-alinhar. Leve — feito para viver no repositório e viajar com o time.

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

pronto

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mex-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/theDakshJaitly/mex",
        "~/.claude/skills/mex"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mex-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/theDakshJaitly/mex",
        "~/.claude/skills/mex"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mex-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/theDakshJaitly/mex",
        "~/.claude/skills/mex"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mex-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/theDakshJaitly/mex",
        "~/.claude/skills/mex"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mex-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/theDakshJaitly/mex",
        "~/.claude/skills/mex"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json
{
  "context_servers": {
    "mex-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/theDakshJaitly/mex",
          "~/.claude/skills/mex"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add mex-skill -- git clone https://github.com/theDakshJaitly/mex ~/.claude/skills/mex

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: mex

Configurar a memória do projeto no início de um projeto

👤 Donos de novos repositórios ⏱ ~25 min beginner

Quando usar: Dia 1 de um projeto; você quer que os agentes se integrem rápido.

Pré-requisitos
  • Skill instalada — git clone https://github.com/theDakshJaitly/mex ~/.claude/skills/mex
Fluxo
  1. Inicializar
    Use mex. Initialize project memory with sections: architecture, conventions, in-flight, blockers.✓ Copiado
    → Scaffold /.mex/ criado com templates
  2. Preencher os dados iniciais
    Auto-extract architecture from existing code and a starter convention list.✓ Copiado
    → Seções preenchidas com conteúdo inicial
  3. Definir frescor
    Mark each section verified today.✓ Copiado
    → Marcadores de frescor definidos

Resultado: Novo projeto começa com contexto compartilhado para agentes.

Armadilhas
  • Auto-extração captura detalhes irrelevantes — Corte implacavelmente — a memória é para princípios, não para grep
Combine com: filesystem

Encontrar onde a memória do projeto discorda do código

👤 Donos de projetos de longa duração ⏱ ~30 min intermediate

Quando usar: A memória foi configurada há meses; ninguém tem certeza de quão desatualizada está.

Fluxo
  1. Executar detecção de deriva
    Use mex. Run drift detection. Report claims that no longer match reality.✓ Copiado
    → Relatório de deriva com afirmação ↔ evidência
  2. Atualizar ou remover
    For each drift, decide: update memory or fix the code (claim was right and reality drifted).✓ Copiado
    → Decisão por item; PRs abertos para correções no lado do código
  3. Re-verificar
    After resolving, mark sections verified today.✓ Copiado
    → Memória alinhada novamente

Resultado: A memória permanece um contrato confiável, não folclore.

Armadilhas
  • Detector de deriva sinaliza de forma muito agressiva — Ajuste --strictness; use 'medium' para projetos em evolução
Combine com: github

Passar trabalho em andamento entre membros do time

👤 Devs entrando de férias / saindo ⏱ ~20 min beginner

Quando usar: Você tem 3 features em progresso e alguém precisa assumir.

Fluxo
  1. Capturar o trabalho em andamento
    Use mex. For each open branch, write an in-flight entry: goal, current state, next steps, gotchas.✓ Copiado
    → Entradas em /.mex/in-flight/
  2. Verificar com a CLI
    Run drift on in-flight; ensure entries reflect actual branch state.✓ Copiado
    → Sem deriva
  3. Passar
    Generate a teammate-ready summary linking each entry to its branch.✓ Copiado
    → Resumo pronto para Slack/e-mail

Resultado: Passagem tranquila; sem arqueologia necessária.

Armadilhas
  • Entradas em andamento vagas ('trabalhando em X') — Obrigue o campo 'próximos passos' do template; concreto ou não ajuda

Combinações

Combine com outros MCPs para 10× de alavancagem

mex-skill + filesystem

Memória vive no repositório; faça commit

Commit /.mex/ to git so memory travels with the codebase.✓ Copiado
mex-skill + github

Verificação de deriva no CI em PRs

On every PR, run mex drift and post the report as a PR comment.✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
init scaffold_options Uma vez por projeto 0
drift section?, strictness? Semanal / antes de mesclar branches de longa duração 0 (usa verificações locais + LLM para afirmações fuzzy)
verify section Após atualizar a memória para corresponder à realidade 0
in_flight_add branch, goal, next_steps Ao iniciar uma branch de feature 0
summary format Handoff / relatório de status 0

Custo e limites

O que custa rodar

Cota de API
Nenhuma — local
Tokens por chamada
Deriva usa LLM para afirmações fuzzy; limitado por execução
Monetário
Gratuito
Dica
Use strict=high no CI para capturar deriva real; medium para verificações locais diárias

Segurança

Permissões, segredos, alcance

Escopos mínimos: filesystem-write
Armazenamento de credenciais: Nenhuma
Saída de dados: Nenhuma a menos que o LLM de deriva seja configurado para provedor remoto

Solução de problemas

Erros comuns e correções

Deriva reporta falsos positivos

Reduza o strictness; ou refine a formulação das afirmações para torná-las mais verificáveis

Memória cresce sem limite

Cada seção tem um limite suave; consolide periodicamente — mantenha princípios, arquive específicos

CLI não encontra /.mex/

Execute a partir da raiz do repositório; ou passe --root <path>

Auto-extração perde invariantes importantes

Auto-extração é ponto de partida; escreva manualmente os invariantes load-bearing

Alternativas

mex vs. outros

AlternativaQuando usarTroca
claude-mem-skillVocê quer continuidade de sessão, não memória de conhecimento de projetoProblema diferente; mex é para invariantes no nível do projeto
CLAUDE.md puroProjeto pequeno, sem necessidade de detecção de derivaSem estrutura; sem verificações automáticas de frescor
pilot-shell-skillVocê quer spec/plan/gates mais persistência de conhecimentoSuperfície de fluxo de trabalho maior; mais opinioso

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills