Skip to content

AVL05/forge-hub

Repository files navigation

FORGE Hub

FORGE Hub es un Developer Operations Hub local-first para Windows. Su objetivo es ayudarte a abrir la aplicación, recuperar el contexto de tus proyectos y empezar a trabajar rápido.

Release Platform License

Qué hace

  • Detecta proyectos desde carpetas de trabajo.
  • Muestra un dashboard operativo con Git, health, procesos y contexto reciente.
  • Gestiona sesiones de trabajo con comandos, terminales y URLs.
  • Ejecuta y supervisa procesos locales.
  • Resume estado Git, cambios pendientes, rama, ahead/behind y últimos commits.
  • Analiza la salud del proyecto con recomendaciones accionables.
  • Guarda recursos útiles: comandos, snippets, prompts, configs, SQL, Docker y notas.
  • Busca recursos automáticamente al escanear proyectos.
  • Ofrece una paleta Ctrl+K para abrir proyectos, terminales, IDE, sesiones y recursos.

Descargar

La versión estable está en la página de releases:

Descargar FORGE v1.0

Artefactos disponibles:

  • FORGE-1.0.0-x64-setup.exe: instalador Windows.
  • FORGE-1.0.0-x64-portable.exe: versión portable.

Requisitos

Para usar la aplicación:

  • Windows 10/11.
  • Git instalado y disponible en el PATH.
  • Un IDE compatible en el PATH si quieres abrir proyectos desde FORGE, por ejemplo code para VS Code o cursor para Cursor.

Para desarrollo local:

  • Node.js 18 o superior.
  • pnpm.
  • Windows recomendado para empaquetar los .exe.

Desarrollo

Instala dependencias:

pnpm install

Ejecuta la app en modo desarrollo:

pnpm dev

Comprueba tipos:

pnpm run typecheck

Genera la build interna de Electron/Vite en out/:

pnpm run build

Genera instalador NSIS y ejecutable portable para Windows:

pnpm run dist:win

Los artefactos se escriben en dist/.

Datos locales

La base de datos SQLite se guarda fuera del proyecto y fuera de dist/, usando la ruta de usuario de Electron:

%APPDATA%\FORGE\forge.db

Electron resuelve esa ruta mediante app.getPath("userData"), por lo que los datos sobreviven a recompilaciones, reinstalaciones normales y actualizaciones de la app.

SQLite puede crear archivos auxiliares como:

  • forge.db-wal
  • forge.db-shm

Resetear datos

Cierra FORGE y elimina la carpeta de datos:

Remove-Item -Recurse -Force "$env:APPDATA\FORGE"

Al abrir FORGE de nuevo, la base de datos se recreará con el esquema inicial.

Seguridad y privacidad

  • FORGE trabaja localmente.
  • No incluye telemetría.
  • Las operaciones Git usan el binario git del sistema.
  • Los procesos se ejecutan en el directorio del proyecto seleccionado.
  • Los recursos y ajustes se guardan en la base de datos local.
  • Los archivos .env detectados no se importan con contenido real.

Consulta SECURITY.md para reportar vulnerabilidades.

Licencia

FORGE Hub es software propietario con código visible para revisión. Puedes usar la aplicación compilada, pero no modificar, redistribuir ni crear derivados del código fuente sin permiso explícito.

Consulta LICENSE.

About

Local-first Developer Operations Hub for restoring project context, managing Git, processes, sessions and resources on Windows.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages