mex (Claude Skill) — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Scaffold de mémoire structuré : architecture / conventions / en cours / blocages
CLI de dérive comparant les affirmations de mémoire avec le code/tests réels
Marqueurs de fraîcheur par section (date de dernière vérification)
Conçu pour une utilisation humaine + agent partagée ; les deux lisent les mêmes fichiers
Fonctionne bien avec CLAUDE.md / AGENTS.md

Démo en direct

Aperçu en pratique

prêt

Installer

Choisissez votre client

~/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
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : mex

Configurer la mémoire projet au démarrage d'un projet

👤 Propriétaires de nouveaux dépôts ⏱ ~25 min beginner

Quand l'utiliser : Jour 1 d'un projet ; vous voulez que les agents montent en vitesse rapidement.

Prérequis

Skill installé — git clone https://github.com/theDakshJaitly/mex ~/.claude/skills/mex

Déroulement

Initialiser

Use mex. Initialize project memory with sections: architecture, conventions, in-flight, blockers.✓ Copié

→ Scaffold /.mex/ créé avec templates
Remplir les amorces

Auto-extract architecture from existing code and a starter convention list.✓ Copié

→ Sections amorcées avec contenu de démarrage
Définir la fraîcheur

Mark each section verified today.✓ Copié

→ Marqueurs de fraîcheur définis

Résultat : Nouveau projet démarrant avec un contexte agent partagé.

Pièges

L'auto-extraction capture des détails non pertinents — Élaguer impitoyablement — la mémoire est pour les principes, pas pour grep

Combiner avec : filesystem

Trouver où la mémoire projet est en désaccord avec le code

👤 Propriétaires de projets de longue durée ⏱ ~30 min intermediate

Quand l'utiliser : La mémoire a été configurée il y a des mois ; personne n'est sûr du degré de péremption.

Déroulement

Exécuter la détection de dérive

Use mex. Run drift detection. Report claims that no longer match reality.✓ Copié

→ Rapport de dérive avec affirmation ↔ evidence
Mettre à jour ou supprimer

For each drift, decide: update memory or fix the code (claim was right and reality drifted).✓ Copié

→ Décision par item ; PRs ouvertes pour les corrections côté code
Re-vérifier

After resolving, mark sections verified today.✓ Copié

→ Mémoire réalignée

Résultat : La mémoire reste un contrat fiable, pas du folklore.

Pièges

Le détecteur de dérive signale trop agressivement — Ajuster --strictness ; utiliser 'medium' pour les projets actifs

Combiner avec : github

Transmettre le travail en cours entre membres de l'équipe

👤 Développeurs partant en vacances / quittant ⏱ ~20 min beginner

Quand l'utiliser : Vous avez 3 fonctionnalités en cours et quelqu'un d'autre doit les reprendre.

Déroulement

Capturer le travail en cours

Use mex. For each open branch, write an in-flight entry: goal, current state, next steps, gotchas.✓ Copié

→ Entrées dans /.mex/in-flight/
Vérifier avec la CLI

Run drift on in-flight; ensure entries reflect actual branch state.✓ Copié

→ Dérive propre
Transmettre

Generate a teammate-ready summary linking each entry to its branch.✓ Copié

→ Transmission prête pour Slack/email

Résultat : Reprise fluide ; pas d'archéologie requise.

Pièges

Entrées en cours vagues («travaille sur X») — Forcer le champ «prochaines étapes» du template ; concret ou ça n'aide pas

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

mex-skill + filesystem

La mémoire vit dans le dépôt ; la committer

Commit /.mex/ to git so memory travels with the codebase.✓ Copié

mex-skill + github

Vérification CI de dérive sur les PRs

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

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
init	scaffold_options	Une fois par projet	0
drift	section?, strictness?	Hebdomadaire / avant de merger des branches de longue durée	0 (utilise des vérifications locales + LLM pour les affirmations floues)
verify	section	Après mise à jour de la mémoire pour correspondre à la réalité	0
in_flight_add	branch, goal, next_steps	Quand on démarre une branche de fonctionnalité	0
summary	format	Transmission / rapport de statut	0

Coût et limites

Coût d'exécution

Quota d'API: Aucun — local
Tokens par appel: La dérive utilise LLM pour les affirmations floues ; plafonné par exécution
Monétaire: Gratuit
Astuce: Utiliser strict=high en CI pour détecter la vraie dérive ; medium pour les vérifications locales quotidiennes

Sécurité

Permissions, secrets, portée

Portées minimales : filesystem-write

Stockage des identifiants : Aucun

Sortie de données : Aucun sauf si le LLM de dérive est configuré vers un fournisseur distant

La mémoire contient des détails d'architecture — ajouter /.mex/ dans .gitignore si le dépôt est privé et vous avez des forks publics

Dépannage

Erreurs courantes et correctifs

La dérive rapporte des faux positifs

Baisser la rigueur ; ou affiner la formulation des affirmations pour les rendre plus vérifiables

La mémoire croît sans limites

Chaque section a un plafond souple ; consolider périodiquement — garder les principes, archiver les spécificités

La CLI ne trouve pas /.mex/

Exécuter depuis la racine du dépôt ; ou passer --root <chemin>

L'auto-extraction manque des invariants clés

L'auto-extraction est un point de départ ; écrire manuellement les invariants porteurs

Alternatives

mex vs autres

Alternative	Quand l'utiliser	Compromis
claude-mem-skill	Vous voulez la continuité de session, pas la mémoire de connaissances projet	Problème différent ; mex est pour les invariants au niveau projet
CLAUDE.md simple	Petit projet, pas besoin de détection de dérive	Pas de structure ; pas de vérifications de fraîcheur automatiques
pilot-shell-skill	Vous voulez spec/plan/portes plus persistance de connaissance	Surface de workflow plus grande ; plus opinioné

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills