🤖 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
- Terminal Emulators: Alacritty, WezTerm, Kitty, Ghostty
- AI Agent Configs: Source configurations for Claude Code and OpenCode (installed via 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.
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, Tmux/Zellij, Ghostty | Configures Claude Code, OpenCode, Gemini CLI, Cursor, VS Code Copilot |
| Source configs | GentlemanClaude/, GentlemanOpenCode/ |
Reads from this repo + its own assets |
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
- 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! 🎩