Gentleman.Dots

Description

This repository contains customized configurations for a complete development environment, including:

Neovim, with LSP, autocompletion, and integrated AI assistants (Claude, Gemini)
Fish
Zsh
Nushell
Tmux
Zellij
Terminal emulators:
- Alacritty
- WezTerm
- Kitty
- Ghostty

You can choose between automatic and manual installation methods depending on your preference and operating system.

Want the bleeding edge? If you want access to the latest experimental features that I use in my daily workflow (macOS only), check out the nix-migration branch: https://github.com/Gentleman-Programming/Gentleman.Dots/tree/nix-migration

This branch contains cutting-edge configurations that eventually make their way to main once they're stable and tested. If you can't wait for the stable release and want the absolute latest features, this branch is incredible - just keep in mind it's macOS-focused and may have occasional instabilities.

Important: Windows users must follow the manual installation instructions before running the script.

Installation (Automatic Recommended!)

The Easy Way! Test the automated process and let the script do all the work for you 😘

The automatic installation script is the quickest and easiest way to set up your development environment. This script handles all the heavy lifting, but remember that you must install the font mentioned below before running it. The script is designed for macOS, Linux, and WSL systems. If you’re on Windows, you’ll need to follow the manual steps first before attempting to run this script.

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

Manual Installation

Welcome to the Gentleman.Dots manual configuration guide! This document will walk you through the steps required to set up your development environment.

Clone the repo before continuing!!!

git clone [email protected]:Gentleman-Programming/Gentleman.Dots.git cd Gentleman.Dots

For Windows

Important: Windows users must follow these manual installation steps before running the automated script.

1. Install WSL

WSL (Windows Subsystem for Linux) allows you to run Linux on Windows. Install it and set it to version 2:

wsl --install wsl --set-default-version 2

2. Install a Linux Distribution

Install a Linux distribution (e.g., Ubuntu) in WSL:

wsl --install -d Ubuntu

To list available distributions:

wsl --list --online

Install your preferred distribution:

wsl --install -d <distribution-name>

3. Installing the Iosevka Font

The Iosevka Term Nerd Font is required for terminal emulators in this setup. On Windows, this installation must be done manually.

Download the Iosevka font from its official site or from Nerd Fonts GitHub.
Extract the archive and locate the font files (.ttf or .otf).
Install the fonts:
- Right-click each font file and select "Install for all users" to install the font system-wide.

4. Launch and Configure the Distribution

Open the installed distribution to complete setup. Update it with:

sudo apt-get update sudo apt-get upgrade

5. Install a Terminal Emulator

Choose and install one of the following terminal emulators:

Alacritty: Download from GitHub Releases and place alacritty.exe in your PATH.
WezTerm: Download and Install and create an environment variable called HOME that resolves to C:\Users\your-username.
Kitty: Download and Install.

6. Configuration Transfer for Terminal Emulators

Using PowerShell:

Alacritty Configuration

mkdir $env:APPDATA\alacritty Copy-Item-Path alacritty.toml -Destination $env:APPDATA\alacritty\alacritty.toml # In alacritty.toml, uncomment and set the shell program to WSL:#[shell]#program = "wsl.exe"#args = ["--cd", "~"]

WezTerm Configuration

Copy-Item-Path .wezterm.lua -Destination $HOME# Uncomment for Windows settings in .wezterm.lua:# config.default_domain = 'WSL:Ubuntu'# config.front_end = "WebGpu"# config.max_fps = 120

If WezTerm doesn't take the initial configuration:

Create a wezterm folder in C:\Users\your-username\.config
Copy .wezterm.lua into wezterm.lua inside that directory
Restart WezTerm

Kitty Configuration

Copy-Item-Path GentlemanKitty\*-Destination $HOME\.config\kitty -Recurse

7. Install Chocolatey and win32yank

Chocolatey is a package manager for Windows that simplifies the installation of software.

To install Chocolatey:

