Gentleman.Dots

🤖 NUEVO: La capa de desarrollo con IA ahora tiene su propio instalador — AI Gentle Stack (gentle-ai). Configura Claude Code, OpenCode, Gemini CLI, Cursor y VS Code Copilot con memoria persistente, workflow SDD, skills y la personalidad Gentleman. Instalá Gentleman.Dots primero, después ejecutá gentle-ai para la capa de IA.

📄 Leer en: English | Español

Tabla de Contenidos

• ¿Qué es esto?
• Inicio rápido
• Plataformas soportadas
• Capa de Desarrollo con IA
• Entrenador de Maestría en Vim
• Documentación
• Resumen de herramientas
• Bleeding Edge
• Soporte

---

Vista previa

Instalador TUI

Demostración

---

¿Qué es esto?

Una configuración completa de entorno de desarrollo que incluye:

• Neovim con LSP, autocompletado e integración con IA
• Shells: Fish, Zsh, Nushell
• Multiplexores de terminal: Tmux, Zellij, Herdr
• Emuladores de terminal: Alacritty, WezTerm, Kitty, Ghostty
• Herramientas CLI de IA: Instaladores de Claude Code y OpenCode CLI (configs gestionadas por gentle-ai)

---

Inicio rápido

Opción 1: Homebrew (Recomendado)

brew install Gentleman-Programming/tap/gentleman-dots
gentleman-dots

Opción 2: Descarga directa

# macOS Apple Silicon
curl -fsSL https://github.com/Gentleman-Programming/Gentleman.Dots/releases/latest/download/gentleman-installer-darwin-arm64 -o gentleman.dots

# macOS Intel
curl -fsSL https://github.com/Gentleman-Programming/Gentleman.Dots/releases/latest/download/gentleman-installer-darwin-amd64 -o gentleman.dots

# Linux x86_64
curl -fsSL https://github.com/Gentleman-Programming/Gentleman.Dots/releases/latest/download/gentleman-installer-linux-amd64 -o gentleman.dots

# Linux ARM64 (Raspberry Pi, etc.)
curl -fsSL https://github.com/Gentleman-Programming/Gentleman.Dots/releases/latest/download/gentleman-installer-linux-arm64 -o gentleman.dots

# Luego ejecutar
chmod +x gentleman.dots
./gentleman.dots

Opción 3: Termux (Android)

Termux requiere compilar localmente. Consultá la Guía de instalación en Termux para las instrucciones completas.

---

El TUI te deja elegir Tmux, Zellij, Herdr o None como multiplexor. Fish, Zsh y Nushell quedan configurados para iniciar el multiplexor elegido en shells interactivos nuevos, evitando sesiones anidadas.

Usuarios de Tmux: Después de la instalación, abrí tmux y presioná prefix + I (I mayúscula) para instalar los plugins con TPM. Esto asegura que el tema y los plugins carguen correctamente.

Usuarios de Windows: Primero tenés que configurar WSL. Consultá la Guía de instalación manual.

---

Plataformas soportadas

Plataforma	Arquitectura	Método de instalación	Gestor de paquetes
macOS	Apple Silicon (ARM64)	Homebrew, descarga directa	Homebrew
macOS	Intel (x86_64)	Homebrew, descarga directa	Homebrew
Linux (Ubuntu/Debian)	x86_64, ARM64	Homebrew, descarga directa	Homebrew
Linux (Fedora/RHEL)	x86_64, ARM64	Descarga directa	dnf
Linux (Arch)	x86_64	Homebrew, descarga directa	Homebrew
Windows	WSL	Descarga directa (ver docs)	Homebrew
Android	Termux (ARM64)	Compilación local	pkg

---

🤖 Capa de Desarrollo con IA

Gentleman.Dots configura tu entorno de desarrollo (editor, shells, terminales). Para la capa de desarrollo con IA (agentes, memoria, skills, workflow), usá el proyecto complementario:

AI Gentle Stack (gentle-ai)

brew install Gentleman-Programming/tap/gentle-ai
gentle-ai

Configura tus agentes de IA con todo lo que necesitan:

