API vs subscription

The Grok group in the model picker is two transports of the same Grok 4.6 weights. They are not a local model and they are not interchangeable at send time.

Grok 4.6 is the unlabeled API row. It behaves like every other picker model: Codelab credits, and a top-up prompt when they run out. No Mac process required.

Grok 4.6 Subscription is SuperGrok. Codelab’s servers cannot hold grok login. The browser sends the stream to a proxy you start on the Mac that has that login. Chat history still loads from your Codelab account. There is no API fallback — missing login fails the send.

This is not Connect MCP. MCP is Grok Build (or Claude, Cursor, Codex) calling Codelab tools. Subscription is Grok as the model inside agent chat.

What subscription does

1. You pick Grok 4.6 Subscription.
2. The next send goes to the proxy on this Mac, not to Codelab’s API.
3. The proxy uses your grok login session and talks to Grok.
4. Tools still run in the browser against the app tree — same canvas as every other model.
5. Account → Grok subscription checks whether the proxy is up and whether Grok is logged in.

On http:// localhost the proxy is http://127.0.0.1:3004. On the HTTPS builder an http:// loopback is mixed content, so the origin must be the Tailscale Serve URL the Account panel shows.

Connect SuperGrok

You need a SuperGrok (or equivalent) Grok account, the Grok CLI on this Mac, Tailscale on the same tailnet as the HTTPS builder, and the Codelab harness. You do not need to clone Codelab.

1. Install the Grok CLI and run grok login on the Mac that will proxy.

2. Start Tailscale. Stay on this tailnet so app.codelab.app can reach the MagicDNS name.

3. On that Mac (@codelab-app/harness on npm):

   npx -y @codelab-app/harness

   That serves the proxy on http://127.0.0.1:3004 and runs tailscale serve --bg so the HTTPS builder can reach it.

4. In the builder, open Account → Grok subscription (or the empty AI rail with Subscription selected). Copy the Proxy URL if you need to confirm it. The panel should read Connected once health succeeds and Grok is logged in.

5. In the model picker, choose Grok 4.6 Subscription. Send.

The in-app rows to copy are the same commands: npx -y @codelab-app/harness, the proxy URL, and grok login.

If it is not connected

A send with Subscription selected and no CLI session throws: the proxy has no grok login. It does not silently switch to Grok 4.6.