Tips: Grok not found? Run grok login --device-auth then reopen Groking.
Re-running the installer upgrades in place and keeps your activation.
On a machine that already hosts the public license server, the installer auto-picks
~/Groking-app so it never overwrites that install.
If something fails — step by step
Follow the matching section. Do the steps in order.
Installer command fails / curl error / network
Confirm you are online. Retry the same command once.
macOS/Linux: use Terminal. Windows: use PowerShell (not Command Prompt).
If corporate VPN blocks downloads, disconnect VPN or try another network.
Manual fallback: download .tar.gz or .zip, extract to ~/Groking, then run start.sh / start.ps1.
Still stuck? Email support with your OS and the exact error line.
Re-run the Groking installer (it can install the free Grok CLI).
In Terminal: grok --version — if “not found”, fix PATH and reopen the app.
Sign in: in the app click Connect Grok, or run grok login --device-auth.
Confirm the on-screen code, then return to Groking — status should turn green.
Grok/xAI account is separate from your Groking license.
App opens but “out of turns” / cannot send tasks
Free plan includes a monthly turn allowance. Check the Credits chip in the app.
Buy a credit pack or upgrade at pricing for unlimited (Pro / Team / Lifetime).
Hard-refresh the workspace after purchase so entitlements reload.
Still blocked with a paid plan? Email support with the last 4 characters of your key.
Multi-session: you can run several projects at once — each has its own
process and timeline. Prefer one active writer per folder. When calling Cloudflare-fronted
APIs from Python, set a User-Agent (bare urllib gets CF error 1010).