Skip to main content

​
Philosophy

Gentleman.Dots embraces AI as a collaborative partner, not a replacement for thinking. The configuration includes multiple AI assistants, each with different strengths, but all designed to enhance your development workflow without getting in your way.

​
The Gentleman Approach to AI

The default AI configuration follows these principles:

Never a Yes-Man

AI should challenge your assumptions and verify claims before agreeing. “Let me check that” over “you’re right.”

Propose Alternatives

Every solution should come with tradeoffs. “Option A does X, Option B does Y” - you decide.

Verify First

When challenged, the AI investigates using available tools instead of defending its position.

Collaborative Partner

Like Jarvis to Tony Stark - provides data, questions decisions, and pushes back when needed.

​
Available AI Assistants

The configuration includes six AI integration options. OpenCode is enabled by default with the custom Gentleman agent, while all others are disabled to avoid conflicts.

OpenCode.nvim

Status: ✅ Enabled by defaultOpenCode AI integration with custom Gentleman agent configuration. This is the recommended option for the full Gentleman experience.Key Features:
  • Custom Gentleman agent with 15+ years of experience persona
  • Modern CLI tools integration (bat, rg, fd, sd, eza)
  • Bilingual support (Spanish/English)
  • MCP integration with Context7 for up-to-date documentation
  • Custom Gentleman theme with Kanagawa colors
Best For: Developers who want a collaborative AI that challenges assumptions and proposes alternatives.Learn more →
Status: DisabledAI-powered coding assistant with cursor planning mode and diff management. Supports multiple providers including Copilot.Key Features:
  • Cursor planning mode for strategic code changes
  • Visual diff management with accept/reject
  • Custom Gentleman system prompt
  • Snacks file selector integration
  • Sidebar layout (left side, 30% width)
Best For: Developers who prefer visual diff management and cursor-based planning.
Status: DisabledOfficial GitHub Copilot chat interface for Neovim with extensive prompt library.Key Features:
  • GitHub Copilot integration
  • Claude 3.5 Sonnet model
  • 15+ built-in prompts (Explain, Review, Tests, Refactor, etc.)
  • Custom Gentleman system prompt
  • Horizontal layout
Best For: GitHub Copilot subscribers who want chat capabilities.
Status: DisabledMulti-AI provider support with custom tool groups and slash commands.Key Features:
  • Multiple adapters (Copilot, GPT-4o, GPT-4.1, Gemini 2.5 Pro)
  • Custom “gentleman” tool group
  • Inline diff mode
  • Custom slash commands (git_files)
  • Command runner, editor, and file tools
Best For: Developers who want flexibility across multiple AI providers.
Status: DisabledDirect Claude AI integration via the Claude Code CLI.Key Features:
  • Native Claude integration
  • Terminal split (left side, 30%)
  • Snacks provider integration
  • Model selection
  • Diff accept/deny keybindings
Best For: Claude users who want direct CLI integration.Requirements: Claude Code CLI (curl -fsSL https://claude.ai/install.sh | bash)
Status: DisabledGoogle Gemini AI integration via gemini-cli.Key Features:
  • Google Gemini models
  • Simple setup
  • gemini-cli integration
Best For: Google Gemini users.Requirements: Gemini CLI (brew install gemini-cli)

​
Default Configuration

OpenCode.nvim is enabled by default with the Gentleman agent. All other plugins are disabled to prevent conflicts.
1

OpenCode (Enabled)

Provides the full Gentleman experience with custom agent, modern CLI tools, and collaborative AI interaction.
2

All Others (Disabled)

Avante, CopilotChat, CodeCompanion, Claude Code, and Gemini are disabled by default. You can enable any one of them by editing ~/.config/nvim/lua/plugins/disabled.lua.
Important: Only enable ONE AI plugin at a time to avoid keybinding conflicts and unexpected behavior.

​
Switching AI Plugins

All plugin states are managed in a single file. See the detailed guide: How to Switch AI Plugins →

​
The Gentleman Agent

The default OpenCode configuration includes a custom agent designed to be a collaborative partner: 
# In OpenCode terminal
opencode

# Type and press Enter
/agent

# Select "gentleman" from the list
Learn more about the Gentleman agent →

​
CLI Tools Integration

The Gentleman agent is configured to use modern CLI tools exclusively:
Modern ToolReplacesPurpose
batcatSyntax-highlighted file viewing
rg (ripgrep)grepFast recursive search
fdfindUser-friendly file finding
sdsedModern text replacement
ezalsBeautiful file listings
The agent will automatically install missing tools via Homebrew before using them.

​
MCP Integration

The OpenCode configuration includes Model Context Protocol (MCP) integration: 
{
  "mcp": {
    "context7": {
      "type": "remote",
      "url": "https://mcp.context7.com/mcp",
      "enabled": true
    }
  }
}
Context7 provides up-to-date documentation fetching, enhancing the agent’s ability to verify information with current docs.

​
Next Steps

OpenCode Setup

Learn about OpenCode configuration, keybindings, and the Gentleman theme

Gentleman Agent

Explore the Gentleman agent’s personality, philosophy, and interaction style

Switch Plugins

Step-by-step guide to enabling different AI assistants

Build docs developers (and LLMs) love

Get started for freeTalk to us