daniel-farina/grok-remote

grok-remote lets a person run grok coding agents on one always-on computer and drive them from any other device on the same private network. The agents themselves come from xAI's grok command line tool. This project adds a web dashboard around them so the user can talk to several agents in parallel from a laptop or phone instead of being tied to a terminal on the host machine. The author notes that the project is not affiliated with xAI, grok, or Tailscale. The networking trick is Tailscale, a service that builds a small private network between a person's own devices. The dashboard runs on the host computer and is reachable across that private network without exposing anything to the public internet. PM2, a Node.js process manager, keeps the dashboard server alive across restarts. A single installer script checks for Node 20, PM2, and Tailscale, builds the dashboard, and registers a short command called gr on the user's PATH for opening or controlling the app. Each conversation spawns its own grok agent process with a working directory under ~/.grok-remote/agents. The dashboard talks to that process using the Agent Client Protocol, which is the message format grok expects, so it can act as a full host: the agent can run shell commands, read and write files, and request permission, all visible in the browser as live cards. Tool calls show status pills moving from pending to running to completed or failed, alongside the assistant's streamed text and a token usage footer. Conversations are stored on disk and survive restarts. Users can drag or paste image attachments, browse the agent's workspace through a Files tab with previews for text, HTML, images, audio, and video, and run slash commands that grok exposes. Conversations can be starred, archived, restored, or deleted forever. The interface installs as a mobile progressive web app and ships with dark, light, hacker, and unicorn themes.