Claude Code es brillante escribiendo, refactorizando y explicando código, pero gestionar múltiples proyectos, sesiones y comportamientos de agentes desde la terminal puede volverse un caos rápidamente. Gooey transforma ese caos en claridad. Es una aplicación de escritorio nativa (basada en Tauri) que integra Claude Code en una interfaz gráfica de usuario (GUI) limpia y potente para que puedas crear agentes personalizados, gestionar sesiones interactivas, ejecutar agentes seguros en segundo plano, organizar proyectos, monitorizar el uso e incluso gestionar servidores MCP, todo en un solo lugar.
Este artículo te explica qué es Gooey, por qué cada función es importante en el desarrollo diario y cómo ejecutarlo e implementarlo, tanto si trabajas solo como si coordinas un equipo pequeño.
Nota: Gooey es un proyecto independiente de código abierto y no está afiliado a Anthropic.
Tabla de contenidos
Qué es Gooey (en una frase)
Un kit de herramientas de escritorio que facilita la gestión de sesiones, la creación de agentes y la automatización de Claude Code, sin sacrificar el control local ni la seguridad.
Características principales (y por qué te interesará)
1) Gestión de proyectos y sesiones
Qué hace: Gooey escanea tu espacio de trabajo de Claude Code (normalmente ~/.claude/projects/) y te ofrece un navegador visual de proyectos e historiales de sesiones. Puedes buscar, reanudar o iniciar nuevas sesiones con contexto completo.
Por qué es importante: El historial de la terminal es efímero. Una cronología visible de «lo que discutimos» mantiene el ritmo entre sesiones y facilita la colaboración (o las transferencias).
2) «Agentes CC» personalizados
Qué hace: Define agentes especializados con nombres, iconos, indicaciones del sistema y permisos. Ejecútalos en primer plano o como procesos en segundo plano; inspecciona los registros y el historial de ejecución.
Por qué es importante: Diferentes trabajos requieren diferentes personalidades: redactor de documentación, refactorizador centrado en las pruebas, riguroso con los contratos de API. Codificarlos como agentes reutilizables convierte las «buenas indicaciones» en flujos de trabajo repetibles.
3) Panel de análisis de uso
Qué hace: Realiza un seguimiento de los costes y tokens por modelo, proyecto y periodo, con gráficos exportables.
Por qué es importante: Cuando la IA se integra en el ciclo de desarrollo, la visibilidad del gasto y la combinación de modelos elimina las conjeturas y previene sorpresas de fin de mes.
4) Gestión de servidores MCP
Qué hace: Agrega, importa y prueba servidores del Protocolo de Contexto de Modelo (incluidas las configuraciones importadas de Claude Desktop) en una única interfaz de usuario.
Por qué es importante: Las herramientas se están multiplicando. Centralizar los servidores MCP elimina las desviaciones de configuración y permite ampliar el asistente con nuevas funciones de forma más segura.
5) Cronología y puntos de control
Qué hace: Crea puntos de control, bifurca sesiones y compara cambios a lo largo del tiempo con una cronología visual. Un clic restaura el estado anterior.
Por qué es importante: Experimentarás más cuando la función «deshacer» sea confiable. Los puntos de control te permiten explorar agresivamente y mantener una ruta limpia de regreso a la configuración correcta.
6) Gestión de CLAUDE.md
Qué hace: Editor integrado y vista previa en vivo para CLAUDE.md, además de un escáner de proyectos para encontrar y mantener estos archivos.
Por qué es importante: Tus reglas internas, estándares de codificación y contexto específico del repositorio residen en CLAUDE.md. Mantenerlo visible y consistente mejora drásticamente los resultados del agente.
7) Seguridad por defecto
Qué hace: Almacenamiento local, sin telemetría, controles de permisos por agente y aislamiento de procesos para ejecuciones en segundo plano.
Por qué es importante: Obtienes una interfaz gráfica de usuario completa sin sacrificar la privacidad ni permitir que los agentes se desplacen más allá de tus límites previstos.
Bajo el capó (tecnología confiable)
Gooey se entrega como una aplicación de escritorio Tauri 2 con un frontend de React + TypeScript y un backend de Rust, utilizando SQLite para datos locales. En la práctica, esto se traduce en un diseño nativo, un tamaño compacto y velocidad en macOS, Windows y Linux. Es de código abierto bajo la licencia AGPL-3.0.
Cómo instalar y ejecutar
Opción A: Crear la aplicación de escritorio localmente (la más rápida actualmente)
Gooey requiere que la CLI de Claude Code esté instalada y en su PATH. Verifíquela con claude --version.
1. Requisitos previos de instalación
- Rust (vía rustup)
- Bun (entorno de ejecución/empaquetador de JavaScript)
- Git
- Extras de la plataforma: Bibliotecas de desarrollo WebKit/GTK en Linux; CLT de Xcode en macOS; Herramientas de compilación MSVC + WebView2 en Windows.
2. Clonar e instalar dependencias
git clone https://github.com/getAsterisk/gooey.git
cd gooey
bun install
3. Ejecutar en desarrollo (recarga en caliente)
bun run tauri dev
4. Producir una compilación nativa
bun run tauri build
# Artifacts land in src-tauri/target/release/ (DMG/MSI/DEB/AppImage/EXE)
Si algo falla, consulta la sección de solución de problemas del archivo README para ver si faltan cadenas de herramientas o bibliotecas de plataforma (por ejemplo, WebKit GTK en Linux).
¿Prefieres los instaladores? Consulta las versiones del repositorio; allí publican compilaciones empaquetadas para macOS, Windows y Linux.
Recorrido inicial (5 minutos para empezar a trabajar)
- Inicia Gooey → seleccione Proyectos o Agentes CC en la pantalla de bienvenida. Gooey detecta automáticamente su directorio ~/.claude.
- Vista de proyectos → seleccione un repositorio; escanee sesiones anteriores; reanude o inicie una nueva.
- Crea un agente → nombre + icono, escriba su mensaje de sistema, seleccione un modelo, configure los permisos de archivo/red y guarde. Ahora puede ejecutarlo en cualquier proyecto.
- Panel de uso → abre el menú para ver los costos/tokens por modelo y proyecto; exporte si es necesario.
- Administrador de MCP → agrega o importe servidores, pruebe la conectividad y guárdelos en un único registro.
- Puntos de control → crea puntos de control de la línea de tiempo mientras trabaja; bifurque/ramifique si desea explorar un enfoque alternativo.
Flujos de trabajo diarios que brillan
A) Agentes con estilo propio
Crea agentes para las convenciones de tu equipo: TypeScript-first, PNPM forzado y ESLint estricto. Ejecútalos rápidamente contra nuevos repositorios para implementar los estándares de arranque. (Explícale las reglas en CLAUDE.md y mantenlo actualizado con el editor integrado).
B) Picos con red de seguridad
Usa puntos de control antes de grandes refactorizaciones; bifurca una rama en la línea de tiempo para probar otra ruta. El visor de diferencias muestra claramente qué enfoque es más limpio
C) Revisiones de uso
Cierra un sprint exportando el uso del modelo para su contabilidad. Si los costos aumentan, ajusta las solicitudes de alto consumo de tokens o traslada las tareas rutinarias a modelos más económicos.
D) Experimentos de herramientas mediante MCP
Agrega un nuevo servidor MCP para, por ejemplo, búsquedas en repositorios o runbooks de incidentes. Pruébalo en el administrador y luego impleméntalo para los agentes que lo necesiten sin archivos de configuración dispersos.
Notas de implementación (equipos y máquinas de laboratorio)
- Localización por defecto: Todo reside en tu máquina; sin telemetría. Ideal para trabajo sin conexión o que requiere privacidad.
- Compilaciones firmadas: Usa artefactos de lanzamiento empaquetados (DMG/MSI/DEB/AppImage) para compañeros de equipo que no sean desarrolladores y así evitar la configuración de la cadena de herramientas.
- Control de políticas: Incentiva a agentes con permisos limitados de archivos/red para repositorios de riesgo; eleve solo cuando sea necesario.
- Copias de seguridad: Dado que las sesiones y los puntos de control son valiosos, incluya la carpeta de datos locales de Gooey en la rutina de copias de seguridad de su estación de trabajo.
Solución de problemas (respuestas rápidas)
- Claude no encontrado: Instale la CLI de Claude Code y asegúrese de que esté en PATH; verifique con claude –version.
- Errores de compilación de Linux relacionados con WebKit/GTK: Instala los paquetes libwebkit2gtk, libgtk-3-dev y los paquetes de desarrollo relacionados.
- Windows «MSVC no encontrado»: Instala las herramientas de compilación de Microsoft C++; reinicie el shell.
- Presión de memoria durante la compilación: Usa una compilación de depuración o reduzca los trabajos en paralelo.
Código abierto, de verdad
Gooey cuenta con licencia AGPL-3.0, con TypeScript y Rust como lenguajes principales. Se agradecen las contribuciones (características, documentación, pruebas, i18n). Si te interesa su funcionamiento interno, consulta la estructura del repositorio y los comandos de desarrollo en el archivo README.
Conclusión
Gooey no pretende reemplazar a Claude Code, sino potenciarlo. Con cronogramas de sesión, agentes reutilizables, ejecuciones en segundo plano, visibilidad de costos, gestión de MCP y las herramientas CLAUDE.md, convierte la programación asistida por IA en una práctica confiable, transparente y fácil de usar para el equipo.
Objetivo para tu primer día:
- Construir o instalar Gooey,
- Crear un agente propio,
- Reanudar una sesión anterior y establecer dos puntos de control, y
- Conectar un servidor MCP que hayas querido probar.
Notarás la diferencia la próxima vez que lances una función y en cada ocasión posterior.