Gentleman.Dots

ℹ️ 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. 📄 Read this in: English | Español

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

Preview

TUI Installer

Showcase

What is this?

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

Quick Start

Option 1: Homebrew (Recommended)

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

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

Option 3: Termux (Android)

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

Termux Support	Status
Shells (Fish, Zsh, Nushell)	✅ Available
Multiplexers (Tmux, Zellij)	✅ Available
Neovim with full config	✅ Available
Nerd Fonts	✅ Auto-installed to `~/.termux/font.ttf`
Terminal emulators	❌ Not applicable
Homebrew	❌ Uses `pkg` instead

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.

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

🎮 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, navigati

...

gentleman-programming/gentleman.dots

README