Varios directorios, un solo proyecto
para cada agente de IA que lanzas
Un juego en una carpeta y su adaptación a una versión más reciente del motor en otra. Una app web y la API a la que llama, en dos repositorios. Una biblioteca compartida junto a las apps que la usan. Tus agentes necesitan los dos lados, y reunir las carpetas bajo un mismo padre rompería una organización que funciona.
En su lugar, vincula las otras carpetas al proyecto. Se quedan donde están y conservan su propio control de versiones. Cada agente que lanzas en el proyecto las recibe: mediante --add-dir en Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code y Mistral Vibe, y en su brief para las demás CLI. Después, la pestaña Cambios revisa y hace commit de cada repositorio.
- /work/web-appCarpeta del proyecto · git
- /work/apiCarpeta vinculada · git
- /work/shared-libCarpeta vinculada · git
Un proyecto, tres repositorios: cada agente arranca en la carpeta del proyecto y recibe las otras dos, en la forma que entiende su CLI.
Un agente arranca en una carpeta, y la mayoría de las CLI lo mantienen ahí. A menudo puede leer alrededor, pero editar fuera de su directorio de trabajo implica una solicitud de permiso, un rechazo del sandbox o un flag que hay que recordar en cada arranque. Eso aguanta hasta que el trabajo abarca dos sitios: la app y su API, un juego y su copia en un motor más reciente, una biblioteca y los proyectos que la usan.
Las soluciones habituales tienen un coste. Reunir las dos carpetas bajo un mismo padre rompe rutas, scripts y ajustes del editor que funcionaban. Un enlace simbólico confunde a algunas herramientas y oculta dónde están realmente los archivos. Escribir --add-dir en cada arranque funciona hasta el arranque en que se te olvida.
Las carpetas vinculadas son una lista guardada en el proyecto. Añades una carpeta una sola vez, en Configuración del proyecto, General, Carpetas vinculadas. A partir de ahí, cada agente del proyecto, lo lances desde la lista de agentes, desde un ticket del backlog o desde tu móvil, recibe esas carpetas, y cada carpeta conserva su propio repositorio.
Lo que hacen las carpetas vinculadas
Una lista en el proyecto, leída en cada arranque. Un proyecto sin carpetas vinculadas funciona exactamente igual que antes.
Las carpetas se quedan donde están
Elige una carpeta con el selector de carpetas del sistema. No se mueve, no se copia ni se crea ningún enlace simbólico, y cada carpeta conserva su propio repositorio, su rama y su historial. Hasta diez carpetas por proyecto.
El flag adecuado para cada CLI
Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code y Mistral Vibe reciben cada carpeta mediante su propio flag --add-dir, tanto cuando el agente arranca de cero como cuando retoma una sesión.
Nombradas en el brief del agente
Cada agente, sea cual sea su CLI, recibe también un bloque corto en su brief: las carpetas, que forman parte del proyecto y que git se ejecuta desde dentro de cada una. Las CLI sin flag llegan a ellas por su ruta completa cuando su sandbox lo permite.
Haz commit de cada repositorio
En la pestaña Cambios, un selector de repositorio lista la carpeta del proyecto y cada carpeta vinculada que es un repositorio git. Elige uno para ver su diff y luego pasarlo al stage, hacer commit y push.
Igual en el móvil
Un agente lanzado desde la app móvil de AgentsRoom recibe los mismos flags y el mismo brief, porque es el ordenador el que prepara el arranque. El móvil muestra las carpetas vinculadas en el menú del proyecto, y su pantalla Cambios también ofrece los repositorios vinculados.
Comprobadas al arrancar
Una carpeta que falta en el disco, en un disco desconectado por ejemplo, se queda en la lista con un aviso y se omite al arrancar, con una línea en el terminal. La propia carpeta del proyecto y los duplicados se rechazan.
Cómo funciona
Cuatro pasos, y los dos primeros se hacen una vez por proyecto.
- 1
Abre la configuración del proyecto
Configuración del proyecto, General, Carpetas vinculadas. El campo indica qué CLI reciben las carpetas mediante un flag y cómo llegan a ellas las demás.
- 2
Añade una carpeta
Añadir una carpeta abre el selector de carpetas del sistema, y la carpeta se guarda al momento. La cruz que tiene al lado la quita del proyecto más adelante: nada cambia en el disco.
- 3
Lanza un agente
Lanza cualquier agente del proyecto como siempre: desde la lista de agentes, desde un ticket del backlog o desde tu móvil. Arranca en la carpeta del proyecto y además tiene las carpetas vinculadas.
- 4
Revisa y haz commit de cada repositorio
Abre la pestaña Cambios y elige un repositorio: la carpeta del proyecto o una carpeta vinculada. Lee su diff, luego pásalo al stage, haz commit y push desde ahí. Cada carpeta conserva su propio historial.
Claude Code y Codex ya saben añadir un directorio. Esto es lo que cambia
Claude Code acepta --add-dir al arrancar y /add-dir durante una sesión, y guarda una lista duradera en additionalDirectories de sus archivos de ajustes. Un directorio añadido obtiene acceso a los archivos con las mismas reglas de permisos que el directorio de trabajo. De un directorio pasado con --add-dir o /add-dir también carga las skills, los comandos y los subagentes, pero no su CLAUDE.md salvo que esté definido CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1; un directorio listado en un archivo de ajustes solo da acceso a los archivos. Comprobado en la documentación de Claude Code y en la versión 2.1.300 en octubre de 2026.
Codex también tiene --add-dir, que hace que un directorio sea editable junto al espacio de trabajo principal, y writable_roots bajo sandbox_workspace_write en config.toml para una lista duradera (codex-cli 0.162.1). GitHub Copilot CLI, Antigravity CLI, Kimi Code y Mistral Vibe tienen cada uno su propio --add-dir.
Así que el flag no es la novedad. Lo que añade AgentsRoom es la lista guardada en el proyecto y pasada a cada agente en cada arranque, en la forma que espera cada CLI (Claude Code necesita el flag y la carpeta en una sola pieza, como en --add-dir=/work/api, si no la opción se traga el prompt que la sigue), el mismo brief para las CLI que no tienen flag, arranques desde el móvil que reciben las mismas carpetas y una pestaña Cambios que hace commit de cada repositorio. AgentsRoom no define CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD por ti.
Lo que conviene saber
- Los commits automáticos al terminar un ticket, el worktree por ticket y los diffs de las etapas de equipo se quedan en la carpeta del proyecto. En una carpeta vinculada, revisas y haces commit a mano.
- La lista se guarda en cada ordenador, porque una ruta como D:\Games\UE5 no significa nada en otra máquina. Vuelve a añadir las carpetas en tus otros ordenadores.
- Un agente lanzado en un servidor remoto por SSH no recibe las carpetas vinculadas: son rutas de este ordenador. Una línea en su terminal lo indica.
- OpenCode, Aider, Grok Build, Amp, oh-my-pi, Freebuff, Devin y Cursor no tienen flag para un directorio adicional. Sus agentes encuentran las carpetas en su brief y solo llegan a ellas por su ruta completa cuando su propio sandbox se lo permite.
- El móvil muestra la lista pero no la edita: una carpeta se elige con el selector de carpetas del ordenador.
- Diez carpetas por proyecto como máximo, porque un comando de arranque tiene un límite de longitud en Windows.
Preguntas frecuentes
¿Cómo doy a Claude Code acceso a varios directorios?
En el propio Claude Code: --add-dir seguido de una ruta al arrancarlo, /add-dir durante una sesión o additionalDirectories en un archivo de ajustes para una lista duradera. En AgentsRoom, añade las carpetas una sola vez como carpetas vinculadas del proyecto (Configuración del proyecto, General, Carpetas vinculadas): cada agente Claude Code del proyecto arranca entonces con un --add-dir para cada una, igual que los agentes de las demás CLI que tienen ese flag.
¿Puede Codex trabajar en varios repositorios?
Sí. Codex arranca en un espacio de trabajo, --add-dir hace editable otro directorio a su lado y writable_roots en config.toml guarda una lista duradera. AgentsRoom pasa --add-dir a cada agente Codex del proyecto para cada carpeta vinculada, también cuando el agente retoma una sesión, y su brief le indica que ejecute git desde dentro de cada repositorio.
¿Puede un proyecto incluir varios repositorios git?
Sí. El proyecto conserva su carpeta principal, donde arrancan los agentes, y vincula los demás repositorios. Cada uno conserva su propio control de versiones. En la pestaña Cambios, el selector de repositorio pasa de la carpeta del proyecto a cada repositorio vinculado para leer su diff, hacer commit y push.
¿Se mueven, se copian o se enlazan simbólicamente mis carpetas?
No. AgentsRoom solo guarda sus rutas y se las pasa a los agentes al arrancar. Nada cambia en el disco cuando añades o quitas una carpeta vinculada.
¿Qué CLI de agente reciben las carpetas vinculadas?
Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code y Mistral Vibe reciben cada carpeta mediante su propio flag --add-dir. OpenCode, Aider, Grok Build, Amp, oh-my-pi, Freebuff, Devin y Cursor no tienen ese flag: encuentran las carpetas en su brief y las abren por su ruta completa cuando su sandbox lo permite.
¿Lee el agente el CLAUDE.md de una carpeta vinculada?
No por defecto. Claude Code carga las skills, los comandos y los subagentes de un directorio pasado con --add-dir, pero su CLAUDE.md solo si está definido CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1, y AgentsRoom no lo define por ti. Lo que sí recibe cada agente es el brief: dónde está cada carpeta vinculada, que forma parte del proyecto y que conserva su propio control de versiones.
¿Los worktrees y el commit automático cubren las carpetas vinculadas?
No, se quedan en la carpeta del proyecto: un worktree por ticket, los commits automáticos al terminar un ticket y los diffs de las etapas de equipo. En una carpeta vinculada, revisa y haz commit a mano desde la pestaña Cambios.
¿Las carpetas vinculadas me siguen a mis otros ordenadores?
No. La lista se guarda en el ordenador donde la creaste, porque la ruta de una carpeta solo existe ahí. Los agentes lanzados en un servidor remoto por SSH tampoco reciben las carpetas. El resto del proyecto, sus agentes, su backlog y sus ajustes, sigue a tu cuenta como siempre.
¿Funciona en Windows y Linux?
Sí, en macOS, Windows y Linux. En Windows se entienden las letras de unidad y los dos tipos de barra, y cada --add-dir va entre comillas para PowerShell.
También te puede interesar
Multiproyecto · Multiagente · Paralelo
AgentsRoom ejecuta varios agentes de IA en paralelo a través de varios proyectos, todo en una sola ventana: Claude, Codex, GitHub Copilot CLI, Cursor y otros 10 CLI de agente. Roles con código de color, estado en vivo, contadores por proyecto, notificaciones nativas de escritorio y móvil. La alternativa visual a las 12 pestañas de terminal y al caos de las sesiones de Claude Code dispersas entre iTerm2, Warp y tmux.
Worktrees de git
Da a cada agente de IA o ticket su propio worktree de git, listo para compilar (dependencias instaladas, .env copiados), y luego revísalo, haz commit y fusiónalo desde una sola ventana.
Revisión por Agente
Revisa los cambios de código de cada agente IA por separado. AgentsRoom rastrea qué agente Claude Code modificó qué archivos. Filtra diffs por agente, revisa individualmente, haz commits por agente para un historial git limpio.
Multi-Provider
AgentsRoom soporta 14 proveedores de codificación IA: Claude, Codex, GitHub Copilot CLI, OpenCode, Antigravity CLI, Aider, Grok Build, Mistral Vibe, Kimi Code, Amp, oh-my-pi, Freebuff, Devin y Cursor. Asigna un proveedor diferente por agente, cambia de proveedor en medio de una conversación y conserva todo el contexto con handoff automático. La mejor herramienta de codificación IA multi-provider.
Conexiones SSH
Guarda tus conexiones SSH, abre una terminal SSH integrada y ejecuta Claude Code, Codex o Antigravity CLI directamente en tu servidor remoto o VPS. Autenticación por clave SSH o contraseña, perfiles de conexión por proyecto, sin necesidad de un cliente SSH aparte.
Dales a tus agentes el proyecto entero
Descarga AgentsRoom, abre tu repositorio principal como proyecto y vincula los demás en Configuración del proyecto, General, Carpetas vinculadas.
App complementaria: supervisa tus agentes en movimiento
Usa Claude, Codex, Antigravity CLI u otro proveedor de IA.
Envía bugs y peticiones directamente a tu backlog público.