Skip to main content
Gentleman.Dots Hero

​
What is Gentleman.Dots?

Gentleman.Dots is a comprehensive, production-ready dotfiles collection that transforms your terminal into a powerful, beautiful, and efficient development environment. Whether you’re a seasoned developer or just starting your journey, this configuration provides everything you need to build software like a professional.

Complete Setup

Everything you need in one place - terminal emulators, shells, window managers, and Neovim configuration with AI integration

Multiple Choices

Pick your preferred tools: Alacritty, WezTerm, Kitty, or Ghostty for terminals; Fish, Zsh, or Nushell for shells; Tmux or Zellij for window management

AI-Powered

Integrated AI assistants in Neovim including OpenCode with the custom Gentleman agent, Claude Code, Gemini, and more

Cross-Platform

Works seamlessly on macOS, Linux (Ubuntu/Debian and Arch), and Windows via WSL

​
What’s Included

Gentleman.Dots provides carefully curated configurations for:
A fully-configured Neovim setup with:
  • LSP (Language Server Protocol) for intelligent code completion
  • Tree-sitter for advanced syntax highlighting
  • AI assistants integrated directly into your editor:
    • OpenCode.nvim with custom Gentleman agent (enabled by default)
    • Avante.nvim, CopilotChat.nvim, CodeCompanion.nvim
    • Claude Code.nvim and Gemini.nvim
  • Debugging with nvim-dap
  • Obsidian integration for note-taking
  • Modern UI with beautiful themes and components
The Neovim configuration is located in GentlemanNvim/nvim/ and includes:
~/.config/nvim/
├── lua/
│   ├── config/      # Core configuration
│   └── plugins/     # Plugin configurations
└── init.lua         # Entry point
Choose from three modern shells:Fish - User-friendly with excellent defaults
# Auto-suggestions, syntax highlighting, and web-based configuration
# Located in: GentlemanFish/fish/
Zsh - Traditional power with Oh-My-Zsh and Powerlevel10k
# Extensive plugin ecosystem and customization
# Located in: GentlemanZsh/
Nushell - Modern, structured shell with pipeline-oriented approach
# Cross-platform, with structured data handling
# Located in: GentlemanNushell/
All shells include:
  • Starship prompt for beautiful, informative prompts
  • Zoxide for smart directory jumping
  • Atuin for enhanced shell history
  • Carapace for advanced completions
  • fzf for fuzzy finding
Pick your preferred terminal with pre-configured settings:
  • Alacritty (alacritty.toml) - GPU-accelerated, minimal, blazing fast
  • WezTerm (.wezterm.lua) - GPU-accelerated with advanced features and Lua configuration
  • Kitty (GentlemanKitty/) - GPU-based, feature-rich, macOS-focused
  • Ghostty (GentlemanGhostty/) - Modern, fast, minimal resource usage
All terminals are configured with:
  • Iosevka Term Nerd Font for beautiful icons and ligatures
  • Gentleman color scheme inspired by Kanagawa
  • Optimized performance settings
Manage your terminal sessions efficiently:Tmux (GentlemanTmux/)
# Traditional, stable, extensive plugin ecosystem
# Pre-configured with TPM (Tmux Plugin Manager)
Zellij (GentlemanZellij/)
# Modern, written in Rust, built-in layouts
# WebAssembly plugin system

​
The Gentleman Philosophy

Gentleman.Dots is not just another dotfiles collection - it’s an opinionated, professional setup designed for developers who want to:
  • Skip the endless configuration tweaking
  • Start with best practices out of the box
  • Have access to modern tooling and AI assistance
  • Maintain a consistent environment across machines

​
The Gentleman Agent

The included OpenCode Gentleman agent is unique - it’s a Senior Architect persona with 15+ years of experience that:

Never Says Yes Blindly

Won’t agree without verification. Uses “let’s check that” instead of “you’re right”

Proposes Alternatives

Always presents options with tradeoffs: “Option A does X, Option B does Y…”

Collaborative Partner

Like Jarvis to Tony Stark - provides data, challenges assumptions, pushes back when needed

Bilingual Support

Responds in Rioplatense Spanish if you write in Spanish, or English otherwise

​
Installation Approaches

Gentleman.Dots offers two installation methods: 
# One command to rule them all
curl -O https://raw.githubusercontent.com/Gentleman-Programming/Gentleman.Dots/refs/heads/main/install-linux-mac.sh
sudo chmod +x install-linux-mac.sh
bash ./install-linux-mac.sh
The automatic installer is highly recommended! It’s an interactive script that:
  • Detects your operating system automatically
  • Asks which components you want to install
  • Shows progress bars for each step
  • Handles all dependencies and configurations
  • Takes about 5-10 minutes to complete

​
Platform Support

Full support for both Intel and Apple Silicon Macs.Requirements:
  • macOS 11.0 (Big Sur) or later
  • Xcode Command Line Tools
Bonus: Check out the nix-migration branch for bleeding-edge features (macOS only)
Fully tested on Ubuntu 20.04+ and Debian 11+.Requirements:
  • build-essential package
  • curl, git, and wget
Native support for Arch Linux and derivatives.Requirements:
  • base-devel group
  • Standard Arch Linux installation
Works through Windows Subsystem for Linux (WSL 2).Important: Windows users must complete manual WSL setup steps before running the installer.Additional Requirements:
  • Windows 10 version 2004+ or Windows 11
  • WSL 2 installed and configured
  • A Linux distribution (Ubuntu recommended)
  • win32yank for clipboard integration

​
What Makes This Special?

Production-Ready

Not experimental configs - these are battle-tested configurations used in real development workflows

Modern Tooling

Uses bat, ripgrep, fd, eza, and other modern CLI tools instead of legacy alternatives

AI Integration

Multiple AI assistants available, with the unique Gentleman agent as the default

Beautifully Themed

Consistent Gentleman theme across all tools, inspired by Kanagawa colorscheme

MCP Integration

Model Context Protocol support via Context7 for up-to-date documentation access

Active Development

Regularly updated with new features and improvements

​
Get Started

Ready to transform your development environment?

Next: Installation

Follow our step-by-step installation guide to set up Gentleman.Dots on your system
Important Notes:
  • Windows users must complete manual WSL setup before using the installer
  • The Iosevka Term Nerd Font must be installed before using any terminal emulator
  • Some AI features require API keys (OpenCode, Claude, Gemini, etc.)

​
Community & Support

Gentleman.Dots is maintained by Gentleman Programming and the community.
This documentation is your guide to mastering Gentleman.Dots. Each section includes real examples from the source code and practical tips for daily use.

Build docs developers (and LLMs) love

Get started for freeTalk to us