Done

Support multiple folders in a single project

From AnonymousDone 1 week ago

Allow an AgentsRoom project to include multiple existing folders without moving them.

My use case is an Unreal Engine game in folder A and a copy using a newer Unreal Engine version in folder B. Both belong to the same project, and agents should be able to work across them.

Moving both into a common parent folder would disrupt my existing version-control setup and paths just to accommodate AgentsRoom.

Please let users add or remove folders from a project, select an agent’s working folder, and retain each folder’s existing repository and version-control configuration.

AgentsRoom diagnostics

App version: 1.210.0
OS: win32 10.0.26200 (x64)
App language: system

[Fullstack (décision CEO 2026-10-15) @ 2026-10-15T13:22:35.598Z]

Décision CEO (2026-10-15) : option « B + Changes multi-dépôts »

Ticket de décision : 24a0b198. L'idée 548533c7 (projet principal qui dépend de sous-projets) a été fusionnée ici. L'idée 4e04d286 (worktrees à la racine d'un dossier qui contient plusieurs dépôts) reste au Radar : elle relève de l'option C, non retenue.

Principe : ne rien perturber

Le projet garde un dossier principal : l'agent est toujours lancé dedans. Commit auto, worktree par ticket et diffs d'équipe restent sur ce dossier, sans changement.
On ne fait pas choisir le dossier de travail au lancement (demandé dans le verbatim) : ajouter les dossiers liés à la session donne déjà accès aux deux dossiers, sans multiplier les cas pour le worktree et l'attribution des fichiers.

Lot 1 : dossiers liés

Nouveau réglage projet « Dossiers liés » (Réglages projet > Général) : liste de chemins, vide par défaut. Un projet sans dossier lié = comportement actuel à l'identique. Les chemins sont propres à la machine (exception au contrat 7, à justifier dans la fiche).
Au lancement, flag natif déclaré dans ProviderDef : --add-dir (Claude, Codex, Copilot, déjà utilisé dans copilotLaunch.ts), --include-directories (Gemini). À vérifier provider par provider pour les autres. Sans flag : dégradation propre, documentée dans la fiche.
Le prompt de démarrage liste les dossiers liés, quel que soit le provider.
Lancement en SSH distant : un dossier lié absent de la machine distante est ignoré, avec un message (voir remoteCliOptions.ts).
Chemin absent ou supprimé en local : ignoré au lancement, avec un avertissement dans les réglages.

Lot 2 : Changes multi-dépôts

Sélecteur de dépôt dans l'onglet Changes : dossier principal + chaque dossier lié qui est un dépôt git. Diff, stage et commit manuels par dépôt (réutiliser la lecture d'un dépôt imbriqué, useGitRootResolver).
Le commit auto et le worktree restent sur le dossier principal. Adapter le texte de WorkspaceNoRepoNotice en conséquence.

Contrats

Trois OS : chemins Windows (le reporter est sous win32) et séparateurs.
Mobile : liste affichée en lecture seule dans les réglages du projet. Changes multi-dépôts sur mobile si l'onglet Changes y existe.
i18n : toutes les locales.
Site : mention sur la page projets/workspaces + llms.txt.
Monitoring : lancements avec au moins un dossier lié.
Fiche context/features/LINKED_FOLDERS.md + mise à jour de context/kb/workspaces.md.

Replies

The team1 week ago

Thanks for the detailed use case! A project can now include other existing folders without moving them.

How to use it: open Project settings > General > Linked folders, click "Add a folder" and pick your second folder (for example your Unreal project on the newer engine). You can add or remove folders at any time, nothing is moved or changed on disk.

What happens then:

Agents still start in the project's main folder, and they also get access to every linked folder, which they find listed in their brief.
Each folder keeps its own repository and version control. In the Changes tab, a picker lets you choose which repository to review and commit.
Automatic commits and the per-ticket worktree stay on the main folder.

We chose not to add a "working folder" choice per agent for now: giving each agent access to both folders covers your case without making worktrees and change tracking ambiguous.

If the feature is not quite what you had in mind, tell us and we will adjust it.

The team1 week ago

Thanks: your idea is implemented and ships in the next release. We built it the way we pictured it, so if the result is not what you had in mind, tell us and we will adjust it.