My personal configuration for LazyVim !

ℹ️ Update (January 2026): OpenCode now supports Claude Max/Pro subscriptions via the opencode-anthropic-auth plugin (included in this config). Both Claude Code and OpenCode work with your Claude subscription. Note: This workaround is stable for now, but Anthropic could block it in the future.

• What is this?
• Quick Start
• Supported Platforms
• Vim Mastery Trainer
• Documentation
• Tools Overview
• Bleeding Edge
• Project Structure
• Support

A complete development environment configuration including:

• Neovim with LSP, autocompletion, and AI assistants (Claude Code, Gemini, OpenCode)
• Shells: Fish, Zsh, Nushell
• Terminal Multiplexers: Tmux, Zellij
• Terminal Emulators: Alacritty, WezTerm, Kitty, Ghostty

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.dots

Termux requires building the installer locally (Go cross-compilation to Android has limitations).

# 1. Install dependencies
pkg update && pkg upgrade
pkg install git golang

# 2. Clone the repository
git clone https://github.com/Gentleman-Programming/Gentleman.Dots.git
cd Gentleman.Dots/installer

# 3. Build and run
go build -o ~/gentleman-installer ./cmd/gentleman-installer
cd ~
./gentleman-installer

Tip: After installation, restart Termux to apply the font, then run tmux or zellij to start your configured environment.

The TUI guides you through selecting your preferred tools and handles all the configuration automatically.

Windows users: You must set up WSL first. See the Manual Installation Guide.

Learn Vim the fun way! The installer includes an interactive RPG-style trainer with:

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

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.

Gentleman.Dots/
├── installer/               # Go TUI installer source
│   ├── cmd/                 # Entry point
│   ├── internal/            # TUI, system, and trainer packages
│   └── e2e/                 # Docker-based E2E tests
├── docs/                    # Documentation
├── skills/                  # AI agent skills (repo-specific)
│
├── GentlemanNvim/           # Neovim configuration (LazyVim)
├── GentlemanClaude/         # Claude Code config + user skills
│   └── skills/              # Installable skills (React, Next.js, etc.)
├── GentlemanOpenCode/       # OpenCode AI config
│
├── GentlemanFish/           # Fish shell config
├── GentlemanZsh/            # Zsh + Oh-My-Zsh + Powerlevel10k
├── GentlemanNushell/        # Nushell config
├── GentlemanTmux/           # Tmux config
├── GentlemanZellij/         # Zellij config
│
├── GentlemanGhostty/        # Ghostty terminal config
├── GentlemanKitty/          # Kitty terminal config
├── alacritty.toml           # Alacritty config
├── .wezterm.lua             # WezTerm config
│
└── starship.toml            # Starship prompt config

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

MIT License - feel free to use, modify, and share.

Happy coding! 🎩