La section Agents de TskVlo permet à des agents de code de travailler sur vos dépôts git. Chaque session d’agent a sa propre branche, vous suivez en direct ce qu’elle fait, et rien n’arrive dans votre dépôt avant que vous ne le poussiez. Chaque espace de travail a son propre conteneur d’agents privé — il est créé, démarré et arrêté pour vous.
Étape 1 : ajouter un fournisseur et la clé de déploiement (admin)
- Ouvrez Paramètres de l’espace de travail → Agents
- Cliquez sur Ajouter un fournisseur, choisissez OpenCode Go, Mistral, OpenAI ou un point de terminaison compatible OpenAI, puis saisissez sa clé API. TskVlo vérifie la clé et lit les modèles du fournisseur ; choisissez un modèle par défaut par fournisseur
- Copiez la clé SSH de l’espace de travail et ajoutez-la à vos dépôts comme clé de déploiement — la lecture suffit pour cloner, l’écriture permet aux sessions de pousser et de fusionner
Le conteneur d’agents est créé en arrière-plan dès que le premier fournisseur est ajouté.
Étape 2 : créer un projet
- Ouvrez Agents dans la barre de navigation et cliquez sur Nouveau projet
- Donnez-lui un nom et le remote SSH du dépôt (
git@hôte:groupe/repo.gitoussh://git@hôte:port/groupe/repo.git), et éventuellement un groupe, une couleur et une icône - Le dépôt est cloné avec la clé de déploiement ; le projet affiche Prêt une fois terminé
Sous Règles, ajoutez des consignes permanentes — conventions de code, comment lancer les tests — que chaque agent du projet reçoit.
Étape 3 : rédiger le wiki du projet
Les agents lisent d’abord un court wiki du projet : un fichier markdown dans le dépôt (.tskvlo/wiki.md) qui explique le but, la structure et les conventions. Les sessions démarrent dès qu’il existe.
- Ouvrez l’onglet Wiki et cliquez sur Écrire avec un agent, ou rédigez-le vous-même
- Choisissez sous Taille jusqu’où il peut grandir
Le wiki est commité sur la branche par défaut pour vous.
Étape 4 : lancer une session
- Ouvrez l’onglet Sessions et cliquez sur Nouvelle session
- Choisissez le fournisseur, le modèle et la branche de base, et éventuellement un nom
- Décrivez votre besoin dans la zone de message et envoyez-le (Ctrl/Cmd + Entrée)
La transcription montre les messages de l’agent, son raisonnement, ses appels d’outils avec les diffs, son plan et les captures d’écran. Vous pouvez mettre des messages en file pendant qu’il travaille, arrêter un tour et joindre des images ou des archives zip. Ouvrez Fichiers pour consulter — ou modifier — les fichiers de la session.
Étape 5 : relire, commiter, pousser et fusionner
La barre git sous l’en-tête de la session montre sa branche et ses modifications :
- Modifications liste ce que l’agent a changé, avec les diffs
- Commiter commite en votre nom ; Générer avec l’IA écrit le message pour vous
- Terminer & pousser commite le reste, laisse si vous le souhaitez l’agent mettre à jour le wiki du projet, puis pousse la branche
- Fusionner fusionne une session poussée dans sa branche de base
L’onglet Git du projet montre toutes les branches, la session à laquelle chacune appartient et le graphe des commits.
Lancer une boucle pour les changements plus importants
Pour un travail trop grand pour une seule conversation, activez Exécuter en boucle en créant une session :
- L’orchestrateur découpe votre demande en tâches
- Relisez le plan et approuvez-le, ou dites ce qui doit changer
- De nouveaux agents traitent les tâches une à une ; l’orchestrateur vérifie chacune selon ses critères, et chaque tâche acceptée devient un commit
- Quand toutes les tâches sont acceptées, demandez-en plus ou terminez et poussez — ou laissez la boucle terminer et fusionner automatiquement
Vous pouvez mettre en pause, reprendre, réessayer une tâche bloquée, annuler, et choisir des agents distincts pour le design et en secours. Les admins définissent les agents par défaut de chaque rôle sous Paramètres de l’espace de travail → Agents → Valeurs des boucles.
Démarrer depuis une tâche
Dans l’onglet Code d’une tâche, cliquez sur Lancer une session d’agent : choisissez un projet et un modèle, et le titre, la description et les commentaires de la tâche sont envoyés comme premier message. Les commits poussés ou fusionnés sont liés à la tâche lorsque l’espace de travail a une connexion GitHub ou GitLab pour le dépôt.
Outils, processus et services de test
- Serveurs MCP : dans Paramètres de l’espace de travail → Configuration IA / LLM, un admin peut proposer un serveur MCP aux agents (avec des en-têtes ou une connexion OAuth) ; chaque projet l’active dans son onglet Paramètres, à côté du navigateur intégré avec lequel les agents ouvrent des pages et font des captures d’écran
- Processus : les agents lancent des applications avec pm2 — Agents → Processus les affiche avec leurs journaux, et vous pouvez les arrêter ou les supprimer
- Configuration d’exécution et aperçu en direct : un projet décrit les processus de son application dans
.tskvlo/run.json(commande, installation, port, environnement) — modifiez-la dans l’onglet Exécution du projet, où vous définissez aussi des secrets qui restent hors du dépôt. Dans la vue Exécution d’une session, vous les démarrez, arrêtez et redémarrez par session avec les journaux en direct, et Aperçu affiche l’application en cours d’exécution à sa propre adresse privée, à la taille d’un téléphone, d’une tablette ou d’un ordinateur, à côté du chat ou dans un onglet séparé. Les agents utilisent exactement les mêmes processus - Services de test : sur la même page, un admin ajoute PostgreSQL, MariaDB, Redis ou S3 pour que les agents testent. Ils sont partagés par tous les espaces de travail, mais chacun reçoit son propre compte, qui ne voit pas les données des autres ; les identifiants sont communiqués automatiquement aux agents, qui peuvent créer d’autres bases et buckets. La page les liste avec leur taille, et vous pouvez supprimer des bases et des buckets ou vider les clés Redis
Vous êtes notifié quand une session termine ou échoue un tour, et quand une boucle attend une approbation, est bloquée, a échoué ou est terminée.