Componente	Qué hace
Engram	Memoria persistente entre sesiones (servidor MCP)
SDD Workflow	Spec-Driven Development con sub-agentes orquestados
Skills	24 librerías de patrones (React 19, Next.js 15, TypeScript, Tailwind 4, etc.)
Context7	Documentación actualizada de librerías vía MCP
Persona	Estilo de enseñanza Gentleman para las respuestas de IA
Permisos	Defaults de seguridad para todos los agentes

Agentes soportados

Agente	Single Agent	Multi Agent
Claude Code	✅	✅
OpenCode	✅	✅
Gemini CLI	✅	✅
Cursor	✅	—
VS Code Copilot	✅	—

Single agent: Un orquestador maneja todas las fases SDD. Multi agent: Un sub-agente dedicado por fase con ruteo individual de modelos (ej: Claude Opus para diseño, Gemini para specs, GPT para verificación).

Qué vive dónde

	Este repo (Gentleman.Dots)	gentle-ai
Propósito	Entorno de desarrollo (editores, shells, terminales)	Capa de desarrollo con IA (agentes, memoria, skills)
Instala	Neovim, Fish/Zsh/Nushell, Tmux/Zellij/Herdr, Ghostty	Configura Claude Code, OpenCode, Gemini CLI, Cursor, VS Code Copilot
Configs IA	Solo CLI tools (Claude Code, OpenCode)	Config completa: persona, skills, temas, MCP

Instalá Gentleman.Dots primero para tu entorno de desarrollo, después gentle-ai para la capa de IA.

---

🎮 Entrenador de Maestría en Vim

¡Aprendé Vim de forma divertida! El instalador incluye un entrenador interactivo estilo RPG con:

Módulo	Teclas cubiertas
🔤 Movimiento horizontal	w, e, b, f, t, 0, $, ^
↕️ Movimiento vertical	j, k, G, gg, {, }
📦 Objetos de texto	iw, aw, i", a(, it, at
✂️ Cambiar y repetir	d, c, dd, cc, D, C, x
🔄 Sustitución	r, R, s, S, ~, gu, gU, J
🎬 Macros y registros	qa, @a, @@, "ay, "+p
🔍 Regex / Búsqueda	/, ?, n, N, *, #, \v

Cada módulo incluye 15 lecciones progresivas, modo práctica con selección inteligente de ejercicios, jefes finales y seguimiento de XP.

Podés iniciarlo desde el menú principal: Vim Mastery Trainer

---

Documentación

Documento	Descripción
Guía del instalador TUI	Funciones interactivas, navegación, backup y restore
Instalación manual	Configuración paso a paso para todas las plataformas
Keymaps de Neovim	Referencia completa de atajos
Configuración de IA	Claude Code, OpenCode, Copilot y más
Especificación del entrenador Vim	Detalles técnicos del entrenador
Testing con Docker	Tests E2E con contenedores
Contribuir	Setup de desarrollo, sistema de skills y releases
AI Gentle Stack	Instalador de capa IA — Engram, SDD, Skills, Persona (repo separado)

---

Resumen de herramientas

• Emuladores de terminal: Ghostty, Kitty, WezTerm, Alacritty
• Shells: Nushell, Fish, Zsh (+ Powerlevel10k)
• Multiplexores: Tmux, Zellij, Herdr
• Editor: Neovim (LazyVim con LSP, completado e IA)
• Prompt: Starship

Consultá la Referencia de herramientas para descripciones detalladas de cada herramienta.

---

Bleeding Edge

¿Querés las últimas funcionalidades experimentales de mi workflow diario (solo macOS)?

Mirá la rama nix-migration.

Contiene configuraciones de vanguardia que luego pasan a main cuando se estabilizan.

---

Soporte

• Issues: GitHub Issues
• Discord: Gentleman Programming Community
• YouTube: @GentlemanProgramming
• Twitch: GentlemanProgramming

---

Licencia

Licencia MIT — libre de usar, modificar y compartir.

¡Feliz coding! 🎩

---

Contribuidores

¡Gracias a todos los que contribuyeron a Gentleman.Dots!