Outils
Toutes les commandes sont écrites en Go et rangées dans cmd/ du dépôt. make install à la racine compile, teste et installe nexusctl, nexusadm, nexushelm et harnessctl, avec leurs hooks pour Claude Code ; proxyctl s’installe à part avec make -C cmd/proxyctl install.
Commandes
| Commande | Configuration | Rôle |
|---|
flowctl | Toutes | Client de l’opérateur : submit demande un run (une exécution d’un workflow ; voir le glossaire), list, get, watch le suit jusqu’à sa fin, cancel, et usage totalise les jetons par modèle. --output json produit une sortie lisible par un programme ; les codes de sortie sont stables. |
proxyctl | Poste unique | Reverse proxy Traefik local en HTTPS sur *.localhost pour tous les projets de l’ordinateur, avec des certificats mkcert : up, routes add, domains add, domains check. |
nexusadm | Homelab | Administration du cluster : node add et node remove, grant pour les accès à durée limitée, secret pour le trousseau, audit du serveur d’API, doctor pour contrôler les nœuds, log des actions faites. |
nexusctl | Homelab | kubectl avec un accès désigné, chaque appel journalisé. |
nexushelm | Homelab | helm avec un accès désigné, chaque appel journalisé, releases Helm rangées dans des Secrets. |
harnessctl | Toutes | Garde de Claude Code sur votre poste : modifications des règles de l’agent après confirmation, et dossiers hors projet ouverts à un agent pour 30 jours au plus. |
Les actions qui demandent les droits d’administration du cluster ouvrent une fenêtre de confirmation sur votre session graphique.
Composants de la suite
| Composant | Tourne dans | Rôle |
|---|
nexus-dashboard | Un service | Suit les items (unités de travail, comme une demande), affiche dans la vue « À traiter par vous » les questions que posent les runs, relance un run quand vous répondez, lit les pull requests sur Forgejo et pilote l’opérateur par son API HTTP. |
nexus-operator | Un service | Transforme les ressources WorkflowRun en Jobs Kubernetes, ou en conteneurs Docker avec son moteur docker, et suit chaque run jusqu’à sa fin. nexus-operator provision <projet> prépare les namespaces d’un projet. |
nexus-agent | Le pod de chaque run | Conteneur principal : lance AWF et remet ce qu’il en tire au collecteur, ou directement à l’opérateur sur un poste. Son code de sortie est celui d’AWF. |
nexus-collector | Le pod de chaque run (cluster) | Sidecar : reçoit sur une socket Unix les messages de l’agent et du plugin, les écrit dans son journal sur disque et les relaie à l’opérateur en gRPC avec TLS mutuel. C’est la seule sortie du pod vers le plan de contrôle. |
nexus-plugin | Dans AWF | Plugin AWF qui pousse les événements d’un run et porte les opérations ask et report. |
nexus-exec | Le pod d’un run avec une stack | Exécute un programme dans un autre conteneur du pod, avec son entrée, sa sortie et son code de sortie. |
Workflows
| Pack | Contenu |
|---|
openspec-tdd | Pack gplanchat/awf-workflow-openspec-tdd, version épinglée dans deploy/runner/Dockerfile et installée dans l’image des runs : des changes OpenSpec avec une relecture Elephant Goldfish Model (EGM) dans les phases de conception et un test écrit avant le code. |
packs/factory | ask, apply-change, apply-many, apply-task, tdd-slice et free-task : appliquent des changes OpenSpec en parallèle, un worktree par change, un cycle qui commence par les tests pour chaque tâche, les fusions une à une et un rapport JSON. Installation : bash packs/factory/install.sh. |
Infrastructure
| Dossier | Contenu |
|---|
compose.yaml | La configuration poste unique. |
infra/ | Playbook et rôles Ansible de la configuration homelab : système de base, MicroK8s, Kueue, pare-feu, DNS, autorité de certification, WireGuard, machine de sauvegarde. |
deploy/helm/nexus-factory | Chart Helm des configurations sur cluster. |
api/ | Contrat OpenAPI du tableau de bord. |