Stagent : Couche opérationnelle open-source pour le SDK Agent Claude avec gouvernance locale et orchestration de flux de travail

Ce que fait Stagent

Stagent est un espace de coordination open-source, local-first, qui repose sur le SDK Agent Claude et l'API Claude. Il standardise la manière dont vous acheminez, supervisez et mesurez le travail des agents sur les deux environnements d'exécution sans les remplacer. Le problème central qu'il résout : vous ne devriez pas avoir besoin d'un tableur pour suivre ce que font vos agents IA, ce qu'ils coûtent, ou s'ils ont l'autorisation d'exécuter des commandes dangereuses.

Fonctionnalités clés et architecture

Le système comprend 15 interfaces produit : tableau de bord d'accueil, tableau d'exécution, boîte de réception, surveillance, registre des coûts, chat, scanner d'environnement, et plus encore. Il fournit 6 modèles d'orchestration de workflow : séquence, branchement parallèle/regroupement, point de contrôle, planificateur-exécuteur, boucle autonome et essaim multi-agents. Il existe plus de 52 profils d'agents réutilisables, incluant des personnalités spécialisées comme réviseur de code, chercheur, rédacteur de documents, gestionnaire de patrimoine et planificateur de voyages, regroupés en tant que compétences Claude Code avec des politiques d'outils et des instructions comportementales.

La gouvernance avec intervention humaine comprend des autorisations "autoriser une fois", "toujours autoriser" et "refuser". Chaque demande d'outil passe par une file d'attente de notifications, avec AskUserQuestion qui sollicite toujours une réponse, quelles que soient les autorisations enregistrées. Les garde-fous budgétaires fournissent des plafonds de dépenses quotidiens/mensuels qui bloquent tout nouvel appel au fournisseur lorsqu'ils sont dépassés, avec des avertissements à 80 % et l'achèvement gracieux des travaux déjà en cours.

Le registre des coûts multi-environnements suit la vélocité des tokens, la concentration des modèles, la répartition par environnement d'exécution et les pistes d'audit par tâche pour Claude et Codex dans une vue unique. Les exécutions planifiées prennent en charge les prompts récurrents ou ponctuels avec sélection de profil d'agent, limites de déclenchement et fenêtres d'expiration.

Implémentation technique

L'ensemble du produit a été construit en utilisant Claude Code avec Opus, du schéma de base de données aux composants d'interface utilisateur. L'architecture est local-first avec zéro dépendance externe, utilisant SQLite en mode WAL avec Drizzle ORM (16+ tables). Tout s'exécute sur votre machine sans cloud ni télémétrie.

Le système d'approbation utilise la table de notifications comme une file de messages. Lorsqu'un agent demande un outil dangereux, canUseTool interroge la table de notifications jusqu'à ce qu'un humain réponde, permettant la gouvernance sans websockets ni files d'attente externes.

Les modèles de workflow incluent des boucles autonomes qui exécutent les agents de manière itérative, chaque itération voyant la sortie précédente (inspiré du concept de "laboratoire de recherche à un GPU" de Karpathy), des essaims multi-agents utilisant un modèle Maire→Ouvriers→Raffinerie avec concurrence limitée (2-5 ouvriers) et nouvelle tentative au niveau de l'étape, et un branchement parallèle/regroupement qui divise les questions de recherche entre branches et synthétise les résultats.

Le catalogue de modèles signifie que vous ne configurez jamais manuellement les workflows. Vous choisissez un modèle (revue de code, recherche approfondie, planification de sprint), remplissez les variables, et le modèle résout automatiquement les profils, les prompts et les étapes conditionnelles.

Le scanner d'environnement découvre tous vos artefacts Claude Code et Codex CLI — compétences, hooks, serveurs MCP, permissions, fichiers de mémoire — et présente un score de santé unifié, les analyses typiques prenant 10-50 ms.

Pile technologique

Next.js 16, React 19, TypeScript, Tailwind v4, shadcn/ui, SQLite, Drizzle ORM, SDK Agent Claude, Codex App Server.