À propos du projet
herdr-mise est un visualiseur localhost qui représente les agents de codage IA comme des commis de cuisine en pixel-art travaillant dans une seule cuisine de restaurant. L'état des agents, le rail des tickets, le passe, le tableau des 86 et les lumières de la cuisine forment une peau lisible d'un coup d'œil au-dessus d'un petit flux JSON versionné. Le projet déclare clairement qu'il ne contrôle pas les agents, ne rend pas leur sortie et n'agrège pas de serveurs distants : c'est une fenêtre, pas un bureau.
Ce que c'est
- Un binaire statique unique servant un client navigateur TypeScript sur http://127.0.0.1:8686 et, avec --tui, une cuisine terminal native.
- Une projection en lecture seule de l'état Herdr local. Il n'approuve, n'invite, ne tue ni n'inspecte la sortie des agents.
- Un outil mono-machine, pas un tableau de bord distant, une boîte de réception de notifications, un journal de session ou un agrégateur multi-hôtes.
Modes d'exécution
- Démo : des commis déterministes restent visiblement étiquetés pendant que le serveur réessaie une source Herdr manquante, expirée, non prise en charge ou incompatible.
- Live : un instantané compatible remplace atomiquement la liste de démo sans redémarrage du processus ni du navigateur.
- Déconnecté : le silence du navigateur fait apparaître un état GAS LEAK — SERVICE SUSPENDED, puis se reconnecte via un nouvel instantané.
- Vide : une source live sans agents affiche un message d'attente.
Installation
- Plugin Herdr : brew install herdr, puis herdr plugin install funsaized/herdr-mise, puis invoquer l'action open. L'installateur télécharge un binaire de version épinglé et vérifié ; Node, npm, Cargo et Rust ne sont pas requis pour les utilisateurs.
- Autonome : un script d'installation curl, puis exécuter avec --tui.
- Homebrew/Linuxbrew : brew install funsaized/tap/herdr-mise. Cela installe la dépendance herdr mais n'enregistre pas de plugin Herdr.
Compatibilité
Une matrice vérifiée associe les versions de Herdr (0.7.5 à 0.9.0) aux protocoles d'instantané 17 à 22. L'autorité est compatibility/herdr.json, et un script de vérification valide le runtime, la documentation, les fixtures et la confidentialité des fixtures.
Développement
Le développement local utilise un terrain de jeu déterministe côté client uniquement (npm run dev:visual) pour le travail visuel, et une étape de bundle construit le client embarqué et le binaire de version pour le travail d'intégration. Le développement de plugins par les contributeurs peut lier une copie de travail avec herdr plugin link.
Sécurité et limitations
- Le serveur se lie uniquement à 127.0.0.1, sur 8686 par défaut ; HERDR_MISE_PORT ne change que ce port de bouclage. Les origines WebSocket du navigateur doivent correspondre au port effectif ou être explicitement ajoutées pour un proxy inverse personnel.
- Le binaire n'envoie aucune télémétrie et n'effectue aucune requête réseau sortante liée au produit. Le mode live lit uniquement la socket Unix Herdr locale.
- Les archives de version et l'installateur prennent en charge macOS arm64, macOS x86_64 et Linux x86_64 glibc. Il n'y a pas de service en arrière-plan ni de mise à jour automatique.
- Les paramètres du navigateur sont des données de site locales, et la réduction des animations est respectée.
La documentation couvre l'architecture, les opérations, les opérations de version, la contribution et une politique de sécurité. Le projet se décrit comme un projet communautaire indépendant, non affilié à l'équipe Herdr ni maintenu par elle.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.