lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

configuración intermedio claude-codecodexgitworktrees

Virtual Workspace: trabaja con repositorios relacionados en una sesión

Agrupa configuraciones de agentes y prepara worktrees coordinados para cambios que abarcan varios repositorios.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.


Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: instala en Claude Code

/plugin marketplace add https://github.com/filipealva/virtual-workspace
/plugin install virtual-workspace@filipealva

Paso 2: crea un espacio de prueba

Reinicia la sesión y usa /virtual-workspace. Proporciona dos repositorios de prueba y una carpeta superior. Revisa los scripts generados antes de la preparación inicial (bootstrap) y evita la publicación opcional del espacio si no la necesitas.

Comprobación

Comprueba workspace.conf, los enlaces y el estado de cada repositorio. Crea un worktree de prueba con el procedimiento oficial y verifica que apunta a la rama esperada.

Si algo falla

Si falta configuración de un cliente, revisa assistant-support.sh y la guía del README. No limpies worktrees hasta comprobar si conservan cambios propios.

ver en .md ¿Prefieres el recurso entero?

Qué es

Virtual Workspace es un plugin para preparar un espacio común sobre varios repositorios. Une configuraciones de agentes y añade scripts para operar con worktrees de funcionalidades relacionadas.

Para qué te sirve

  • Cuando una funcionalidad requiere cambios en frontend y API guardados en repositorios distintos.
  • Cuando quieres ver el estado de ramas y archivos modificados de todo el conjunto.
  • Cuando necesitas compartir agentes y skills sin copiar su configuración manualmente a cada carpeta.

Cómo funciona

La skill genera una carpeta superior con workspace.conf, scripts y archivos de instrucciones. La preparación inicial (bootstrap) clona repositorios y crea enlaces a configuraciones; los scripts de worktrees preparan ramas coordinadas. El espacio generado puede funcionar sin el plugin que lo creó.

El README contempla añadir después otro cliente y ampliar un conjunto de worktrees existente. Revisa siempre qué repositorios incluye la operación antes de ejecutar scripts que actúen sobre todos.

Antes de empezar

Necesitas Git, acceso a los repositorios y Claude Code o Codex. Elige una carpeta superior propia y conserva los cambios locales de cada repositorio. Comprueba las políticas de ubicación y aislamiento de worktrees que ya tenga tu equipo.

Límites y alternativas

Compartir contexto no unifica los historiales ni elimina conflictos entre proyectos. Los enlaces pueden hacer visibles instrucciones que antes estaban separadas. Un cambio con varios repositorios sigue necesitando pruebas y revisión por cada componente afectado.

Recursos

  • Repositorio y README - 14 estrellas; licencia detectada por GitHub: MIT.
  • Licencia - Consulta sus condiciones antes de reutilizar el proyecto.