🤖 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
- What is this?
- Quick Start
- Supported Platforms
- AI Development Layer
- Vim Mastery Trainer
- Documentation
- Tools Overview
- Bleeding Edge
- Support
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)
brew install Gentleman-Programming/tap/gentleman-dots
gentleman-dots# 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.dotsTermux 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.
| 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 |
Gentleman.Dots handles your dev environment (editor, shells, terminals). For the AI development layer (agents, memory, skills, workflow), use the companion project:
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 |
| 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).
| 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.
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, $, ^ |
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
| 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 |
- 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.
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.
- Issues: GitHub Issues
- Discord: Gentleman Programming Community
- YouTube: @GentlemanProgramming
- Twitch: GentlemanProgramming
MIT License - feel free to use, modify, and share.
Happy coding! 🎩
Thanks to everyone who has contributed to Gentleman.Dots!