# Vigie — superviseur de serveurs de dev locaux pour agents IA

> Vos agents relancent sans cesse le même serveur. Vigie le lance une seule fois. Ensuite, chaque agent, terminal et fenêtre lit le même état en direct : ce qui tourne, sur quel port, sous quel PID, et si ça répond vraiment.

- [Télécharger pour Windows](https://github.com/lyrad9/vigie/releases/latest) (version 0.1.4, installateur non signé)
- [Code source sur GitHub](https://github.com/lyrad9/vigie) (licence MIT)
- macOS et Linux : depuis les sources. Rien ne quitte votre machine.

## Un seul serveur, lu par tous vos agents

Sans Vigie, chaque agent relance son propre serveur :

- Un serveur relancé à chaque nouvelle tâche
- Des ports de repli que personne n'a notés
- Des logs éclatés entre les onglets
- Des process orphelins après chaque session

Avec Vigie, chaque agent demande avant d'agir :

- Un process par serveur, quel que soit le nombre d'agents
- L'état lu en JSON avant chaque lancement
- Un port refusé plutôt qu'un port de repli
- Toute la sortie dans une seule fenêtre
- Les serveurs plantés relancés tout seuls
- Rien n'est arrêté sans votre accord

## Gardez la main sur chaque port

- **Inspecter avant de lancer** : une commande, une réponse JSON avec les projets, serveurs, ports, PID et santé.
- **Savoir qui tient chaque port** : géré par Vigie, lancé ailleurs ou réservé au système, avec le PID et la commande.
- **Relancer ce qui tombe** : sonde TCP ou HTTP, redémarrage avec un délai croissant, puis échec signalé au bout de cinq essais avec le dernier code de sortie.
- **Lire les logs sans rouvrir de terminal** : un fichier par serveur qui survit aux redémarrages, et `vigie logs -f` pour suivre en direct.

## Votre agent lit l'état, puis décide

```bash
vigie status --json      # chaque serveur, son port, son état et sa santé
vigie resolve --json     # le serveur enregistré pour le dossier courant, et son URL
vigie port 3001 --json   # qui tient un port : Vigie, un autre programme ou le système
vigie start web          # refuse avec PORT_IN_USE si un autre programme tient le port
vigie logs web -f        # la sortie du serveur, en direct
```

Le [skill Vigie](https://github.com/lyrad9/vigie/blob/main/skill/SKILL.md) s'installe dans `~/.agents/skills` et `~/.claude/skills`. Il tient en une règle : ne jamais lancer de serveur de dev sans avoir lu l'état d'abord.

## Démarrer en trois étapes

1. **Installez Vigie** : téléchargez l'installateur pour Windows. Vigie se loge près de l'horloge et peut démarrer avec votre session.
2. **Ajoutez vos projets** : collez le chemin d'un projet, Vigie lit `package.json` et propose la commande et le port. Ou, depuis le dossier : `vigie register`.
3. **Laissez vos agents lire l'état** : installez le skill depuis le menu de l'icône, vos agents demandent à Vigie avant de lancer quoi que ce soit.

## Questions fréquentes

### Comment Vigie lance-t-il mes serveurs ?

Avec la commande que vous tapez d'habitude (`pnpm dev`, `npm run dev`, `python manage.py runserver`…), dans votre shell, avec la variable `PORT` définie. Vigie surveille ensuite le process, sa santé et sa sortie.

### Que se passe-t-il quand je ferme la fenêtre ?

Vos serveurs continuent de tourner : Vigie reste dans la zone de notification. Quitter Vigie les arrête, et ceux qui tournaient repartent au lancement suivant.

### Ça marche avec Vite, Next.js, Django, Rails… ?

Avec tout ce qui se lance par une commande. Vigie reconnaît Next.js, Vite, Astro, Nuxt, SvelteKit, Angular, Django et Rails pour pré-remplir la commande et le port. Pour Vite, gardez `--port 5173 --strictPort` afin qu'il ne bascule jamais en silence sur un autre port.

### Et sur macOS ou Linux ?

L'installateur est pour Windows. Sur macOS et Linux, Vigie se construit depuis les sources (`npm install && npm run app`) et la commande `vigie` fonctionne de la même façon.

### Quels agents sont compatibles ?

Tous ceux qui savent lancer une commande : Claude Code, Codex, Cursor ou vos propres scripts. Le skill est copié dans `~/.agents/skills` et `~/.claude/skills`. Sans skill, l'API HTTP sur `127.0.0.1:7744` suffit.

### Vigie envoie-t-il des données quelque part ?

Non. Pas de compte, pas de télémétrie. L'API écoute uniquement sur 127.0.0.1 et refuse les requêtes venant d'autres sites.

### Vigie peut-il arrêter un process tout seul ?

Jamais. Il arrête ce qu'il a lancé quand vous le demandez, et ne touche à un process lancé ailleurs qu'après une demande explicite. Les services système sont en lecture seule.

## Pages

- [À propos](https://vigie.lyrad.dev/about.md)
- [Contact](https://vigie.lyrad.dev/contact.md)
- [Confidentialité](https://vigie.lyrad.dev/privacy.md)
- [llms.txt](https://vigie.lyrad.dev/llms.txt) : ce que fait Vigie et quand un agent doit l'utiliser

Fait par [Daryl Ngako](https://lyrad.dev).