feat(ai): add Crush multi-model AI coding agent to toolset

This commit introduces Crush, a new multi-model AI coding agent that enhances the existing suite of AI tools. The Crush tool supports in-session model switching, session management for context preservation, and LSP integration for improved code understanding.

Key changes include:
- Installation of the Crush CLI via npm in the Dockerfile.
- Updated setup scripts to include Crush in the initialization process.
- Addition of detailed documentation outlining Crush's features, setup instructions, and usage examples.

These updates aim to provide developers with more flexibility in managing AI interactions, allowing them to switch between multiple models seamlessly while maintaining contextual awareness across sessions.

Author: Frederik Wystup

code-server/Dockerfile

@@ -38,7 +38,7 @@ RUN curl -LsSf https://astral.sh/uv/install.sh | sh && \
 RUN pip3 install --break-system-packages aider-chat
 
 # Install Node.js AI tools (first install most tools, then OpenAI Codex separately)
-RUN npm install -g @google/gemini-cli @anthropic-ai/claude-code @qwen-code/qwen-code@latest
+RUN npm install -g @google/gemini-cli @anthropic-ai/claude-code @qwen-code/qwen-code@latest @charmland/crush
 
 # Install OpenAI Codex with environment variables to use system ripgrep
 ENV VSCODE_RIPGREP_BINARY_PATH=/usr/bin/rg

code-server/setup-scripts/workspace-init.sh

@@ -105,10 +105,11 @@ echo "  • Gemini CLI - Google's AI coding assistant (pre-installed)"
 echo "  • Claude Code - Anthropic's AI coding tool (pre-installed)"
 echo "  • Qwen Code - AI workflow automation tool (pre-installed)"
 echo "  • OpenAI Codex - OpenAI's coding assistant (pre-installed)"
+echo "  • Crush - Multi-model AI coding agent (pre-installed)"
 echo ""
 echo "⚡ Setup Commands:"
 echo "  • setup_ai_tools - See all AI tool setup instructions"
-echo "  • setup_opencode, setup_aider, setup_gemini, setup_claude, setup_qwen, setup_codex"
+echo "  • setup_opencode, setup_aider, setup_gemini, setup_claude, setup_qwen, setup_codex, setup_crush"
 echo ""
 echo "📁 Current Directory: $(pwd)"
 if [ -d ".git" ]; then
@@ -119,7 +120,7 @@ fi
 echo ""
 echo "🔄 Update Commands:"
 echo "  • update_aider (pip3)"
-echo "  • sudo update_gemini, sudo update_claude, sudo update_qwen, sudo update_codex (npm)"
+echo "  • sudo update_gemini, sudo update_claude, sudo update_qwen, sudo update_codex, sudo update_crush (npm)"
 echo "  • update_opencode (downloads and installs latest version)"
 echo ""
 echo "💡 Pro Tips:"
@@ -181,6 +182,16 @@ echo "✅ OpenAI Codex CLI updated successfully!"
 UPDATE_CODEX_EOF
 chmod +x /usr/local/bin/update_codex
 
+# Update Crush (requires sudo)
+cat > /usr/local/bin/update_crush << 'UPDATE_CRUSH_EOF'
+#!/bin/bash
+echo "🔄 Updating Crush..."
+echo "💡 Note: Run with sudo if you get permission errors"
+npm update -g @charmland/crush
+echo "✅ Crush updated successfully!"
+UPDATE_CRUSH_EOF
+chmod +x /usr/local/bin/update_crush
+
 # Update OpenCode SST
 cat > /usr/local/bin/update_opencode << 'UPDATE_OPENCODE_EOF'
 #!/bin/bash
@@ -381,6 +392,34 @@ setup_codex() {
     echo "   - Auth docs: https://github.com/openai/codex/blob/main/docs/authentication.md"
 }
 