Open PowerShell as an administrator.
Run the following command:

Set-ExecutionPolicy Bypass -Scope Process-Force; ` [System.Net.ServicePointManager]::SecurityProtocol =` [System.Net.ServicePointManager]::SecurityProtocol -bor3072; ` iwr https://community.chocolatey.org/install.ps1 -UseBasicParsing | iex

To install win32yank:

After installing Chocolatey, run:

choco install win32yank

Note:win32yank is required for clipboard integration in Neovim when using WSL.

For Linux, Arch Linux, macOS, and WSL

Prerequisites

macOS or Linux: Ensure you have one of these operating systems.
Administrator privileges (sudo): You'll need administrator access to install some tools.

1. Install Dependencies

Arch Linux

sudo pacman -Syu --noconfirm sudo pacman -S --needed --noconfirm base-devel curl file git wget curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh .$HOME/.cargo/env /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Linux

sudo apt-get update sudo apt-get install -y build-essential curl file git curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh .$HOME/.cargo/env /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Mac

xcode-select --install curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh .$HOME/.cargo/env /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Install Iosevka Term Nerd Font (icons and font style)

Arch Linux / Linux

mkdir -p ~/.local/share/fonts wget -O ~/.local/share/fonts/Iosevka.zip https://github.com/ryanoasis/nerd-fonts/releases/download/v3.3.0/IosevkaTerm.zip unzip ~/.local/share/fonts/Iosevka.zip -d ~/.local/share/fonts/ fc-cache -fv

Mac

brew tap homebrew/cask-fonts brew install --cask font-iosevka-term-nerd-font

3. Choose and Install Terminal Emulator

Alacritty

Arch Linux

sudo pacman -S --noconfirm alacritty mkdir -p ~/.config/alacritty && cp alacritty.toml ~/.config/alacritty/alacritty.toml

Mac

brew install alacritty --cask mkdir -p ~/.config/alacritty && cp alacritty.toml ~/.config/alacritty/alacritty.toml

Linux

sudo add-apt-repository ppa:aslatter/ppa; sudo apt update; sudo apt install alacritty mkdir -p ~/.config/alacritty && cp alacritty.toml ~/.config/alacritty/alacritty.toml

WezTerm

Arch Linux

sudo pacman -S --noconfirm wezterm mkdir -p ~/.config/wezterm && cp .wezterm.lua ~/.config/wezterm/wezterm.lua

Mac

brew install wezterm --cask mkdir -p ~/.config/wezterm && cp .wezterm.lua ~/.config/wezterm/wezterm.lua

Linux

brew tap wez/wezterm-linuxbrew; brew install wezterm mkdir -p ~/.config/wezterm && cp .wezterm.lua ~/.config/wezterm/wezterm.lua

Ghostty

Arch Linux

pacman -S ghostty mkdir -p ~/.config/ghostty && cp -r GentlemanGhostty/*~/.config/ghostty

Mac

brew install --cask ghostty mkdir -p ~/.config/ghostty && cp -r GentlemanGhostty/*~/.config/ghostty

Linux

brew install --cask ghostty mkdir -p ~/.config/ghostty && cp -r GentlemanGhostty/*~/.config/ghostty

Kitty

Mac

brew install --cask kitty mkdir -p ~/.config/kitty && cp -r GentlemanKitty/*~/.config/kitty

Reload the config after install doing ctrl+shift+, | cmd+shift+,

4. Choose and Install a Shell

Nushell

1. Step

cp -rf bash-env-json ~/.config/ cp -rf bash-env.nu ~/.config/ brew install nushell carapace zoxide atuin jq bash starship fzf cp -rf starship.toml ~/.config/

2. Step

Arch Linux / Linux

mkdir -p ~/.config/nushell run_command "cp -rf GentlemanNushell/* ~/.config/nushell/"

Mac

mkdir -p ~/Library/Application\ Support/nushell ## udpate config to use macif grep -q "/home/linuxbrew/.linuxbrew/bin" GentlemanNushell/env.nu;then awk -v search="/home/linuxbrew/.linuxbrew/bin" -v replace=" | prepend '/opt/homebrew/bin'"' $0 ~ search{print replace; next}{print}' GentlemanNushell/env.nu > GentlemanNushell/env.nu.tmp && mv GentlemanNushell/env.nu.tmp GentlemanNushell/env.nu elseecho" | prepend '/opt/homebrew/bin'">> GentlemanNushell/env.nu fi cp -rf GentlemanNushell/*~/Library/Application\ Support/nushell/

Fish + Starship

brew install fish carapace zoxide atuin starship fzf mkdir -p ~/.cache/starship mkdir -p ~/.cache/carapace mkdir -p ~/.local/share/atuin cp -rf starship.toml ~/.config/ cp -rf GentlemanFish/fish ~/.config

Zsh + Power10k**

brew install zsh carapace zoxide atuin fzf brew install zsh-autosuggestions zsh-syntax-highlighting zsh-autocomplete mkdir -p ~/.cache/carapace mkdir -p ~/.local/share/atuin cp -rf GentlemanZsh/.zshrc ~/ cp -rf GentlemanZsh/.p10k.zsh ~/ cp -rf GentlemanZsh/.oh-my-zsh ~/ brew install powerlevel10k

5. Choose and Install Window Manager

Tmux

brew install tmux git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm mkdir -p ~/.tmux cp -r GentlemanTmux/.tmux/*~/.tmux/ cp GentlemanTmux/.tmux.conf ~/ tmux new-session -d -s plugin-installation 'source ~/.tmux.conf; tmux run-shell ~/.tmux/plugins/tpm/bin/install_plugins' tmux kill-session -t plugin-installation

Zellij

1. Step => Install Zellij

cargo install zellij mkdir -p ~/.config/zellij cp -r GentlemanZellij/zellij/*~/.config/zellij/

2. Step => If you use ZSH

# update or replace TMUXif grep -q "TMUX"~/.zshrc;then awk -v search="TMUX" -v replace='WM_VAR="/$ZELLIJ"'' $0 ~ search{print replace; next}{print}'~/.zshrc >~/.zshrc.tmp && mv ~/.zshrc.tmp ~/.zshrc elseecho'WM_VAR="/$ZELLIJ"'>>~/.zshrc fi# update or replace tmuxif grep -q "tmux"~/.zshrc;then awk -v search="tmux" -v replace='WM_CMD="zellij"'' $0 ~ search{print replace; next}{print}'~/.zshrc >~/.zshrc.tmp && mv ~/.zshrc.tmp ~/.zshrc elseecho'WM_CMD="zellij"'>>~/.zshrc fi

3. Step => If you use Fish

if grep -q "TMUX"~/.config/fish/config.fish;then awk -v search="TMUX" -v replace="if not set -q ZELLIJ"' $0 ~ search{print replace; next}{print}'~/.config/fish/config.fish >~/.config/fish/config.fish.tmp && mv ~/.config/fish/config.fish.tmp ~/.config/fish/config.fish elseecho"if not set -q ZELLIJ">>~/.config/fish/config.fish fi# update or replace tmuxif grep -q "tmux"~/.config/fish/config.fish;then awk -v search="tmux" -v replace="zellij"' $0 ~ search{print replace; next}{print}'~/.config/fish/config.fish >~/.config/fish/config.fish.tmp && mv ~/.config/fish/config.fish.tmp ~/.config/fish/config.fish elseecho"zellij">>~/.config/fish/config.fish fi

3. Step => If you use Nushell

Mac

# update or replace "tmux"if grep -q '"tmux"' GentlemanNushell/config.nu;then awk -v search='"tmux"' -v replace='let MULTIPLEXER = "zellij"'' $0 ~ search{print replace; next}{print}' GentlemanNushell/config.nu > GentlemanNushell/config.nu.tmp && mv GentlemanNushell/config.nu.tmp GentlemanNushell/config.nu elseecho'let MULTIPLEXER = "zellij"'>> GentlemanNushell/config.nu fi# update or replace "TMUX"if grep -q '"TMUX"' GentlemanNushell/config.nu;then awk -v search='"TMUX"' -v replace='let MULTIPLEXER_ENV_PREFIX = "ZELLIJ"'' $0 ~ search{print replace; next}{print}' GentlemanNushell/config.nu > GentlemanNushell/config.nu.tmp && mv GentlemanNushell/config.nu.tmp GentlemanNushell/config.nu elseecho'let MULTIPLEXER_ENV_PREFIX = "ZELLIJ"'>> GentlemanNushell/config.nu fi# copy files to nushell support directory cp -rf GentlemanNushell/*~/Library/Application\ Support/nushell/

Arch Linux / Linux

if grep -q '"tmux"'~/.config/nushell/config.nu;then awk -v search='"tmux"' -v replace='let MULTIPLEXER = "zellij"'' $0 ~ search{print replace; next}{print}'~/.config/nushell/config.nu >~/.config/nushell/config.nu.tmp && mv ~/.config/nushell/config.nu.tmp ~/.config/nushell/config.nu elseecho'let MULTIPLEXER = "zellij"'>>~/.config/nushell/config.nu fi# update or replace "TMUX"if grep -q '"TMUX"'~/.config/nushell/config.nu;then awk -v search='"TMUX"' -v replace='let MULTIPLEXER_ENV_PREFIX = "ZELLIJ"'' $0 ~ search{print replace; next}{print}'~/.config/nushell/config.nu >~/.config/nushell/config.nu.tmp && mv ~/.config/nushell/config.nu.tmp ~/.config/nushell/config.nu elseecho'let MULTIPLEXER_ENV_PREFIX = "ZELLIJ"'>>~/.config/nushell/config.nu fi

6. Install NVIM

brew install nvim node npm git gcc fzf fd ripgrep coreutils bat curl lazygit tree-sitter mkdir -p ~/.config/nvim cp -r GentlemanNvim/nvim/*~/.config/nvim/ # update or replace /your/notes/pathif grep -q "/your/notes/path""$HOME/.config/nvim/lua/plugins/obsidian.lua";then awk -v search="/your/notes/path" -v replace="path = '$OBSIDIAN_PATH'"' $0 ~ search{print replace; next}{print}'"$obsidian_config_file">"${obsidian_config_file}.tmp"&& mv "${obsidian_config_file}.tmp""$obsidian_config_file"elseecho"path = '$OBSIDIAN_PATH'">>"$obsidian_config_file"fi

Manual Obsidian Configuration
To set up your Obsidian vault path in Neovim:
1. Create the directory for your Obsidian notes (replace /path/to/your/notes with your desired path):
```
mkdir -p /path/to/your/notes
```
2. Create a templates folder inside your notes directory:
```
mkdir -p /path/to/your/notes/templates
```
3. Edit the obsidian.lua file to configure the vault path:
```
nvim ~/.config/nvim/lua/plugins/obsidian.lua
```
4. Update the path setting in obsidian.lua:
```
path="/path/to/your/notes",
```
5. Save and close the file.

7. Set Default Shell

1. Step

ZSH

shell_path=$(which "zsh")

Fish

shell_path=$(which "fish")

Nushell

shell_path=$(which "nu")

2. Step => Execute to Replace Default Shell

if [ -n"$shell_path" ];then# Add shell to /etc/shells if not already present sudo sh -c "grep -Fxq \"$shell_path\" /etc/shells || echo \"$shell_path\" >> /etc/shells"# Change the default shell for the user sudo chsh -s "$shell_path""$USER"# Verify if the shell has been changedif [ "$SHELL"!="$shell_path" ];thenecho -e "${RED}Error: Shell did not change. Please check manually.${NC}"echo -e "${GREEN}Command: sudo chsh -s $shell_path\$USER ${NC}"elseecho -e "${GREEN}Shell changed to $shell_path successfully.${NC}"fielseecho -e "${RED}Shell $shell_choice not found.${NC}"fi# Execute the chosen shellexec$shell_choice

8. Restart the Shell or Computer

Close and reopen your terminal, or restart your computer or WSL instance for the changes to take effect.

You're done! You have manually configured your development environment following the Gentleman.Dots guide. Enjoy your new setup!

Note: If you encounter any problems during configuration, consult the official documentation of the tools or seek help online.

Happy coding!

AI Configuration for Neovim

This configuration includes several AI assistants integrated with Neovim. By default, OpenCode is enabled as the primary AI assistant with the custom Gentleman agent, while all other AI plugins are disabled.

Available AI Assistants

The configuration includes support for the following AI tools:

Plugin	Description	Status
OpenCode.nvim	OpenCode AI integration with Gentleman agent	✅ Enabled by default
Avante.nvim	AI-powered coding assistant	Disabled
CopilotChat.nvim	GitHub Copilot chat interface	Disabled
CodeCompanion.nvim	Multi-AI provider support	Disabled
Claude Code.nvim	Claude AI integration	Disabled
Gemini.nvim	Google Gemini integration	Disabled

How to Switch AI Plugins

OpenCode.nvim is enabled by default with the Gentleman agent configuration. All plugin states are managed in a single file:

nvim ~/.config/nvim/lua/plugins/disabled.lua

This file shows all available AI plugins with their current state. To switch:

Find the plugin you want to disable and set enabled = false
Find the plugin you want to enable and set enabled = true
Save and restart Neovim

Example - switching from OpenCode to Claude Code:

{"NickvanDyke/opencode.nvim", enabled=false, -- Disable OpenCode },{"coder/claudecode.nvim", enabled=true, -- Enable Claude Code },

Important Notes

Only enable ONE AI plugin at a time to avoid conflicts and keybinding issues
Required CLI tools are automatically installed by the script:
- OpenCode CLI (curl -fsSL https://opencode.ai/install | bash)
- Claude Code CLI (curl -fsSL https://claude.ai/install.sh | bash)
- Gemini CLI (brew install gemini-cli)
API keys may be required for some services - check each plugin's documentation
Node.js 18+ is required for most AI plugins (automatically handled by the configuration)

Recommended AI Assistants

For the full Gentleman experience: Use OpenCode.nvim (default) - comes with the custom Gentleman agent that verifies, challenges, and proposes alternatives
For Claude users: Use Claude Code.nvim with the Claude Code CLI
For GitHub Copilot users: Use CopilotChat.nvim
For multi-provider flexibility: Use CodeCompanion.nvim - supports multiple AI providers
For Google Gemini users: Use Gemini.nvim with the Gemini CLI

OpenCode Configuration

OpenCode is installed automatically with a custom Gentleman agent and theme. This agent is designed to be a collaborative partner, not a yes-man.

Gentleman Agent Philosophy

The Gentleman agent is a Senior Architect persona with 15+ years of experience. Key characteristics:

Never a Yes-Man: Won't say "you're right" without verifying first. Uses "let's check that" or "dejame verificar eso" instead.
Collaborative Partner: Like Jarvis to Tony Stark - provides data, alternatives, and pushes back when needed.
Proposes Alternatives: Always presents options with tradeoffs: "Option A does X, Option B does Y..."
Verifies Before Agreeing: When you challenge a suggestion, it investigates first using available tools.
Bilingual: Responds in Rioplatense Spanish (Argentina/Uruguay slang) if you write in Spanish, or confrontational English if you write in English.

Using the Gentleman Agent

To use the Gentleman agent in OpenCode:

Open OpenCode in your terminal:
```
opencode
```
Type /agent and press Enter
Select gentleman from the list

That's it! The agent will now respond with the Gentleman personality.

Default Model

The current default model is determined by OpenCode's configuration. To change it, edit your opencode.json:

nvim ~/.config/opencode/opencode.json

Add or modify the model field:

{"$schema": "https://opencode.ai/config.json", "theme": "gentleman", "model": "anthropic/claude-sonnet-4-20250514", "agent":{"gentleman":{... } } }

Available Models

Some popular model options:

Provider	Model ID
Anthropic	`anthropic/claude-sonnet-4-20250514`
Anthropic	`anthropic/claude-haiku-4-20250514`
OpenAI	`openai/gpt-4o`
OpenAI	`openai/gpt-4o-mini`
Google	`google/gemini-2.0-flash`
Google	`google/gemini-2.5-pro-preview-06-05`

You can also set a specific model per agent:

{"agent":{"gentleman":{"model": "anthropic/claude-sonnet-4-20250514", ... } } }

OpenCode Theme

The configuration includes a custom Gentleman theme with a dark background and Kanagawa-inspired colors. The theme is automatically applied when you run OpenCode.

MCP Integrations

The Gentleman OpenCode config includes MCP (Model Context Protocol) integration:

Context7: Remote MCP for fetching up-to-date documentation

This is enabled by default and enhances the agent's ability to verify information with current docs.

Name		Name	Last commit message	Last commit date
Latest commit History 578 Commits
GentlemanFish/fish		GentlemanFish/fish
GentlemanGhostty		GentlemanGhostty
GentlemanKitty		GentlemanKitty
GentlemanNushell		GentlemanNushell
GentlemanNvim/nvim		GentlemanNvim/nvim
GentlemanOpenCode		GentlemanOpenCode
GentlemanTmux		GentlemanTmux
GentlemanZellij/zellij		GentlemanZellij/zellij
GentlemanZsh		GentlemanZsh
.wezterm.lua		.wezterm.lua
README.md		README.md
alacritty.toml		alacritty.toml
bash-env-json		bash-env-json
bash-env.nu		bash-env.nu
install-linux-mac.sh		install-linux-mac.sh
starship.toml		starship.toml

Gentleman-Programming/Gentleman.Dots

Folders and files

Latest commit

History

Repository files navigation

Gentleman.Dots

Description

Installation (Automatic Recommended!)

The Easy Way! Test the automated process and let the script do all the work for you 😘

Manual Installation

1. Install WSL

2. Install a Linux Distribution

3. Installing the Iosevka Font

4. Launch and Configure the Distribution

5. Install a Terminal Emulator

6. Configuration Transfer for Terminal Emulators

7. Install Chocolatey and win32yank

Prerequisites

1. Install Dependencies

Arch Linux

Linux

Mac

2. Install Iosevka Term Nerd Font (icons and font style)

Arch Linux / Linux

Mac

3. Choose and Install Terminal Emulator

Alacritty

Arch Linux

Mac

Linux

WezTerm

Arch Linux

Mac

Linux

Ghostty

Arch Linux

Mac

Linux

Kitty

Mac

4. Choose and Install a Shell

Nushell

1. Step

2. Step

Fish + Starship

Zsh + Power10k**

5. Choose and Install Window Manager

Tmux

Zellij

1. Step => Install Zellij

2. Step => If you use ZSH

3. Step => If you use Fish

3. Step => If you use Nushell

6. Install NVIM

7. Set Default Shell

1. Step

2. Step => Execute to Replace Default Shell

8. Restart the Shell or Computer

AI Configuration for Neovim

Available AI Assistants

How to Switch AI Plugins

Important Notes

Recommended AI Assistants

OpenCode Configuration

Gentleman Agent Philosophy

Using the Gentleman Agent

Default Model

Available Models

OpenCode Theme

MCP Integrations

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases 11

Packages 0

Contributors 11

Uh oh!

Packages