Grok-cli is a command-line coding agent that connects to xAI's Grok API.
The tool addresses the need for an AI-powered assistant that can write and modify code while having access to real-time information. It integrates with Grok's model lineup and enables the agent to search X and the web, execute sub-agents by default, and perform desktop automation on macOS through a built-in computer sub-agent. The agent can be controlled remotely via Telegram, allowing users to drive it from their phone while the CLI runs in the background. It offers both interactive and headless modes, with a terminal UI built using Bun and OpenTUI for the interactive experience.
Developers should choose this tool if they want an open-source alternative for AI-assisted coding that leverages Grok's real-time search capabilities and desktop automation. It suits projects where you need a coding agent with web awareness and the ability to interact with your desktop. The interactive mode works best with modern terminal emulators including WezTerm, Alacritty, Ghostty, and Kitty. For automation, CI pipelines, and scheduled tasks, the headless mode and batch API support provide cost-effective options. The tool outputs structured JSON events in headless mode for integration into larger workflows, and supports session continuation across runs.
The project maintains active development with regular updates to its core agent functionality and terminal UI. The maintainers have documented specific terminal compatibility and actively support macOS desktop automation through the computer sub-agent. The tool includes scheduling capabilities for both one-time and recurring automated runs managed by a background daemon. Development focuses on practical features like session persistence, structured output formats, and remote control integration rather than experimental capabilities.
