Sobre el proyecto

Kaku (書く, que significa 'escribir' en japonés) es un emulador de terminal para macOS diseñado para la codificación asistida por IA, construido sobre WezTerm. Su objetivo es ofrecer una experiencia pulida y lista para usar con valores predeterminados sensatos, eliminando la necesidad de una configuración manual extensa. El proyecto forma parte de una trilogía del autor, junto con Waza (para el entrenamiento de hábitos) y Kami (para la entrega de documentos). **Características principales:** - **Experiencia lista para usar:** Incluye la fuente JetBrains Mono, temas claros/oscuros automáticos, copiar al seleccionar y atajos familiares de Mac. - **Pestañas y paneles:** Admite dividir el espacio de trabajo, navegar entre paneles con un Navegador de Pestañas y restaurar ventanas, paneles y directorios de trabajo al reiniciar. - **Menú contextual:** Proporciona acceso rápido a pegar, buscar, abrir el chat de IA y dividir/cerrar paneles sin necesidad de recordar atajos. - **Enlaces clicables:** Cmd+Clic abre URL y rutas de archivos, con ajuste automático de URL para preservar las direcciones completas. - **Compatible con IA:** Se integra con herramientas de codificación y ofrece un asistente de IA opcional para sugerencias de comandos, conversión de lenguaje natural a comandos y chat. Los usuarios pueden configurar su propio servicio de IA mediante `kaku ai`. - **Herramientas de shell:** Incluye autocompletado de zsh, resaltado de sintaxis y salto de directorios, con atajos para instalaciones opcionales de Lazygit y Yazi. - **Configuración en Lua:** Permite personalizar fuentes, temas, atajos y el comportamiento del terminal usando el sistema de configuración Lua de WezTerm. **Instalación:** - Descarga el DMG desde la página de lanzamientos y arrástralo a Aplicaciones, o usa Homebrew: `brew install --cask kaku`. - Después de abrirlo, ejecuta `kaku init` para configurar la integración del shell e instalar herramientas opcionales. Comprueba la versión con `kaku --version`. **Uso:** El README proporciona una tabla de atajos comunes, incluidos nueva pestaña (Cmd+T), dividir panel (Cmd+D / Cmd+Shift+D), panel de IA (Cmd+Shift+A), chat de IA (Cmd+L), aplicar sugerencia de IA (Cmd+Shift+E), abrir Lazygit (Cmd+Shift+G), gestor de archivos Yazi (Cmd+Shift+Y o y), limpiar pantalla (Cmd+K) y abrir el menú contextual (clic derecho). La referencia completa de combinaciones de teclas está en docs/keybindings.md. **Asistente de IA:** - Configúralo mediante `kaku ai`; Kaku no proporciona ni retransmite el servicio de IA. - Sugerencias de comandos: Cuando un comando falla, el asistente puede sugerir una corrección; pulsa Cmd+Shift+E para pegarla. - Lenguaje natural a comando: Escribe `# <descripción>` y pulsa Enter para generar un comando. - Chat: Pulsa Cmd+L para comentar la salida del terminal o trabajar con archivos del proyecto; `kaku chat` desde otro shell accede al mismo almacén de conversaciones. - Configuración de herramientas de IA: Gestiona los ajustes de Claude Code, Codex, Gemini CLI, Copilot CLI, Kimi Code y más. **Preguntas frecuentes destacadas:** - Solo para macOS; actualmente no hay versión para Windows o Linux. - ¿Diferente de iTerm2, Warp, Ghostty o WezTerm? Consulta kaku.fun/compare. - Ventanas transparentes: establece `config.window_background_opacity` en `~/.config/kaku/kaku.lua`. - Si falta el comando `kaku`, ejecuta `/Applications/Kaku.app/Contents/MacOS/kaku init --update-only && exec zsh -l`, luego `kaku doctor`. **Documentación:** - Sitio web: kaku.fun (documentación en inglés/chino) - Comparativa: kaku.fun/compare - Combinaciones de teclas, Características, Configuración, Referencia de CLI y Preguntas frecuentes están disponibles en la carpeta docs. **Antecedentes:** El autor, un usuario intensivo de CLI, creó Kaku tras años con Alacritty y explorar Kitty, Ghostty, Warp e iTerm2, buscando un equilibrio entre rendimiento, valores predeterminados y control. La robustez y capacidad de modificación de WezTerm sirvieron como base. **Soporte y licencia:** - Soporte a través de Mole for Mac (aplicación de pago), destacando/compartiendo o patrocinando a los gatos del autor. - Licencia MIT; atribución de WezTerm y las fuentes incluidas en NOTICE.md.