Configurer Aggrega avec votre assistant d’IA
Un assistant d’IA capable d’exécuter des commandes sur votre machine — un agent de programmation dans votre terminal ou votre éditeur — peut configurer Aggrega pour vous : installer le binaire aggrega, s’ajouter la skill Aggrega et se connecter au serveur MCP d’Aggrega. Un assistant qui installe des plugins effectue les deux dernières opérations en une seule étape, en installant le plugin Aggrega ; tout autre assistant ajoute la skill puis connecte le serveur, l’un après l’autre. Collez-y le prompt ci-dessous, et il exécute ces étapes ; le prompt lui demande de vous consulter avant d’installer quoi que ce soit.
Une fois le travail terminé, l’assistant dispose de deux moyens de travailler avec Aggrega. La skill est un dossier contenant un fichier SKILL.md que l’assistant charge lorsque votre demande concerne Aggrega : elle indique à l’assistant comment se déroule la boucle de rédaction et lui demande de tirer chaque réponse sur un schéma ou un fichier du binaire plutôt que de sa mémoire. Le serveur MCP, aggrega mcp, lui donne les outils d’Aggrega — scaffold, validate, build et les autres — et la documentation de référence sur laquelle ils s’appuient. La skill Aggrega décrit la skill et le plugin, Connecter le serveur MCP le serveur, et Ce que votre assistant peut faire avec Aggrega ce qu’il atteint par son intermédiaire.
Une fois l’assistant configuré, Prise en main, chaque procédure pas à pas sous Import et la page de chaque exemple exécutable qui se construit avec Aggrega donnent la tâche qu’ils enseignent sous forme de prompt à y coller, à côté des commandes.
Le prompt
Configurez Aggrega pour moi, une étape à la fois, et dites-moi ce que vous avez exécuté à chaque étape.
1. Exécutez `aggrega version`. Si la commande est introuvable, demandez-moi avant d’installer Aggrega, puis installez-le pour mon utilisateur avec le programme d’installation officiel : sous Linux ou macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, sous Windows dans PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Exécutez de nouveau `aggrega version`. Si le programme d’installation a affiché une ligne à ajouter à mon `PATH`, montrez-la-moi.2. Si `https://aggrega.ai/docs/ai-assistants/skill/` indique un moyen d’installer en vous le plugin Aggrega, demandez-moi avant de l’installer, puis installez-le de cette façon, ou dites-moi quoi faire lorsqu’il s’agit d’une étape que j’effectue dans votre interface. Le plugin ajoute la skill Aggrega et vous connecte au serveur MCP d’Aggrega. Sinon, exécutez `aggrega skills install --help` et trouvez votre propre identifiant dans la liste qu’il affiche. Demandez-moi si je veux la skill dans ce projet ou dans tous les projets, puis exécutez `aggrega skills install --agent <your identifier>`, en ajoutant `--global` pour tous les projets. Si vous n’êtes pas dans la liste, n’installez pas la skill et dites-le.3. Si vous avez installé le plugin, vous êtes déjà connecté au serveur MCP d’Aggrega. Sinon, connectez-vous au serveur MCP d’Aggrega, qui est la commande `aggrega mcp`, de la manière dont vous ajoutez un serveur MCP, comme le décrit pour vous `https://aggrega.ai/docs/ai-assistants/mcp-server/`. Si vous avez besoin d’un redémarrage ou d’un rechargement pour charger le plugin ou le serveur, dites-moi quoi faire.4. Une fois connecté, appelez l’outil `describe-capabilities` sans arguments et résumez ce qu’il liste.Le prompt est le même dans chaque langue dans laquelle la documentation est publiée : seules ses phrases sont traduites, et chaque commande, option, adresse et nom d’outil qu’il contient reste exactement tel qu’il est écrit, de sorte qu’un assistant lit les mêmes instructions quelle que soit la langue depuis laquelle vous le copiez.
Le programme d’installation télécharge la dernière release, la vérifie par rapport aux empreintes SHA-256 publiées de la release et l’installe pour votre seul utilisateur, sans droits d’administrateur ; Installer le binaire décrit ce qu’il fait et comment installer à la main à la place.
Ce qui change d’un assistant à l’autre
Trois parties du prompt dépendent de l’assistant : la façon dont il installe le plugin Aggrega, s’il installe des plugins ; sinon, l’identifiant qu’il passe à --agent lorsqu’il installe la skill, et la façon dont il ajoute le serveur. L’assistant les déduit du prompt, mais si vous les connaissez, vous pouvez les y écrire.
| Assistant | Installation du plugin | Installation de la skill sans le plugin |
|---|---|---|
| Claude Code | claude plugin install aggrega --marketplace aggrega-ai/aggrega-skills | aggrega skills install --agent claude-code |
| Codex | codex plugin marketplace add aggrega-ai/aggrega-skills, puis codex plugin add aggrega@aggrega | aggrega skills install --agent codex |
| GitHub Copilot CLI | copilot plugin marketplace add aggrega-ai/aggrega-skills, puis copilot plugin install aggrega@aggrega | aggrega skills install --agent github-copilot |
| Gemini CLI | gemini extensions install https://github.com/aggrega-ai/aggrega-skills | aggrega skills install --agent gemini-cli |
| Antigravity | agy plugin install https://github.com/aggrega-ai/aggrega-skills | aggrega skills install --agent antigravity, ou --agent antigravity-cli pour la CLI d’Antigravity |
| Cursor | git clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega, puis Developer: Reload Window | aggrega skills install --agent cursor |
Visual Studio Code avec GitHub Copilot, Kiro et OpenClaw installent aussi le plugin ; Installer le plugin donne la marche à suivre pour chaque assistant, ainsi que ce que demande OpenClaw avant d’installer. Les identifiants qu’accepte --agent, et le dossier dans lequel chacun écrit, sont listés dans aggrega skills et affichés par aggrega skills install --help. La façon dont chaque assistant ajoute le serveur — une commande qui lui est propre, ou une entrée dans ses paramètres ou dans un fichier de liste de serveurs — figure sur Connecter le serveur MCP, client par client.
Quand une partie du prompt ne s’applique pas
- Un assistant qui installe le plugin n’a pas à connecter le serveur : le plugin l’a connecté. Le plugin n’installe pas le binaire, l’étape 1 s’applique donc toujours. Lorsque l’assistant démarre le serveur du plugin en dehors de votre projet — Codex le démarre dans le propre dossier du plugin —, la skill lui demande d’indiquer au serveur le dossier de votre projet, comme le décrit Le dossier dans lequel travaille le serveur.
- Un assistant qui n’installe aucun plugin et ne figure pas dans la liste de
--agentignore l’installation de la skill. Il accède malgré tout aux outils d’Aggrega par le serveur MCP une fois connecté, et le serveur lui fournit ses propres indications lorsqu’il se connecte. - Un assistant qui ne peut pas exécuter de commandes — une application de chat sans accès à votre terminal — ne peut pas suivre le prompt. Installez le binaire comme le décrit Installation, et connectez vous-même l’application comme le décrit Connecter le serveur MCP. Pour Claude Desktop, voir Claude Desktop ci-dessous.
- Un serveur qu’une autre personne exécute pour vous, joint via HTTPS, ne nécessite ni le binaire, ni le plugin, ni la skill. Donnez plutôt l’adresse au client de l’assistant, comme le décrit Un serveur joint via HTTPS.
Claude Desktop
Claude Desktop se connecte à Aggrega par le paquet d’extension que fournit chaque release, et ce paquet lance l’aggrega installé sur votre ordinateur. Mettez vous-même en place les deux sur votre ordinateur :
- Installez
aggregadans PowerShell sous Windows avecirm https://aggrega.ai/install.ps1 | iex, ou dans un terminal sous macOS ou Linux aveccurl -fsSL https://aggrega.ai/install.sh | sh. Installer le binaire décrit ce que fait le programme d’installation. - Installez le paquet d’extension, définissez son Workspace folder et redémarrez Claude Desktop, comme le décrit Claude Desktop dans Connecter le serveur MCP.
Une session Claude Desktop peut exécuter ses commandes dans un conteneur cloud plutôt que sur votre ordinateur ; le prompt ci-dessus, collé dans cette session, agit donc sur le conteneur. Là, aggrega s’installe et s’exécute depuis le shell de la session dès que la politique réseau du conteneur autorise aggrega.ai — un propriétaire de l’organisation l’autorise dans les paramètres d’accès réseau de l’organisation. Le serveur MCP d’Aggrega n’y est pas connecté : Claude Desktop n’ajoute un serveur local que depuis ses paramètres d’extension, et l’extension lance l’aggrega de votre ordinateur, pas celui du conteneur.
aggrega skills install n’a pas d’entrée pour Claude Desktop ; une session Claude Desktop ignore donc l’installation de la skill. Elle accède aux outils d’Aggrega par le serveur MCP une fois l’extension installée, et le serveur lui fournit ses propres indications lorsqu’elle se connecte.