First Run

This page describes what a real first launch looks like on a clean machine.

Start Grok Code

grok

On a clean machine, expect:

• no saved sessions yet
• xAI not connected
• default model grok-code-fast-1
• local tools as the execution mode

Finish Setup

In the TUI:

/connect

Or in the CLI:

grok login
grok whoami

A Good First Tour

Use these in order:

• /deck to see the lane chooser
• /control to inspect readiness
• /research to test evidence flow
• /work to return to the main lane

A Good First CLI Tour

• grok whoami
• grok run "summarize this repository"
• grok init inside a project you want Grok Code to understand better

If The First Run Feels Broken

Start with:

• xAI Auth And Setup
• Troubleshooting Auth
• Troubleshooting Empty States