GrokIDE

An optimized, AI-powered IDE based on VS Code with Cline extension, perfectly tuned for efficient programming on M1 MacBooks (arm64). Integrated with OpenRouter API for xAI's Grok Code Fast 1 model, providing lightning-fast code generation and autonomous coding features.

Features

• 🚀 Blazing Fast Code Generation: Powered by xAI's Grok Code Fast 1 model via OpenRouter API
• 🤖 Autonomous Coding: Cline extension enables agentic workflows including file editing, command execution, and task planning
• ⚡ M1 Optimized: Tailored performance tweaks for arm64 Macs with minimal latency
• 🎨 Developer-Friendly UI: Clean, efficient dark theme with performance-first configuration
• 📦 Easy Distribution: Scripts for building custom .dmg packages
• 🔧 Plugin Architecture: Extend with MCP servers for additional tools and resources
• 🔒 Secure API Integration: Placeholder configuration for OpenRouter API keys

Requirements

• macOS (arm64/M1/M2/M3)
• Internet connection for downloads and API
• OpenRouter API key (obtain from openrouter.ai)

Installation

Automated Setup

1. Clone this repository:

   git clone https://github.com/yourusername/GrokIDE.git
   cd GrokIDE

2. Run the setup script:

   chmod +x setup.sh
   ./setup.sh --openrouter-key YOUR_API_KEY

   The script will:

   • Download and install arm64 VS Code
   • Install Cline extension
   • Configure OpenRouter API
   • Apply performance optimizations
   • Set Grok Code Fast 1 as default model

Manual Installation

If the automated script fails, follow these steps:

1. Download VS Code arm64 from code.visualstudio.com
2. Download Cline .vsix from GitHub releases
3. Install with: code --install-extension cline.vsix
4. Copy settings.json to ~/.config/Code/User/
5. Configure OpenRouter API key in settings

Build Distribution Package

To create a packaged .dmg for distribution:

1. Ensure VS Code is installed (via setup.sh)
2. Run build script:

   chmod +x build_dmg.sh
   ./build_dmg.sh

3. The DMG will be created in build/ directory

Configuration

API Key Management

Your OpenRouter API key is stored in ~/.config/Code/User/.openrouter.env. Keep this file secure.

Advanced Settings

Modify settings.json to customize:

• Model temperature and max tokens
• UI theme and layout
• Performance optimizations

Usage

1. Launch VS Code: code
2. Cline features available in command palette (Cmd+Shift+P)
3. Use Plan Mode for complex coding tasks
4. Leverage MCP for additional tools

GitHub Upload Steps

1. Create new repository on GitHub
2. Initialize git in local directory:

   git init
   git add .
   git commit -m "Initial commit: GrokIDE setup"

3. Add remote origin:

   git remote add origin https://github.com/yourusername/GrokIDE.git

4. Push to main branch:

   git branch -M main
   git push -u origin main

5. Create release for DMG distribution:
   • Go to Releases tab
   • Click "Create a new release"
   • Upload build/GrokIDE-1.0.0.dmg
   • Tag with version number

Contributing

This is an open-source project. Feel free to:

• Report issues
• Submit pull requests
• Suggest optimizations

License

MIT License - see LICENSE file for details

Credits

• Based on VS Code by Microsoft
• Powered by Cline and OpenRouter
• Optimized for xAI's Grok models