Grok-Desktop v1.2.5
Description
Grok-Desktop is an Electron-based desktop application for Windows 10/11 and Linux that wraps grok.com, providing desktop-application-like access to Grok with real-time API usage monitoring, multi-tab support, and seamless authentication for xAI, Google, and Apple accounts.
Screenshot
Features
- Desktop application wrapper for grok.com
- Tabs functionality for multiple Grok conversations
- Real-time Usage Monitoring - Track your Grok usage limits:
- Low Effort: Basic query limits and remaining tokens
- High Effort: Advanced feature usage tracking
- Grok 4 Heavy: Specialized model usage limits
- Refill Timer: Shows when limits reset
- Keyboard shortcuts:
Ctrl+T: Open a new tabCtrl+Tab / Ctrl+Shift+Tab: Cycle through open tabs (next/previous)Mouse-wheel-scroll: Scroll open tabs when they are overflowing on the tab barCtrl+Mouse-wheel-scroll: Cycle through open tabs (next/previous)Ctrl+R: Reload the active tabCtrl+I: Show information/about dialog
- Authentication support for xAI, Google, and Apple accounts
- Clean interface with no menu bar for distraction-free usage
- Always-on-top function with cross-platform support (Windows & Linux)
- Dark/Light mode support with system theme detection
- Grok speech mode support
- Enhanced security with domain validation and OAuth protection
Download
Windows
Linux
System Requirements
For Using the Application
- Operating System: Windows 10/11 or Linux (Rocky Linux 9/10, RHEL 9, Ubuntu, Fedora, etc.)
- Internet connection for accessing grok.com
- Grok account (sign up in-app or use Google/Apple/xAI authentication)
- Linux AOT (Always-on-Top) requirement: Install
wmctrl for Always-on-Top functionality:
- Rocky Linux/RHEL/Fedora:
sudo dnf install wmctrl
- Ubuntu/Debian:
sudo apt install wmctrl
For Building from Source
- Operating System: Windows 10/11 or Linux
- Node.js: LTS version (20.x recommended)
- Internet connection for downloading dependencies
Project Structure
Grok-Desktop/
├── src/ # Main Electron application code
│ ├── main.js # Main Electron process
│ ├── preload.js # Preload script for renderer security
│ ├── renderer.js # Renderer process code
│ ├── custom-tabs.js # Custom tabs implementation
│ ├── grok.ico # Windows application icon
│ └── grok.png # Linux application icon
├── assets/ # Static assets
│ ├── icon.png
│ └── icon.svg
├── build-resources/ # Build configuration and resources
│ ├── icons/ # Application icons for different sizes
│ ├── after-install.sh # Post-installation script
│ ├── after-remove.sh # Post-removal script
│ └── com.grok.desktop.metainfo.xml # App metadata for Linux
├── index.html # Main application HTML
├── styles.css # Application styles
├── about.html # About dialog HTML
├── package.json # Node.js dependencies and build config
├── build.bat # Windows build script
├── build-linux.sh # Linux build script
├── CHANGELOG.md # Version history and changes
├── LINUX_BUILD_GUIDE.md # Detailed Linux build instructions
├── new_features.md # Security features documentation
└── README.md # This file
<<<<<<< HEAD
Build Grok-Desktop
- Install Node.js from nodejs.org.
- Clone this repository or download the files.
- Install dependencies if needed:
npm install
- Build using npm scripts:
- Directory build (unpacked):
npm run build-dir
- Portable executable:
npm run build-portable
- Full installers (NSIS + MSI):
npm run build-installer
Notes:
- These scripts use
npx electron-builder@latest (no global install required).
- All build outputs are written to the
build directory.
Usage
- After building, install
Grok-Desktop with Grok-Desktop_Installer-v1.2.3.exe from the build directory
- Launch
Grok-Desktop from the Start Menu
- Log in via
grok.com, using Google, Apple, or xAI authentication as needed.
- Use the + button in the top toolbar (or Ctrl+T) to add new tabs.
- Click the AOT button in the top right to toggle always-on-top functionality.
- Use keyboard shortcuts to work faster:
- Ctrl+T: Open a new tab
- Ctrl+Tab / Ctrl+Shift+Tab: Cycle through open tabs (next/previous)
- Ctrl+R: Reload the currently active tab
- Ctrl+I: Show information/about dialog
Keyboard Shortcuts
- Ctrl+T: Open a new tab
- Ctrl+Tab: Switch to the next tab
- Ctrl+Shift+Tab: Switch to the previous tab
- Ctrl+R: Reload the active tab (does not reload the entire app window)
- Ctrl+I: Show information/about dialog
=======
Building from Source
Prerequisites
- Install Node.js LTS (20.x recommended) from nodejs.org
- Clone this repository:
git clone https://github.com/AnRkey/Grok-Desktop.git
- Navigate to the project:
cd Grok-Desktop
- Install dependencies:
npm install
Build Commands
development
Windows
# Full installer (NSIS + MSI)
npm run build-installer
# Portable executable
npm run build-portable
# Directory build (unpacked)
npm run build-dir
Linux
# RPM + AppImage packages
npm run build-linux
# RPM only for RHEL/Rocky Linux
npm run build-rhel
# All platforms (Windows + Linux)
npm run build-all
Notes:
- All scripts use
npx electron-builder@latest (no global installation required)
- Build outputs are written to the
build/ directory
- For detailed Linux build instructions, see LINUX_BUILD_GUIDE.md
Installation
Windows
- Download and run
Grok-Desktop_Installer-v1.2.5.exe from the releases page
- Follow the installation wizard
- Launch “Grok Desktop” from the Start Menu
Linux
RPM Package (Recommended for RHEL/Rocky Linux)
cd build
sudo dnf install ./Grok-Desktop-v1.2.5.x86_64.rpm
Usage Guide
Getting Started
- Launch Grok-Desktop from your applications menu or desktop shortcut
- Sign in to grok.com using your xAI, Google, or Apple account
- The application opens with your first Grok tab
Interface Overview
- Tab Bar: Create and switch between multiple Grok conversations
- Navigation Controls: Back/forward buttons, reload, and URL bar
- Toolbar Buttons:
- +: Create new tab
- ↻: Reload current tab
- AOT: Toggle always-on-top mode
- s: Toggle API usage statistics display
- 👁: Toggle Grok-4-Heavy stats visibility (eye icon)
- i: Show about dialog
API Usage Monitoring
Grok-Desktop includes real-time monitoring of your Grok API usage limits:
Usage Statistics Display
When enabled (click the s button), a status bar appears at the bottom showing:
- Low Effort:
remaining / total - Basic query limits
- High Effort:
remaining / total - Advanced feature usage
- Grok 4 Heavy:
remaining / total - Specialized model limits
- Refill: Time until limits reset (when applicable)
Visual Indicators
- Green: Normal usage levels
- Orange: Warning (≤25% remaining)
- Red: Critical (≤10% remaining)
Features
- Auto-refresh: Updates every 5 seconds when active
- Persistent settings: Remembers your display preferences
- Toggle controls: Hide/show specific statistics as needed
- Login detection: Shows “Login required” when not authenticated
Thanks to Joshua Wang for his code.
Keyboard Shortcuts
| Shortcut |
Action |
Ctrl+T |
Open a new tab |
Ctrl+Tab |
Switch to next tab |
Ctrl+Shift+Tab |
Switch to previous tab |
Ctrl+R |
Reload active tab |
Ctrl+I |
Show information/about dialog |
Always-on-Top Feature
- Click the AOT button to toggle always-on-top mode
- The button turns green when active
- On Linux, requires
wmctrl package (automatically handled)
Support & Troubleshooting
Getting Help
Need help? Found a bug? Have a feature request?
When Reporting Issues
Please include:
- Operating System & Version: e.g., “Rocky Linux 10 with GNOME 49”
- Application Version: Found in Help → About dialog
- Steps to Reproduce: Detailed step-by-step instructions
- Expected vs Actual Behavior: What should happen vs what actually happens
- Screenshots: If applicable, especially for UI issues
- Error Messages: Copy any error messages from console/terminal
- System Details: GPU, display server (X11/Wayland), etc.
Check existing issues first to avoid duplicates.
Common Issues & Solutions
Always-on-Top Not Working on Linux
Symptoms: AOT button doesn’t work on Rocky Linux/GNOME
Solution: Ensure wmctrl is installed:
# Rocky Linux/RHEL/Fedora
sudo dnf install wmctrl
# Ubuntu/Debian
sudo apt install wmctrl
Usage Statistics Not Showing
Symptoms: Clicking ‘s’ button doesn’t show usage data
Solution:
- Ensure you’re logged into Grok.com in the application
- The feature requires an active Grok session to fetch API limits
- If you see “Login required”, sign in through the Grok tab
- Statistics should appear automatically once authenticated
Application Won’t Start
Symptoms: App fails to launch
Solutions:
Build Fails on Linux
Symptoms: npm run build-linux fails
Solutions:
- Install build dependencies:
sudo dnf groupinstall "Development Tools"
- For RPM builds on Rocky Linux 10:
sudo dnf install libxcrypt-compat
- See LINUX_BUILD_GUIDE.md for detailed instructions
Providing Feedback
Your feedback helps improve Grok-Desktop! Here’s how to contribute:
All feedback is reviewed and considered for future updates. Thank you for helping make Grok-Desktop better!
Technical Details
Architecture
Grok-Desktop is built with:
- Electron: Cross-platform desktop app framework
- Node.js: Backend runtime
- Web technologies: HTML, CSS, JavaScript for the UI
- Custom tabs: Multi-tab interface using Electron’s webview
Security Features
- Domain validation: Prevents malicious subdomain attacks
- OAuth protection: Secure handling of Google/Apple/xAI authentication
- External URL validation: Blocks localhost/private IPs and validates protocols
- CSP headers: Content Security Policy for additional protection
- Sandboxing: Electron’s security features enabled by default
API Usage Monitoring System
Real-time tracking of Grok API usage limits via authenticated API calls:
Data Sources
- Rate Limits API: Fetches current usage data from
grok.com/rest/rate-limits
- Model-Specific Tracking: Monitors both standard models and Grok-4-Heavy
- Token-Based Calculations: Displays remaining queries against total allowances
Technical Implementation
- Session-Based Authentication: Uses persistent Grok session cookies for API access
- Parallel Fetching: Concurrently retrieves multiple model limits for performance
- Error Handling: Graceful fallbacks when API is unavailable or authentication fails
- Local Storage: Remembers user preferences for display settings
- Auto-Refresh: Background updates every 5 seconds when monitoring is active
Always-on-Top (AOT) Implementation
Cross-platform always-on-top functionality with automatic compatibility handling:
Windows Implementation
- Uses Electron’s built-in
BrowserWindow.setAlwaysOnTop() method
- Native Windows API integration
Linux Implementation
- Primary: Uses
wmctrl command-line tool for reliable window management
- Fallback: Electron’s
setAlwaysOnTop() method when wmctrl unavailable
- Wayland Compatibility: Automatically detects Wayland and restarts with X11 forced
- GNOME Support: Works with GNOME Shell and Mutter window manager
Linux Dependencies
# Required for AOT functionality
sudo dnf install wmctrl # Rocky Linux/RHEL/Fedora
sudo apt install wmctrl # Ubuntu/Debian
Recent Changes (v1.2.5)
- Bug Fix: Fixed Usage Stats “Login required” error on Windows 11 (Issue #11)
- API calls now execute in webview context with proper authentication
- Thanks to Joshua Wang for identifying the root cause
- Previous (v1.2.4): API Usage Monitoring, enhanced security, improved Linux AOT support
For complete changelog, see CHANGELOG.md.
Changelog Summary
v1.2.5 (Latest)
- 🐛 Bug Fix: Fixed Usage Stats “Login required” error on Windows 11
- Resolved 403 API errors by executing fetch in authenticated webview context
- Thanks to Joshua Wang (@JoshuaWang2211) for the bug report and solution
Recent Versions
- v1.2.4: API Usage Monitoring, enhanced security, improved Linux AOT
- v1.2.3: Reload button, MSI installer, build improvements
- v1.2.2: Electron security update (CVE-2025-55305)
- v1.2.1: Better dark mode, voice mode support
- v1.2.0: WebRTC/audio support, CSP enhancements
See CHANGELOG.md for complete version history.
Contributing
We welcome contributions! Please see CONTRIBUTING.md for:
- Development setup instructions
- Coding standards and guidelines
- Pull request process
- Testing requirements
Quick Start for Contributors
git clone https://github.com/AnRkey/Grok-Desktop.git
cd Grok-Desktop
npm install
npm start # Run in development mode
License
This project is licensed under the GNU General Public License version 2.0 (GPL-2.0). See the LICENSE file for details.
Acknowledgments
Third-Party Components
- Electron: Cross-platform desktop app framework
- electron-tabs: Multi-tab interface library
- wmctrl: Linux window management (AOT functionality)
Assets & Artwork
The grok.ico application icon was sourced online and converted for use in this project. If you are from xAI or Grok.com and have concerns about the use of this artwork, please contact us and we’ll address it promptly.
Grok-Desktop v1.2.5 - Making Grok accessible everywhere! 🚀
评论