For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /fr/docs/desktop/agent-setup.md (or send Accept: text/markdown).
Laissez un agent faire l'installation
Collez un prompt prêt à l'emploi dans un agent de codage, laissez-le exécuter la configuration Desktop sur votre ordinateur, puis vérifiez le rapport qu'il écrit sur chaque étape.
Vous pouvez déléguer la partie ennuyeuse
Ce dépôt a été écrit pour qu'un agent de codage puisse le lire. Il contient un fichier de carte (llms.txt), un fichier de règles (AGENTS.md), des notes de mémoire par fichier (.ai/) et des skills de tâches (.agents/skills/). Le checkout Desktop autonome n'inclut pas le dossier prompts/, le prompt prêt à l'emploi est donc imprimé dans ce guide — copiez-le ci-dessous au lieu d'ouvrir un fichier.
Déléguer la frappe ne veut pas dire sauter les vérifications. L'agent travaille dans votre copie du dépôt et doit rapporter ce qu'il a fait avec des preuves. Les sections ci-dessous montrent à quoi ressemble un bon rapport, pour que vous restiez maître du résultat.
Ce parcours configure le shell Tauri et sa connexion au backend Web — le serveur qui gère les comptes et les données. La fenêtre desktop n'affiche que ce backend ; si votre checkout contient aussi apps/web, l'agent peut l'exécuter localement, et un checkout uniquement Desktop a besoin de l'adresse de backend accessible qui vous a été fournie.
Ce qu'il vous faut d'abord
Terminez d'abord le guide de préparation : Node.js, Git et un éditeur installés, l'invitation GitHub acceptée et le dossier supastack téléchargé sur votre ordinateur. L'agent travaille dans ce dossier, donc tout ce qui figure dans Avant de commencer s'applique toujours.
Il vous faut aussi un outil capable d'agir comme agent de code — un éditeur avec un agent de code IA intégré (un IDE IA), ou un agent qui tourne dans votre terminal (un CLI d'agent). Tout outil récent capable d'agir en agent convient ; le prompt précise déjà ce qu'il doit lire et exécuter, vous n'avez donc pas à rédiger les instructions vous-même.
Enfin, décidez deux choses que demande le prompt : l'adresse du backend que la fenêtre doit charger — http://localhost:3000 pour un backend local ou votre adresse HTTPS fournie — et si Rust et les outils de build natifs sont déjà installés sur cet ordinateur.
Copiez le prompt, remplissez deux blancs, collez
Le prompt est le bloc de code ci-dessous — sélectionnez et copiez le bloc entier.
Deux placeholders nécessitent vos choix. Remplacez <APP_URL> par l'adresse du backend que la fenêtre doit charger — http://localhost:3000 pour un backend local ou votre adresse HTTPS fournie. Remplacez <TOOLCHAIN: present | install> par present lorsque rustc et cargo affichent déjà des versions, ou install lorsque l'agent doit d'abord installer Rust et les outils de build de l'OS. Les étapes numérotées restent exactement telles qu'écrites.
Set up this supastack Desktop checkout end to end and open the Tauri window against the backend at **<APP_URL>**.
1. Read llms.txt, AGENTS.md and docs/agent-security.md before changing anything.
2. Run rustc --version and cargo --version. On **<TOOLCHAIN: present | install>** = install, install Rust and this OS's Tauri prerequisites first, then continue.
3. Run corepack pnpm install.
4. If apps/web exists in this checkout, start it in a second terminal; otherwise verify <APP_URL> answers from this computer and report its status.
5. Start the shell with corepack pnpm --filter @supastack/desktop dev and report whether the window opens, the tray icon appears and the summon shortcut works.
6. Stop after any step fails twice and report the failing command and first error. Ask before deleting anything.Ce que l'agent fait avec le prompt
Le prompt pointe l'agent vers la carte, les règles et la checklist de sécurité, puis lui demande de dérouler la configuration dans l'ordre et de prouver chaque phase. En termes simples, l'agent :
- Lit la carte du dépôt (
llms.txt), les règles du projet (AGENTS.md) et les règles de gestion des identifiants (docs/agent-security.md) avant de toucher quoi que ce soit. - Vérifie la toolchain Rust et les prérequis Tauri de cet OS, et rapporte ce qu'il installe plutôt que d'échouer au milieu d'une compilation.
- Vérifie que le backend répond à votre adresse — en ne démarrant
apps/weblui-même que si ce dossier existe dans ce checkout — au lieu de supposer un serveur qui n'existe pas. - Installe les dépendances, compile le shell et ouvre la fenêtre, puis rapporte le comportement de la fenêtre, de la barre d'état et du raccourci d'appel avec la sortie réelle.
- S'arrête et rapporte après que la même étape a échoué deux fois — il ne contourne pas un échec et ne supprime rien sans demander.
Ce que vous vérifiez dans le rapport de l'agent
Un bon rapport montre des preuves, pas des affirmations. Cherchez l'URL du backend qui répond, l'installation des dépendances terminée, une compilation Rust achevée et une fenêtre ouverte derrière chaque PASS — pas une phrase comme « tout fonctionne ».
Le prompt dit à l'agent de s'arrêter et de rapporter après que la même étape a échoué deux fois — pas de contourner l'échec — et de vous demander avant toute action destructive. Si votre agent continue d'improviser après des échecs répétés, arrêtez-le et portez la première erreur au guide de dépannage.
Deux choses ne doivent jamais apparaître : une fonctionnalité de sécurité désactivée pour faire taire une erreur, et une valeur secrète comme un mot de passe ou une clé imprimée dans le chat ou le rapport. Si vous voyez l'une des deux, traitez l'exécution comme échouée.
Gardez séparés dans votre esprit le shell et la vraie connexion. La fenêtre affichant la page d'accueil de votre backend prouve le shell — les vrais comptes ont toujours besoin de la base de données du backend. « La fenêtre s'est ouverte » n'est pas encore « les comptes fonctionnent ».
Si vous préférez le faire à la main
Chaque étape effectuée par l'agent est écrite dans les guides manuels ci-dessous — les mêmes commandes, les mêmes vérifications, à votre rythme.