Refactor consolidate skip options

[ankalago]

This pull request adds first-class support for AI coding assistants (OpenCode, Kilo Code, Continue.dev, and Aider) to the installer, documentation, and configuration workflow. Users can now select AI assistants during installation (both TUI and non-interactive modes), and the documentation has been updated to reflect these new options, including step-by-step installation instructions and skill management. The changes also introduce selective installation for all components, allowing users to skip steps and preserve their existing setups.

Installer Enhancements:

• Added --ai flag to the installer CLI for specifying AI assistants to install (opencode, kilocode, continue, aider), including validation and integration with user choices in non-interactive mode (main.go). [1] [2] [3] [4] [5] [6] [7]
• Updated config path detection to recognize new AI assistant config directories (opencode, kilocode, continue).

Documentation Updates:

• Updated README.md and README.es.md to list supported AI assistants, describe their features/status, and explain selective installation. [1] [2] [3] [4] [5] [6]
• Expanded the manual installation guide with detailed steps for installing and configuring each AI assistant, including copying skills and available skill descriptions. [1] [2] [3]

TUI Installer Workflow:

• Added a dedicated step for selecting AI coding assistants in the TUI installer, supporting multi-selection and skip options. Clarified keyboard shortcuts and updated step numbering. [1] [2] [3] [4]
• Documented AI assistant installation flow, skills directory management, and both interactive and non-interactive usage in the TUI installer guide. [1] [2] [3]

Selective Installation:

• Introduced "Skip this step" options for each configuration phase, allowing users to install only specific components and preserve existing configurations. [1] [2]

Skill Management:

• Standardized and documented the process for copying and loading AI assistant skills from the GentlemanClaude/skills/ directory for all supported assistants. [1] [2] [3] [4]

Screenshots

[Alan-TheGentleman]

Hey Paul! Thanks for this comprehensive PR 👏 The AI assistants feature and skip options are great additions.

Tests Failing

Some tests are failing, please fix before merge:

FAIL: TestEachTerminalSelection/mac/none - Expected terminal=none, got ""
FAIL: TestEachTerminalSelection/linux/none - Expected terminal=none, got ""
FAIL: TestEachWMSelection/none - Expected wm=none, got ""
FAIL: TestNavigationBackwardsAndChangeSelection - Expected ScreenNvimSelect, got LearnNvim
FAIL: TestMainMenuGolden - Missing "🔄 Restore from Backup" in menu

AI Assistants Screen - Conditional Logic

Currently Claude Code installs automatically with Neovim (required for AI features). The screen needs conditional behavior:

If user SELECTED Neovim:

• Show note: "ℹ️ Claude Code is installed automatically with Neovim (required for AI features)"
• Claude Code should NOT appear in the list (already installed)
• Add link/button to open docs/ai-configuration.md (explains how to switch AI plugins in Neovim)

If user SKIPPED Neovim:

• Claude Code SHOULD appear as an optional item in the list
• No link to AI docs (it's Neovim-specific)

Opening URLs from Bubbletea

import "os/exec"

func openURL(url string) error {
    switch runtime.GOOS {
    case "darwin":
        return exec.Command("open", url).Start()
    case "linux":
        return exec.Command("xdg-open", url).Start()
    }
    return nil
}

One more thing!

We also have gemini.lua in Neovim plugins. Would be good to add Gemini CLI to the AI assistants list as well for consistency.

Current Neovim AI plugins:

• claude-code.lua ✅ (required with Neovim)
• opencode.lua ✅ (in your list)
• gemini.lua ❌ (missing from list)
• copilot.lua (needs subscription, maybe skip?)
• avante.lua (multi-provider, maybe skip?)

At minimum, Gemini CLI should be an option since we have the Neovim plugin for it.

And GitHub Copilot CLI too! We have copilot.lua and copilot-chat.lua plugins.

So the full list of AI assistants to consider:

Claude Code ✅
OpenCode ✅
Gemini CLI
GitHub Copilot CLI

These are the ones with both CLI + Neovim plugin integration.

Summary

• Fix the 5 failing tests
• If Neovim selected → show Claude Code note + link to AI docs
• If Neovim skipped → list Claude Code as optional, no docs link
• Add Github Copilot CLI
• Add Gemini CLI

Let me know if you have questions! 🚀