whatisgithub

What is grok-build-mobile-persistent?

neuron-spark-ai/grok-build-mobile-persistent — explained in plain English

Analysis updated 2026-05-18

1HTMLAudience · developerComplexity · 4/5LicenseSetup · hard

In one sentence

Grok Build Mobile Persistent is a self-hosted mobile web terminal that keeps a Grok CLI session running on your server through disconnects.

Mindmap

mindmap
  root((Grok Mobile))
    What it does
      Persistent tmux session
      Mobile web terminal
      Password login
    Tech stack
      Python
      tmux
      ttyd
    Use cases
      Resume from phone
      Long-running agent tasks
      PWA home screen app
    Audience
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Keep a Grok CLI coding session running on a server even when your phone disconnects

USE CASE 2

Reopen a long-running AI agent task from a phone browser exactly where it left off

USE CASE 3

Run Grok as a mobile-friendly progressive web app added to your phone's home screen

What is it built with?

PythontmuxttydFastAPI

How does it compare?

neuron-spark-ai/grok-build-mobile-persistentabhas9/escape-runabhishek-kumar09/mern-live-js-june-2021
Stars111
LanguageHTMLHTMLHTML
Last pushed2021-09-13
MaintenanceDormant
Setup difficultyhardeasymoderate
Complexity4/52/52/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Needs a self-hosted server with tmux, ttyd, HTTPS, and your own Grok CLI login.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice, under the MIT license.

So what is it?

Grok Build Mobile Persistent is a self hosted web app that lets someone run the Grok command line AI assistant from their phone's browser, while keeping the session alive on the server even if the phone loses its network connection or the browser tab is closed. It is designed to feel like a small app you add to your phone's home screen rather than a website you visit each time. The core idea is that the actual Grok process keeps running inside a terminal multiplexer called tmux on a server the user controls, whether that is a rented server, a home computer, or a machine reached through a tunneling service. A password protected login screen and a small authentication service sit in front of a web based terminal program, so that reopening the page on the phone reattaches to the same ongoing session instead of starting a new one, and any long running task the AI agent was working on continues even while nobody is actively looking at it. Setting it up involves installing the authentication service, a Python program, along with the terminal server and tmux, and pointing them behind a reverse proxy or tunnel so the whole thing is reachable over HTTPS from a phone. The project includes a guided installer script that can create the configuration file and set things up automatically, or the pieces can be installed manually one at a time. The README also includes a ready made prompt someone could paste into an AI coding agent to have it perform the whole server side setup automatically. The project explicitly states that it is not affiliated with xAI, the maker of Grok, and that it does not provide any Grok API keys or subscription of its own. It is meant purely as an access layer that lets someone use their own existing Grok CLI login from a mobile browser. Because it exposes a real shell on the host machine, the documentation stresses using HTTPS, strong passwords, and not sharing one deployment with people you do not trust.

Copy-paste prompts

Prompt 1
Help me deploy Grok Build Mobile Persistent on my VPS with a Cloudflare Tunnel
Prompt 2
Explain how tmux keeps my Grok CLI session alive when my phone loses connection
Prompt 3
Walk me through setting the .env file and starting the auth API and ttyd services

Frequently asked questions

What is grok-build-mobile-persistent?

Grok Build Mobile Persistent is a self-hosted mobile web terminal that keeps a Grok CLI session running on your server through disconnects.

What language is grok-build-mobile-persistent written in?

Mainly HTML. The stack also includes Python, tmux, ttyd.

What license does grok-build-mobile-persistent use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice, under the MIT license.

How hard is grok-build-mobile-persistent to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is grok-build-mobile-persistent for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.