Skip to content
Back to search

Gentleman.Dots

My personal configuration for LazyVim !

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gentleman-programming--gentleman-dots/badge.svg)](/listings/gentleman-programming--gentleman-dots)

HTML

<a href="/listings/gentleman-programming--gentleman-dots"><img src="/api/listings/gentleman-programming--gentleman-dots/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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 locally. See the [Termux Installation Guide](docs/manual-installation.md#termux) for full instructions.

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

During multiplexer selection, choose **Tmux**, **Zellij**, **Herdr**, or **None**. Fish, Zsh, and Nushell are patched to auto-start the selected multiplexer on fresh interactive shells while avoiding nested sessions.

> **Tmux users:** After installation, open tmux and press `prefix + I` (capital I) to install plugins via TPM. This ensures the theme and all plugins load correctly.

> **Windows users:** You must set up WSL first. See the [Manual Installation Guide](docs/manual-installation.md#windows-wsl).

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 225 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Gentleman.Dots
  2. > 🤖 **NEW**: The AI development layer now lives in its own installer — [**AI Gentle Stack (gentle-ai)**](https://github.com/Gentleman-Programming/gentle-ai). It configures Claude Code, OpenCode, Gemini CLI, Cursor, and VS Code Copilot with persistent memory, SDD workflow, skills, and the Gentleman persona. Install Gentleman.Dots first, then run `gentle-ai` for the AI layer.
  3. 📄 Read this in: **English** | [Español](README.es.md)
  4. ## Table of Contents
  5. - [What is this?](#what-is-this)
  6. - [Quick Start](#quick-start)
  7. - [Supported Platforms](#supported-platforms)
  8. - [AI Development Layer](#-ai-development-layer)
  9. - [Vim Mastery Trainer](#-vim-mastery-trainer)
  10. - [Documentation](#documentation)
  11. - [Tools Overview](#tools-overview)
  12. - [Bleeding Edge](#bleeding-edge)
  13. - [Support](#support)
  14. ---
  15. ## Preview
  16. ### TUI Installer
  17. <img width="1424" height="1536" alt="TUI Installer" src="https://github.com/user-attachments/assets/1db56d3b-a8c0-4885-82aa-c5ec04af4ac0" />
  18. ### Showcase
  19. <img width="3840" height="2160" alt="Development Environment Showcase" src="https://github.com/user-attachments/assets/fff14c05-9676-4e04-b05e-dab5e3cf300a" />
  20. ---
  21. ## What is this?
  22. A complete development environment configuration including:
  23. - **Neovim** with LSP, autocompletion, and AI integration
  24. - **Shells**: Fish, Zsh, Nushell
  25. - **Terminal Multiplexers**: Tmux, Zellij, Herdr
  26. - **Terminal Emulators**: Alacritty, WezTerm, Kitty, Ghostty
  27. - **AI CLI Tools**: Claude Code and OpenCode CLI installers (configs managed by [gentle-ai](https://github.com/Gentleman-Programming/gentle-ai))
  28. ## Quick Start
  29. ### Option 1: Homebrew (Recommended)
  30. ```bash
  31. brew install Gentleman-Programming/tap/gentleman-dots
  32. gentleman-dots
  33. ```
  34. ### Option 2: Direct Download
  35. ```bash
  36. # macOS Apple Silicon
  37. curl -fsSL https://github.com/Gentleman-Programming/Gentleman.Dots/releases/latest/download/gentleman-installer-darwin-arm64 -o gentleman.dots
  38. # macOS Intel
  39. curl -fsSL https://github.com/Gentleman-Programming/Gentleman.Dots/releases/latest/download/gentleman-installer-darwin-amd64 -o gentleman.dots
  40. # Linux x86_64
  41. curl -fsSL https://github.com/Gentleman-Programming/Gentleman.Dots/releases/latest/download/gentleman-installer-linux-amd64 -o gentleman.dots
  42. # Linux ARM64 (Raspberry Pi, etc.)
  43. curl -fsSL https://github.com/Gentleman-Programming/Gentleman.Dots/releases/latest/download/gentleman-installer-linux-arm64 -o gentleman.dots
  44. # Then run
  45. chmod +x gentleman.dots
  46. ./gentleman.dots
  47. ```
  48. ### Option 3: Termux (Android)
  49. Termux requires building locally. See the [Termux Installation Guide](docs/manual-installation.md#termux) for full instructions.
  50. The TUI guides you through selecting your preferred tools and handles all the configuration automatically.
  51. During multiplexer selection, choose **Tmux**, **Zellij**, **Herdr**, or **None**. Fish, Zsh, and Nushell are patched to auto-start the selected multiplexer on fresh interactive shells while avoiding nested sessions.
  52. > **Tmux users:** After installation, open tmux and press `prefix + I` (capital I) to install plugins via TPM. This ensures the theme and all plugins load correctly.
  53. > **Windows users:** You must set up WSL first. See the [Manual Installation Guide](docs/manual-installation.md#windows-wsl).
  54. ---
  55. ## Supported Platforms
  56. | Platform | Architecture | Install Method | Package Manager |
  57. |----------|--------------|----------------|-----------------|
  58. | macOS | Apple Silicon (ARM64) | Homebrew, Direct Download | Homebrew |
  59. | macOS | Intel (x86_64) | Homebrew, Direct Download | Homebrew |
  60. | Linux (Ubuntu/Debian) | x86_64, ARM64 | Homebrew, Direct Download | Homebrew |
  61. | Linux (Fedora/RHEL) | x86_64, ARM64 | Direct Download | dnf |
  62. | Linux (Arch) | x86_64 | Homebrew, Direct Download | Homebrew |
  63. | Windows | WSL | Direct Download (see docs) | Homebrew |
  64. | Android | Termux (ARM64) | Build locally (see above) | pkg |
  65. ---
  66. ## 🤖 AI Development Layer
  67. Gentleman.Dots handles your **dev environment** (editor, shells, terminals). For the **AI development layer** (agents, memory, skills, workflow), use the companion project:
  68. ### [AI Gentle Stack (gentle-ai)](https://github.com/Gentleman-Programming/gentle-ai)
  69. ```bash
  70. brew install Gentleman-Programming/tap/gentle-ai
  71. gentle-ai
  72. ```
  73. It configures your AI coding agents with everything they need:
  74. | Component | What it does |
  75. |-----------|-------------|
  76. | **Engram** | Persistent memory across sessions (MCP server) |
  77. | **SDD Workflow** | Spec-Driven Development with orchestrated sub-agents |
  78. | **Skills** | 24 coding pattern libraries (React 19, Next.js 15, TypeScript, Tailwind 4, etc.) |
  79. | **Context7** | Up-to-date library documentation via MCP |
  80. | **Persona** | Gentleman teaching style for AI responses |
  81. | **Permissions** | Security-first defaults for all agents |
  82. ### Supported Agents
  83. | Agent | Single Agent | Multi Agent |
  84. |-------|:----------:|:-----------:|
  85. | **Claude Code** | ✅ | ✅ |
  86. | **OpenCode** | ✅ | ✅ |
  87. | **Gemini CLI** | ✅ | ✅ |
  88. | **Cursor** | ✅ | — |
  89. | **VS Code Copilot** | ✅ | — |
  90. > **Single agent**: One orchestrator handles all SDD phases.
  91. > **Multi agent**: Dedicated sub-agent per phase with individual model routing (e.g., Claude Opus for design, Gemini for specs, GPT for verification).
  92. ### What lives where
  93. | | This repo (Gentleman.Dots) | gentle-ai |
  94. |--|---------------------------|-----------|
  95. | **Purpose** | Dev environment (editors, shells, terminals) | AI development layer (agents, memory, skills) |
  96. | **Installs** | Neovim, Fish/Zsh/Nushell, Tmux/Zellij/Herdr, Ghostty | Configures Claude Code, OpenCode, Gemini CLI, Cursor, VS Code Copilot |
  97. | **AI configs** | CLI tools only (Claude Code, OpenCode) | Full config: persona, skills, themes, MCP |
  98. Install Gentleman.Dots first for your dev environment, then `gentle-ai` for the AI layer on top.
  99. ---
  100. ## 🎮 Vim Mastery Trainer
  101. Learn Vim the fun way! The installer includes an interactive RPG-style trainer with:
  102. | Module | Keys Covered |
  103. |--------|--------------|
  104. | 🔤 Horizontal Movement | `w`, `e`, `b`, `f`, `t`, `0`, `$`, `^` |
  105. | ↕️ Vertical Movement | `j`, `k`, `G`, `gg`, `{`, `}` |
  106. | 📦 Text Objects | `iw`, `aw`, `i"`, `a(`, `it`, `at` |
  107. | ✂️ Change & Repeat | `d`, `c`, `dd`, `cc`, `D`, `C`, `x` |
  108. | 🔄 Substitution | `r`, `R`, `s`, `S`, `~`, `gu`, `gU`, `J` |
  109. | 🎬 Macros & Registers | `qa`, `@a`, `@@`, `"ay`, `"+p` |
  110. | 🔍 Regex/Search | `/`, `?`, `n`, `N`, `*`, `#`, `\v` |
  111. Each module includes 15 progressive lessons, practice mode with intelligent exercise selection, boss fights, and XP tracking.
  112. Launch it from the main menu: **Vim Mastery Trainer**
  113. ---
  114. ## Documentation
  115. | Document | Description |
  116. |----------|-------------|
  117. | [TUI Installer Guide](docs/tui-installer.md) | Interactive installer features, navigation, backup/restore |
  118. | [Manual Installation](docs/manual-installation.md) | Step-by-step manual setup for all platforms |
  119. | [Neovim Keymaps](docs/neovim-keymaps.md) | Complete reference of all keybindings |
  120. | [AI Configuration](docs/ai-configuration.md) | Claude Code, OpenCode, Copilot, and other AI assistants |
  121. | [AI Gentle Stack](https://github.com/Gentleman-Programming/gentle-ai) | AI layer installer — Engram, SDD, Skills, Persona (separate repo) |
  122. | [Vim Trainer Spec](docs/vim-trainer-spec.md) | Technical specification for the Vim Mastery Trainer |
  123. | [Docker Testing](docs/docker-testing.md) | E2E testing with Docker containers |
  124. | [Contributing](docs/contributing.md) | Development setup, skills system, E2E tests, release process |
  125. ---
  126. ## Tools Overview
  127. - **Terminal Emulators**: Ghostty, Kitty, WezTerm, Alacritty
  128. - **Shells**: Nushell, Fish, Zsh (+ Powerlevel10k)
  129. - **Multiplexers**: Tmux, Zellij, Herdr
  130. - **Editor**: Neovim (LazyVim with LSP, completions, AI)
  131. - **Prompt**: Starship
  132. > See [Tools Reference](docs/tools.md) for detailed descriptions of each tool.
  133. ---
  134. ## Bleeding Edge
  135. Want the latest experimental features from my daily workflow (macOS only)?
  136. Check out the [`nix-migration` branch](https://github.com/Gentleman-Programming/Gentleman.Dots/tree/nix-migration).
  137. This branch contains cutting-edge configurations that eventually make their way to `main` once stable.
  138. ---
  139. ## Support
  140. - **Issues**: [GitHub Issues](https://github.com/Gentleman-Programming/Gentleman.Dots/issues)
  141. - **Discord**: [Gentleman Programming Community](https://discord.gg/gentleman-programming)
  142. - **YouTube**: [@GentlemanProgramming](https://youtube.com/@GentlemanProgramming)
  143. - **Twitch**: [GentlemanProgramming](https://twitch.tv/GentlemanProgramming)
  144. ---
  145. ## License
  146. MIT License - feel free to use, modify, and share.
  147. **Happy coding!** 🎩
  148. ---
  149. ## Contributors
  150. Thanks to everyone who has contributed to Gentleman.Dots!
  151. [![Contributors](https://contrib.rocks/image?repo=Gentleman-Programming/Gentleman.Dots)](https://github.com/Gentleman-Programming/Gentleman.Dots/graphs/contributors)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.