Zeus
Manages local Git clones by scanning repositories, resolving remotes/origin, checking readiness and dirty state, and performing fetch and fast-forward updates.
Tracks GitHub accounts, organizations, and repositories for the fleet, including CI/PR status, cloning new repos into account-based folders, and mapping local clones to their GitHub origins.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Zeus
Suivre et piloter une flotte de repos git depuis une page locale : les repos de tes comptes GitHub, leurs clones sur la machine, de quoi les cloner et les mettre à jour, et les outils transverses qui vont avec.
npx @vincweb/zeus # ouvre la pageIl lui faut Node 20 ou plus, git, et gh connecté à ton compte
(gh auth login). Aucune dépendance à l'exécution.
Un scope npm n'a qu'un registre par machine. Là où ~/.npmrc envoie @vincweb ailleurs que sur
npm — vers GitHub Packages, pour des paquets privés — la commande ci-dessus répond 404, et il faut
nommer le registre :
npx --@vincweb:registry=https://registry.npmjs.org @vincweb/zeusPour travailler sur Zeus lui-même, il se lance depuis les sources :
pnpm install && pnpm build
node dist/cli.js # depuis le dossier de tes projets, ou n'importe où dessous
pnpm link --global # ou : la commande `zeus`, partout sur cette machineLe modèle : un dossier parent, et rien à classer
Zeus ne demande qu'une chose : le dossier parent de tes projets. Tout le reste est lu là où il vit, et rien n'est tenu à la main :
Quoi | D'où ça vient |
tes workspaces | de |
les repos d'un workspace | de GitHub : ceux que ce compte possède |
les clones | d'un scan du dossier parent, chaque clone rattaché à son repo par son remote |
où va un nouveau clone | dans |
Il n'y a donc pas de seconde organisation à garder alignée sur la première : un repo de acme est
dans le workspace acme, et s'il est au mauvais endroit, ça se corrige sur GitHub. Les clones
existants ne bougent pas — Zeus les retrouve où qu'ils soient sous le dossier parent.
.zeus/
zeus init (ou la page, la première fois) pose un dossier .zeus/ à la racine du dossier parent.
Il marque la racine : lancé dans n'importe quel sous-dossier, Zeus remonte jusqu'à lui, comme
git jusqu'à .git. Aucun chemin n'est donc écrit nulle part, et le même dossier fonctionne tel
quel sur une autre machine.
Il peut rester vide. .zeus/config.json, facultatif, ne contient que ce que personne d'autre ne
peut savoir :
{
"hiddenOwners": ["une-grosse-org"],
"folders": { "Vincweb": "perso" },
"tools": [
{
"id": "mon-outil",
"scope": "repo",
"run": "npx mon-outil",
"install": { "kind": "dev-dependency", "package": "mon-outil" },
"detect": { "dependency": "mon-outil" }
}
]
}hiddenOwners — des comptes que
ghvoit et que ce dossier laisse de côté. Se règle aussi depuis la page (« Comptes suivis… »).folders — le dossier des nouveaux clones d'un compte, quand ce n'est pas le nom du compte.
tools — des outils transverses en plus de ceux par défaut (code-atlas, claude-context-viewer) ; un outil qui reprend l'
idd'un outil par défaut le remplace.scanDepth (3), includeArchived (
false).
Related MCP server: GitHub Repos Manager MCP Server
Les outils transverses
Zeus liste les outils qui servent à plusieurs projets, dit où chacun est en place, et l'installe
d'un clic. Un outil a une portée (scope) et, pour le clic, une recette (install) :
Recette | Ce qu'un clic lance | Où |
|
| Claude Code |
|
| la machine |
| l'ajout en dépendance de développement, avec le gestionnaire du repo choisi — bun, pnpm, yarn ou npm selon son lockfile | un clone |
Une recette ne nomme qu'un paquet ou un plugin, jamais une commande : les trois formes sont fixes,
et un nom qui n'est pas qu'un nom (--registry=…, a; b) est refusé à la lecture de la config.
La page montre les commandes avant de les lancer, puis ce que chacune a répondu.
Dans un clone, l'installation est refusée s'il a des fichiers modifiés — pour que l'ajout reste
lisible — et laisse package.json et le lockfile modifiés, à commiter dans ce repo. Un install
écrit comme une simple chaîne reste une commande à copier.
Détection (detect) : files ou dependency dans un clone, plugin parmi les plugins installés
de Claude Code, command sur le PATH.
Ce que fait Zeus — et ce qu'il ne fait pas
Zeus est un orchestrateur. La règle qui trace la frontière :
Ce qui se calcule en regardant un seul repo appartient à l'outil de ce repo (code-atlas pour un projet TypeScript). Ce qui demande plusieurs repos, ou ne porte pas sur le code, appartient à Zeus.
Zeus sait donc quels repos existent, où sont leurs clones, s'ils sont en retard, ce que dit la CI, quels outils sont en place. Il ne lit ni lockfile ni code : un score, des dépendances périmées, un audit — c'est code-atlas qui les calcule, et Zeus qui les rassemble.
La page
Accueil — ce qu'est Zeus, les dossiers déjà suivis, et comment l'installer ailleurs. Lancé dans un dossier suivi (ou dessous), Zeus ouvre directement sa flotte.
Choisir un dossier (
/setup) — pour une machine qui n'a jamais vu Zeus :git,gh, le compte connecté, le mode de clonage ; puis le dossier parent ; puis les comptes détectés. Zeus constate et dit quoi lancer (gh auth login) : il ne connecte personne.La flotte (
/fleet?root=…) — un onglet par workspace, six chiffres qui filtrent, le tableau des repos rangés par dossier, les outils, et les autres dossiers git trouvés sous la racine (sans remote, hors GitHub, d'un autre compte, plus listés par GitHub) avec la raison de chacun.
Un gros compte est listé tout de suite et détaillé ensuite : la CI et les PR de ses repos non clonés arrivent quelques secondes après, sans retenir la page.
Commandes
Commande | Effet |
| ouvre la page : sur ta flotte, sinon sur l'accueil |
| fait d'un dossier le dossier parent ( |
| l'état de chaque repo, en tableau |
| le même, en un document — pour un script ou un agent |
| clone un repo suivi, dans le dossier de son compte |
| fetch, puis avance rapide là où rien ne s'y oppose |
| installe un outil transverse |
| sert la flotte à un agent (MCP, sur stdio) |
-r, --root <dir> nomme le dossier parent ; à défaut ZEUS_ROOT, sinon celui qui contient
.zeus/ en remontant depuis le dossier courant.
Avec Claude Code
Zeus se branche à Claude Code comme serveur MCP : une session ouverte sur le dossier parent
connaît alors la flotte, au lieu de la reconstituer avec git et gh.
claude mcp add -s project zeus -- npx -y --@vincweb:registry=https://registry.npmjs.org @vincweb/zeus mcpLe registre y est nommé exprès : la commande marche alors sur toute machine, quel que soit son
~/.npmrc.
-s project écrit .mcp.json dans le dossier parent. La page donne la commande exacte tant que
ce n'est pas fait, et Claude Code demande ton accord la première fois.
Outil | Ce qu'il répond |
| les repos suivis, une ligne chacun : workspace, chemin du clone, état, modifs en cours, CI, « prêt » ou non — par compte ( |
| un repo en entier, et pourquoi son clone n'est pas prêt quand il ne l'est pas |
| les workspaces, où vont leurs nouveaux clones, les outils en place, les autres dossiers git |
| fetch puis avance rapide — écrit sur le disque |
| clone un repo dans le dossier de son compte — écrit sur le disque |
| installe un outil transverse, dans Claude Code, sur la machine ou dans un clone — écrit sur le disque |
Le partage des rôles : Zeus dit où et dans quel état, Claude Code ouvre les conversations.
La session du dossier parent est l'orchestratrice ; pour travailler dans un repo, elle ouvre une
session sur le path que Zeus lui donne, qui charge alors le CLAUDE.md et les outils de ce repo.
Zeus ne lance aucun agent lui-même.
Le .mcp.json du dossier parent est aussi vu depuis ses sous-dossiers : claude mcp list, lancé
dans un projet, liste le serveur zeus du dossier au-dessus. La commande qu'il déclare doit donc
marcher de partout — un chemin absolu, ou npx — et zeus mcp retrouve la racine en remontant.
Ne mets pas de CLAUDE.md d'orchestration à la racine du dossier parent : il serait chargé dans
les sessions de tous les projets en dessous. Une skill dans .claude/skills/ n'a pas ce défaut.
Mettre à jour, sans surprise
« Mettre à jour » fait un git fetch --prune, puis une avance rapide vers la branche suivie —
et seulement une avance rapide. Jamais de merge, de rebase ni de stash :
Situation du clone | Ce qui se passe |
propre, en retard | avancé jusqu'à la branche distante |
des fichiers suivis modifiés | récupéré, branche laissée où elle était |
des commits locaux et distants | récupéré, signalé comme divergé |
une branche qui ne suit rien | récupéré, rien d'autre |
Des fichiers non suivis ne bloquent pas : git refuse lui-même l'avance s'ils devaient être écrasés.
Les clones se font en SSH quand GitHub reconnaît une clé sur la machine, en HTTPS sinon — git
emprunte alors la connexion de gh. C'est un fait de la machine : il se constate, il ne s'écrit
dans aucune config.
Sécurité
La page peut lancer git clone et git fetch : elle n'obéit qu'à elle-même.
Le serveur écoute sur
127.0.0.1et ne répond qu'àlocalhost(pas de DNS rebinding).Une action est un
POSTen JSON, refusé à toute autre origine que la page.Une action ne reçoit qu'un identifiant
owner/name: l'URL et le chemin viennent de ce que le serveur a lui-même lu sur GitHub et sur le disque. La destination d'un clone est le dossier du compte, un dossier existant, ou quelques noms simples vérifiés un à un — toujours sous la racine.Écarter ou suivre un compte ne nomme que des comptes que ton
gha listés.Aucun shell, aucune invite : une commande qui demanderait un mot de passe échoue au lieu d'attendre.
Installer un outil ne nomme qu'un outil et, au plus, un repo : ce qui tourne est la recette que le serveur tient pour cet outil, dans un clone qu'il a lui-même trouvé.
Zeus ne garde aucun jeton, ne crée aucun dépôt et ne pousse rien.
Publier
Même circuit que code-atlas : un tag v* lance .github/workflows/release.yml, qui vérifie,
empaquette, crée la release GitHub avec l'archive, puis publie sur npm sans jeton (publication de
confiance).
L'archive jointe à chaque release se lance aussi sans registre : npx <URL de l'archive>.
Le paquet garde le nom @vincweb/zeus, sur npm public. Comme ce scope sert aussi à des paquets
privés sur GitHub Packages, publishConfig épingle le registre du scope : sans lui, npm publish
et pnpm publish enverraient Zeus vers le registre que ~/.npmrc donne à @vincweb.
Sortir une version : monter version dans package.json, puis pousser le tag v<version>.
La 0.1.0 a été publiée à la main. Pour que les tags publient seuls, il reste à déclarer la
publication de confiance sur npmjs.com, dans les paramètres du paquet : utilisateur Vincweb,
dépôt zeus, workflow release.yml, en y autorisant npm publish. Sans cette autorisation, npm
n'accepte de ce workflow que npm stage publish, dont chaque version attend une approbation.
Pour publier à la main : npm login — sans --scope, qui réécrirait le registre de @vincweb
dans ~/.npmrc — puis npm publish.
Licence
MIT.
Développement
pnpm dev --root .. # API sur :4900 avec rechargement, page sur :4901
pnpm check # lint, types, tests, buildMême squelette que claude-context-viewer et code-atlas : serveur http de Node sans dépendance,
page React + Vite + Tailwind, tsup pour la CLI, node:test pour les tests.
Et ensuite
lancer
code-atlas --check --format jsonsur chaque repo et afficher les scores ;les services autour des repos : déploiements, quotas ;
un bilan « prêt à changer de machine » : ce qui n'est pas encore sur GitHub.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Repository knowledge graph MCP server for codebase understanding and debugging.
A MCP server built for developers enabling Git based project management with project and personal…
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
Read-only MCP server for repository context: context packs, graph impact analysis, and validation.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server for gitingest. It allows MCP clients like Claude Desktop, Cursor, Cline etc to quickly extract information about Github repositories including repository summaries, project directory structure, file contents, etc3138MIT
- AlicenseNot gradedqualityDmaintenanceGitHub Repos Manager MCP Server that enables your MCP client (e.g., Claude Desktop, Roo Code, etc.) to interact with GitHub repositories using your GitHub personal access token.22MIT
- AlicenseAqualityDmaintenanceLocal MCP server for safe GitHub developer workflows. Enables pulling main, creating feature branches, pushing them, and opening ready-for-review pull requests via tools like github_create_feature_branch and github_create_pull_request.6MIT
- AlicenseBqualityDmaintenanceExposes CodeGraph capabilities for multiple local repositories to MCP-compatible AI coding assistants, enabling multi-repo code exploration and cross-repo symbol tracing.51MIT