+# Setup Crush
+setup_crush() {
+    echo "🤖 Setting up Crush..."
+    echo ""
+    echo "Crush is already installed!"
+    echo ""
+    echo "To get started:"
+    echo "1. Run: crush"
+    echo "2. Configure your preferred AI provider via environment variables:"
+    echo "   • ANTHROPIC_API_KEY for Anthropic Claude"
+    echo "   • OPENAI_API_KEY for OpenAI"
+    echo "   • GEMINI_API_KEY for Google Gemini"
+    echo "   • GROQ_API_KEY for Groq"
+    echo "   • OPENROUTER_API_KEY for OpenRouter"
+    echo ""
+    echo "💡 Features:"
+    echo "   - Multi-model AI support with in-session switching"
+    echo "   - Session-based context management"
+    echo "   - LSP integration for code understanding"
+    echo "   - MCP support for extensibility"
+    echo "   - Cross-platform terminal interface"
+    echo "   - Permission control for tool execution"
+    echo ""
+    echo "📚 Learn more:"
+    echo "   - GitHub: https://github.com/charmbracelet/crush"
+    echo "   - Docs: https://github.com/charmbracelet/crush#readme"
+}
+
 # Setup all AI tools
 setup_ai_tools() {
     echo "🚀 XaresAICoder AI Tools Setup"
@@ -422,6 +461,12 @@ setup_ai_tools() {
     echo "6️⃣  OpenAI Codex CLI"
     setup_codex
     echo ""
+    echo "----------------------------------------"
+    echo ""
+
+    echo "7️⃣  Crush"
+    setup_crush
+    echo ""
     echo "=============================="
     echo ""
     echo "✅ All AI tools are ready!"
@@ -433,6 +478,7 @@ setup_ai_tools() {
     echo "   • Claude Code: Agentic coding with deep codebase understanding"
     echo "   • Qwen Code: AI workflow automation and code exploration"
     echo "   • OpenAI Codex: OpenAI's terminal-based coding assistant"
+    echo "   • Crush: Multi-model AI with session management and LSP integration"
     echo ""
     echo "🔌 VS Code Extensions (install from marketplace):"
     echo "   • Continue: AI code completion and chat"
@@ -678,7 +724,7 @@ EXTENSIONS_EOF
 }
 
 # Export all functions
-export -f setup_empty_project setup_opencode setup_aider setup_gemini setup_claude setup_qwen setup_codex setup_ai_tools
+export -f setup_empty_project setup_opencode setup_aider setup_gemini setup_claude setup_qwen setup_codex setup_crush setup_ai_tools
 EOF
 
 echo "Workspace initialization setup completed."

docs/AI_TOOLS.md

@@ -22,13 +22,14 @@ XaresAICoder provides a curated selection of AI coding assistants that work seam
 - **Continue** - AI code completion and chat
 - **Cline (Claude Dev)** - AI file editing and automation
 
-**⌨️ Command Line Tools** - Terminal-based AI assistants  
+**⌨️ Command Line Tools** - Terminal-based AI assistants
 - **OpenCode SST** - Multi-model AI with project analysis
 - **Aider** - AI pair programming with git integration
 - **Gemini CLI** - Google's AI for code generation
 - **Claude Code** - Anthropic's agentic coding tool
 - **Qwen Code** - AI workflow automation and code exploration
 - **OpenAI Codex CLI** - OpenAI's terminal-based coding assistant
+- **Crush** - Multi-model AI with session management
 
 ## VS Code Extensions
 
@@ -392,6 +393,129 @@ mode = "workspace-write"
 policy = "untrusted"
 ```
 
+### Crush - Multi-Model AI Coding Agent
+
+**Best for**: Multi-model flexibility, session-based workflows, cross-platform terminal coding
+
+#### Features
+- ✅ **Multi-Model Support** - Switch between OpenAI, Anthropic, Google, Groq, OpenRouter
+- ✅ **Session Management** - Maintain multiple work contexts per project
+- ✅ **In-Session Switching** - Change models without losing conversation context
+- ✅ **LSP Integration** - Enhanced code understanding via Language Server Protocol
+- ✅ **MCP Extensibility** - Model Context Protocol support for custom tools
+- ✅ **Cross-Platform** - Works on all major operating systems
+- ✅ **Permission Control** - Approve or whitelist tool executions
+- ✅ **Configuration Files** - Project-specific and global settings support
+
+#### Setup
+
+##### Quick Setup
+```bash
+# Use the built-in setup command
+setup_crush
+```
+
+##### Manual Setup
+```bash
+# Crush is pre-installed via npm
+
+# Set your preferred API key (choose one or more)
+export ANTHROPIC_API_KEY=your_key_here
+export OPENAI_API_KEY=your_key_here
+export GEMINI_API_KEY=your_key_here
+export GROQ_API_KEY=your_key_here
+export OPENROUTER_API_KEY=your_key_here
+```
+
+#### Usage
+```bash
+# Start interactive session
+crush
+
+# Start or resume named session
+crush --session my-feature
+
+# List all sessions
+crush --list-sessions
+
+# Switch models mid-session (type in Crush)
+/model claude-3-5-sonnet
+/model gpt-4
+/model gemini-pro
+
+# Use specific model from start
+crush --model anthropic/claude-3-5-sonnet-20241022
+```
+
+#### Configuration
+
+Create `.crush.json` in your project root or `~/.config/crush/crush.json` globally:
+
+```json
+{
+  "model": "anthropic/claude-3-5-sonnet-20241022",
+  "temperature": 0.7,
+  "tools": {
+    "allowed": ["read_file", "write_file", "run_command"]
+  },
+  "lsp": {
+    "enabled": true
+  },
+  "sessions": {
+    "auto_save": true,
+    "max_history": 100
+  }
+}
+```
+
+#### Example Session
+```bash
+$ crush
+🎀 Crush v1.0.0
+Using model: claude-3-5-sonnet
+
+> Analyze this codebase and suggest improvements
+
+[Crush analyzes files using LSP and provides suggestions]
+
+> /model gpt-4
+Switched to model: gpt-4
+
+> Implement the suggested changes
+[Crush makes changes with GPT-4 context preserved]
+
+> /save improvement-session
+Session saved: improvement-session
+```
+
+#### Key Features Explained
+
+**Session Management**:
+- Maintain separate contexts for different features/tasks
+- Resume work exactly where you left off
+- Share sessions with team members
+
+**Model Switching**:
+- Switch between models without losing context
+- Use different models for different subtasks
+- Cost optimization by using cheaper models when appropriate
+
+**LSP Integration**:
+- Understands your code structure via Language Server Protocol
+- Better code completion and suggestions
+- Intelligent refactoring capabilities
+
+**Permission System**:
+```bash
+# Approve each tool execution (default)
+crush
+
+# Auto-approve all (use with caution)
+crush --yolo
+
+# Configure approved tools in .crush.json
+```
+
 ## Setup Guide
 
 ### Quick Setup for All Tools
@@ -447,27 +571,29 @@ which gemini
 which claude
 which qwen-code
 which codex
+which crush
 
 # Test API connections
 opencode auth status
 aider --version
 gemini --help
 qwen-code --version
 codex --version
+crush --version
 ```
 
 ## Tool Comparison
 
 ### Use Case Matrix
 
-| Task | Continue | Cline | OpenCode | Aider | Gemini | Claude Code | Qwen Code | Codex CLI |
-|------|----------|-------|----------|-------|--------|-------------|-----------|-----------|
-| **Code Completion** | ⭐⭐⭐ | ⭐ | ⭐ | ⭐ | ⭐⭐ | ⭐ | ⭐ | ⭐⭐ |
-| **File Editing** | ⭐ | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐ | ⭐⭐⭐ | ⭐⭐ | ⭐⭐ |
-| **Project Analysis** | ⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
-| **Git Integration** | ❌ | ⭐ | ❌ | ⭐⭐⭐ | ❌ | ⭐⭐⭐ | ⭐ | ⭐ |
-| **Multi-File Ops** | ❌ | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
-| **Learning Curve** | ⭐⭐⭐ | ⭐⭐ | ⭐⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐ | ⭐⭐ | ⭐⭐⭐ |
+| Task | Continue | Cline | OpenCode | Aider | Gemini | Claude Code | Qwen Code | Codex CLI | Crush |
+|------|----------|-------|----------|-------|--------|-------------|-----------|-----------|-------|
+| **Code Completion** | ⭐⭐⭐ | ⭐ | ⭐ | ⭐ | ⭐⭐ | ⭐ | ⭐ | ⭐⭐ | ⭐⭐ |
+| **File Editing** | ⭐ | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐ | ⭐⭐⭐ | ⭐⭐ | ⭐⭐ | ⭐⭐ |
+| **Project Analysis** | ⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐ |
+| **Git Integration** | ❌ | ⭐ | ❌ | ⭐⭐⭐ | ❌ | ⭐⭐⭐ | ⭐ | ⭐ | ⭐ |
+| **Multi-File Ops** | ❌ | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ | ⭐⭐ |
+| **Learning Curve** | ⭐⭐⭐ | ⭐⭐ | ⭐⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ |
 
 ### Model Support
 
@@ -481,6 +607,7 @@ codex --version
 | **Claude Code** | ❌ | ✅ | ❌ | ❌ |
 | **Qwen Code** | ✅ | ❌ | ❌ | ✅ (Qwen) |
 | **Codex CLI** | ✅ | ❌ | ❌ | ❌ |
+| **Crush** | ✅ | ✅ | ✅ | ❌ |
 
 ## Best Practices
 
@@ -499,10 +626,11 @@ graph TD
 ```
 
 **Recommended Combinations**:
-- **Beginner**: Continue + OpenCode SST + Codex CLI
-- **Intermediate**: Continue + Aider + Gemini CLI + Qwen Code
+- **Beginner**: Continue + OpenCode SST + Crush
+- **Intermediate**: Continue + Aider + Gemini CLI + Crush
 - **Advanced**: All tools based on specific needs
-- **Team Lead**: OpenCode SST + Claude Code + Aider + Qwen Code
+- **Team Lead**: OpenCode SST + Claude Code + Aider + Crush
+- **Multi-Model Focus**: Crush + Continue + OpenCode SST
 - **Performance Focus**: Qwen Code + Claude Code + Aider
 
 ### 2. Workflow Integration

frontend/index.html

@@ -573,6 +573,20 @@ <h3>OpenAI Codex CLI</h3>
                                 <code>codex</code>
                             </div>
                         </div>
+
+                        <div class="tool-card">
+                            <div class="tool-icon">
+                                <svg width="24" height="24" viewBox="0 0 16 16" fill="currentColor">
+                                    <path d="M8 1.5c-2.363 0-4 1.69-4 3.75 0 .984.424 1.625.984 2.304l.214.253c.223.264.47.556.673.848.284.411.537.896.621 1.49a.75.75 0 0 1-1.484.211c-.04-.282-.163-.547-.37-.847a8.456 8.456 0 0 0-.542-.68c-.084-.1-.173-.205-.268-.32C3.201 7.75 2.5 6.766 2.5 5.25 2.5 2.31 4.863 0 8 0s5.5 2.31 5.5 5.25c0 1.516-.701 2.5-1.328 3.259-.095.115-.184.22-.268.319-.207.245-.383.453-.541.681-.208.3-.33.565-.37.847a.75.75 0 0 1-1.485-.212c.084-.593.337-1.078.621-1.489.203-.292.45-.584.673-.848.075-.088.147-.173.213-.253.561-.679.985-1.32.985-2.304 0-2.06-1.637-3.75-4-3.75ZM5.75 12h4.5a.75.75 0 0 1 0 1.5h-4.5a.75.75 0 0 1 0-1.5ZM6 15.25a.75.75 0 0 1 .75-.75h2.5a.75.75 0 0 1 0 1.5h-2.5a.75.75 0 0 1-.75-.75Z"/>
+                                </svg>
+                            </div>
+                            <h3>Crush</h3>
+                            <p>Multi-model AI with session management and LSP integration</p>
+                            <div class="tool-commands">
+                                <code>setup_crush</code>
+                                <code>crush</code>
+                            </div>
+                        </div>
                     </div>
 
                     <div class="quick-setup">