Skip to content

Start with Grok

wisp runs Grok Build, the grok command, in the background, one worktree per task, on your own xAI account.

What you need

The grok command on your PATH. Install it from x.ai/cli.

Sign in

Open Settings (the person button in the top bar, or ⌘K → Settings) → Agents → Sign in next to Grok. Open the sign-in page and enter the code wisp shows. Or press Keys and paste an xAI key.

In the browser (wisp --browser, or your cloud wisp) it’s the same window, menus and keys.

Settings → Agents: each harness with its accounts and sign-in state, and an Add key buttonSettings → Agents: each harness with its accounts and sign-in state, and an Add key button

Pick it, its model and its effort

wisp reads grok models and the levels each model takes. Effort: low, medium, high, xhigh.

Click the harness chip in the New task footer (N), pick Grok, then a model and a thinking level. On a running task, the same chip in the reply box changes it for the next follow-up.

Modes: Plan, Edits, Full auto (--mode plan|edits|auto). A run without a terminal refuses what needs approval. wisp shows each refusal on the task as blocked.

What wisp adds for Grok

  • wisp’s tools (asking you a question, and the rest) reach Grok through an agent definition wisp writes for the run.
  • Your prompt and wisp’s rules go in as files, not on the command line.

Open in Grok

Open the task’s ⋯ at its top right → Open in › Open in Grok (key T). Grok opens in a terminal in the side panel.