Gentleman.Dots
🤖 NEW: The AI development layer now lives in its own installer — AI Gentle Stack (gentle-ai). It configures Claude Code, OpenCode, Gemini CLI, Cursor, and VS Code Copilot with persistent memory, SDD workflow, skills, and the Gentleman persona. Install Gentleman.Dots first, then run
gentle-aifor the AI layer.
📄 Read this in: English | Español
Table of Contents
- What is this?
- Quick Start
- Supported Platforms
- AI Development Layer
- Vim Mastery Trainer
- Documentation
- Tools Overview
- Bleeding Edge
- Support
Preview
TUI Installer
Showcase
What is this?
A complete development environment configuration including:
- Neovim with LSP, autocompletion, and AI integration
- Shells: Fish, Zsh, Nushell
- Terminal Multiplexers: Tmux, Zellij, Herdr
- Terminal Emulators: Alacritty, WezTerm, Kitty, Ghostty
- AI CLI Tools: Claude Code and OpenCode CLI installers (configs managed by gentle-ai)
Quick Start
Option 1: Homebrew (Recommended)
brew install Gentleman-Programming/tap/gentleman-dots
gentleman-dotsOption 2: Direct Download
# 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
# Then run
chmod +x gentleman.dots
./gentleman.dotsOption 3: Termux (Android)
Termux requires building locally. See the Termux Installation Guide for full instructions.
The TUI guides you through selecting your preferred tools and handles all the configuration automatically.
During multiplexer selection, choose Tmux, Zellij, Herdr, or None. Fish, Zsh, and Nushell are patched to auto-start the selected multiplexer on fresh interactive shells while avoiding nested sessions.
Tmux users: After installation, open tmux and press
prefix + I(capital I) to install plugins via TPM. This ensures the theme and all plugins load correctly.
Windows users: You must set up WSL first. See the Manual Installation Guide.
Supported Platforms
| Platform | Architecture | Install Method | Package Manager |
|---|---|---|---|
| macOS | Apple Silicon (ARM64) | Homebrew, Direct Download | Homebrew |
| macOS | Intel (x86_64) | Homebrew, Direct Download | Homebrew |
| Linux (Ubuntu/Debian) | x86_64, ARM64 | Homebrew, Direct Download | Homebrew |
| Linux (Fedora/RHEL) | x86_64, ARM64 | Direct Download | dnf |
| Linux (Arch) | x86_64 | Homebrew, Direct Download | Homebrew |
| Windows | WSL | Direct Download (see docs) | Homebrew |
| Android | Termux (ARM64) | Build locally (see above) | pkg |
🤖 AI Development Layer
Gentleman.Dots handles your dev environment (editor, shells, terminals). For the AI development layer (agents, memory, skills, workflow), use the companion project:
AI Gentle Stack (gentle-ai)
brew install Gentleman-Programming/tap/gentle-ai
gentle-aiIt configures your AI coding agents with everything they need:
| Component | What it does |
|---|---|
| Engram | Persistent memory across sessions (MCP server) |
| SDD Workflow | Spec-Driven Development with orchestrated sub-agents |
| Skills | 24 coding pattern libraries (React 19, Next.js 15, TypeScript, Tailwind 4, etc.) |
| Context7 | Up-to-date library documentation via MCP |
| Persona | Gentleman teaching style for AI responses |
| Permissions | Security-first defaults for all agents |
Supported Agents
| Agent | Single Agent | Multi Agent |
|---|---|---|
| Claude Code | ✅ | ✅ |
| OpenCode | ✅ | ✅ |
| Gemini CLI | ✅ | ✅ |
| Cursor | ✅ | — |
| VS Code Copilot | ✅ | — |
Single agent: One orchestrator handles all SDD phases. Multi agent: Dedicated sub-agent per phase with individual model routing (e.g., Claude Opus for design, Gemini for specs, GPT for verification).
What lives where
| This repo (Gentleman.Dots) | gentle-ai | |
|---|---|---|
| Purpose | Dev environment (editors, shells, terminals) | AI development layer (agents, memory, skills) |
| Installs | Neovim, Fish/Zsh/Nushell, Tmux/Zellij/Herdr, Ghostty | Configures Claude Code, OpenCode, Gemini CLI, Cursor, VS Code Copilot |
| AI configs | CLI tools only (Claude Code, OpenCode) | Full config: persona, skills, themes, MCP |
Install Gentleman.Dots first for your dev environment, then gentle-ai for the AI layer on top.
🎮 Vim Mastery Trainer
Learn Vim the fun way! The installer includes an interactive RPG-style trainer with:
| Module | Keys Covered |
|---|---|
| 🔤 Horizontal Movement | w, e, b, f, t, 0, $, ^ |
| ↕️ Vertical Movement | j, k, G, gg, {, } |
| 📦 Text Objects | iw, aw, i", a(, it, at |
| ✂️ Change & Repeat | d, c, dd, cc, D, C, x |
| 🔄 Substitution | r, R, s, S, ~, gu, gU, J |
| 🎬 Macros & Registers | qa, @a, @@, "ay, "+p |
| 🔍 Regex/Search | /, ?, n, N, *, #, \v |
Each module includes 15 progressive lessons, practice mode with intelligent exercise selection, boss fights, and XP tracking.
Launch it from the main menu: Vim Mastery Trainer
Documentation
| Document | Description |
|---|---|
| TUI Installer Guide | Interactive installer features, navigation, backup/restore |
| Manual Installation | Step-by-step manual setup for all platforms |
| Neovim Keymaps | Complete reference of all keybindings |
| AI Configuration | Claude Code, OpenCode, Copilot, and other AI assistants |
| AI Gentle Stack | AI layer installer — Engram, SDD, Skills, Persona (separate repo) |
| Vim Trainer Spec | Technical specification for the Vim Mastery Trainer |
| Docker Testing | E2E testing with Docker containers |
| Contributing | Development setup, skills system, E2E tests, release process |
Tools Overview
- Terminal Emulators: Ghostty, Kitty, WezTerm, Alacritty
- Shells: Nushell, Fish, Zsh (+ Powerlevel10k)
- Multiplexers: Tmux, Zellij, Herdr
- Editor: Neovim (LazyVim with LSP, completions, AI)
- Prompt: Starship
See Tools Reference for detailed descriptions of each tool.
Bleeding Edge
Want the latest experimental features from my daily workflow (macOS only)?
Check out the nix-migration branch.
This branch contains cutting-edge configurations that eventually make their way to main once stable.
Support
- Issues: GitHub Issues
- Discord: Gentleman Programming Community
- YouTube: @GentlemanProgramming
- Twitch: GentlemanProgramming
License
MIT License - feel free to use, modify, and share.
Happy coding! 🎩
Contributors
Thanks to everyone who has contributed to Gentleman.Dots!