Skip to main content
Gentleman.Dots Logo

​
Transform Your Development Environment

Gentleman.Dots is a meticulously crafted collection of dotfiles designed to create the ultimate development environment. Whether you’re on macOS, Linux, or Windows WSL, get a fully configured setup with LazyVim, multiple shells, terminal emulators, and cutting-edge AI assistants.

Quick Installation

Get up and running in minutes with our automated installation script

Get Started

Learn the basics and configure your first setup

​
Key Features

LazyVim Configuration

Full-featured Neovim with LSP, autocompletion, and 36+ plugins

Multiple Shells

Choose from Nushell, Fish, or Zsh with optimized configurations

Terminal Emulators

Configurations for Alacritty, WezTerm, Kitty, and Ghostty

Window Managers

Tmux and Zellij configurations for efficient workflow

AI Integration

OpenCode with custom Gentleman agent and multiple AI assistants

Cross-Platform

Full support for Linux, macOS, and Windows WSL

​
Why Gentleman.Dots?

One-command installation script handles all dependencies, package managers, and configurations across macOS, Linux, and WSL.
Integrated AI assistants including OpenCode with the custom Gentleman agent, designed to challenge assumptions and propose better alternatives.
Modular architecture allows you to mix and match components. Use only what you need - pick your shell, terminal, and window manager.
Production-ready configurations used in real development workflows, with comprehensive documentation for every component.

​
Get Started in 3 Steps

1

Install Dependencies

Install Homebrew, Rust, and basic build tools for your platform
2

Run Installation Script

Execute the automated installer to set up your environment
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
3

Configure Your Preferences

Select your shell, terminal emulator, and window manager preferences

​
What’s Included?

​
Development Tools

  • Neovim (LazyVim) - Modern Vim with LSP, tree-sitter, and AI assistants
  • Git Integration - Lazygit for visual git management
  • Obsidian Integration - Note-taking directly from Neovim

​
Shells & Prompts

  • Nushell - Modern shell with structured data support
  • Fish - User-friendly shell with great defaults
  • Zsh - Powerful shell with Powerlevel10k theme
  • Starship - Cross-shell prompt customization

​
Terminal Emulators

  • Alacritty - GPU-accelerated terminal
  • WezTerm - Feature-rich terminal with multiplexing
  • Kitty - Fast, GPU-based terminal
  • Ghostty - Modern terminal emulator

​
Window Management

  • Tmux - Terminal multiplexer with custom plugins
  • Zellij - Modern terminal workspace manager

​
Platform Support

Linux

Ubuntu, Debian, and general Linux distributions

Arch Linux

Optimized setup for Arch-based distributions

macOS

Full support for Intel and Apple Silicon Macs

Windows WSL

Complete guide for Windows Subsystem for Linux
Want bleeding-edge features? Check out the nix-migration branch for experimental macOS configurations using Nix.

Build docs developers (and LLMs) love

Get started for freeTalk to us