Qué hace GSD Pi
GSD Pi es un agente de codificación local-first que se maneja desde la terminal. Coordina todo el ciclo de vida de un proyecto —planificación, implementación, verificación y seguimiento— desde una única interfaz de línea de comandos, reduciendo la fricción de cambiar entre herramientas separadas.
El agente puede:
- Planificar el trabajo en hitos, segmentos y tareas.
- Ejecutar sesiones de codificación con contexto del proyecto y verificación integrada.
- Usar Git worktrees para aislar cambios experimentales.
- Registrar el estado en una base de datos local y generar resúmenes en markdown.
- Soportar herramientas basadas en extensiones e integraciones de proveedores.
- Generar artefactos como planes, resúmenes y notas de validación.
Todos los planes, conversaciones y el estado en tiempo de ejecución residen dentro de un directorio .gsd/, permaneciendo completamente en tu máquina.
Primeros pasos
Instala el paquete globalmente desde npm:
npm install -g @opengsd/gsd-pi@latest
El binario gsd estará disponible.
Si anteriormente usaste la versión antigua sin ámbito gsd-pi, sigue primero los pasos de migración que se indican más abajo.
En la primera ejecución con gsd, un flujo de configuración interactivo te permite elegir un proveedor de modelos, abrir un directorio de proyecto e inicializar la configuración.
Como alternativa, usa el configurador web en https://pi.opengsd.net/ para crear una configuración en tu navegador antes de lanzar la CLI.
Todo el estado se almacena en .gsd/ en la raíz de tu proyecto.
Existe una guía detallada en el archivo docs/user-docs/getting-started.md del repositorio.
Uso práctico
Inicia GSD dentro de cualquier proyecto:
gsd
Controla el agente con comandos slash. Ejemplos comunes:
/gsd config # revisar o cambiar la configuración /gsd auto # dejar que el agente trabaje de forma autónoma en el plan actual /gsd quick "Describe la tarea" /gsd status # mostrar el estado del proyecto y de la sesión
Un flujo de trabajo típico:
1.
Abre tu proyecto con gsd.
2.
Planifica el trabajo en hitos y segmentos.
3.
Inicia sesiones de codificación donde el agente crea un Git worktree, implementa los cambios, ejecuta la verificación y genera un resumen.
4.
Revisa los artefactos y el estado del proyecto registrados en .gsd/.
El agente comprende la estructura de tus archivos, coordinando la implementación en varios pasos con una supervisión mínima.
Configuración y opciones
- Flujo de configuración – en el primer lanzamiento,
gsdte guía de forma interactiva a través de la selección del proveedor y la inicialización del proyecto. - Configurador web – crea tu configuración en
https://pi.opengsd.net/antes de ejecutar la CLI. - Configuración en sesión – usa
/gsd configpara ajustar la configuración después de la configuración inicial. - Almacenamiento de estado – todos los datos de planificación, sesiones del agente y artefactos residen en el directorio
.gsd/dentro de la raíz de tu proyecto.
No se documentan variables de entorno ni archivos de configuración externos en el README.
Limitaciones conocidas
El README no enumera casos de uso no admitidos, casos límite ni errores conocidos. El proyecto se encuentra en la versión 1.0.0 bajo una nueva línea base de desarrollo. El historial de versiones anteriores ha sido archivado, por lo que la información sobre las limitaciones anteriores a la versión 1.0 no forma parte de la documentación actual.
Migración desde instalaciones anteriores
GSD Pi ahora se publica como @opengsd/gsd-pi.
Si instaló previamente el paquete sin ámbito gsd-pi, debe eliminarlo y limpiar los archivos residuales antes de actualizar.
Esto evita que el binario antiguo oculte al nuevo.
Después de la migración, puede usar el comando integrado gsd upgrade para futuras actualizaciones.
Alternativamente, ejecute el instalador directamente:
npx @opengsd/gsd-pi@latest
Si surgen problemas, consulte docs/user-docs/troubleshooting.md#upgrade-from-older-gsd-pi-installs.
npm uninstall -g gsd-pi rm -f ~/.gsd/.update-check ~/.gsd/agent/managed-resources.json npm install -g @opengsd/gsd-pi@latest which gsd gsd --version
npm uninstall -g gsd-pi Remove-Item "$env:USERPROFILE\.gsd\.update-check" -Force -ErrorAction SilentlyContinue Remove-Item "$env:USERPROFILE\.gsd\agent\managed-resources.json" -Force -ErrorAction SilentlyContinue npm install -g @opengsd/gsd-pi@latest where.exe gsd gsd --version
