Merge pull request #23 from FineComputer14451/docs/build-mode-vs-grok-build

docs: Chat Build Mode ≠ Grok Build CLI

Author: FineComputer14451

docs/FAQ.md

@@ -141,7 +141,12 @@ bash ~/GrokHunter/scripts/install_grok_statusline.sh
 
 ## How should I split Grok chat vs Grok Build?
 
-See [GROK-46-WORKFLOW.md](GROK-46-WORKFLOW.md) — chat for think, Build for code, Bot for glue; catalog default **`grok-4.6`**.
+See [GROK-46-WORKFLOW.md](GROK-46-WORKFLOW.md) — chat for think, Chat **Build Mode** for shareable prototypes, terminal **Grok Build** for repo/lab code, Bot for glue; catalog default **`grok-4.6`**.
+
+
+## Is Chat "Build" the same as Grok Build on Termux?
+
+**No.** Chat picker **Build** opens **Build Mode** (in-chat sites/apps/games → `*.grok.me`). Terminal **Grok Build** (`grok` / `grokhunter`) edits your lab repo. Details: [GROK-46-WORKFLOW.md](GROK-46-WORKFLOW.md#chat-build-mode-vs-grok-build-cli) · [xAI Build Mode](https://x.ai/news/grok-build-mode).
 
 ## How do I check the models profile / API key?
 

docs/GROK-46-WORKFLOW.md

@@ -7,14 +7,32 @@ See also: [GROK-46.md](GROK-46.md) · [GROK-BUILD-1.0.md](GROK-BUILD-1.0.md) ·
 
 ## Surfaces
 
-| Surface | Best for | Model to pin |
-|---------|----------|--------------|
-| **Grok chat** (web/app) | Research, writing, quick Q&A, non-repo thinking | Grok 4.6 (chat UI selector) |
+| Surface | Best for | Model / mode to pin |
+|---------|----------|---------------------|
+| **Grok chat** (web/app) | Research, writing, quick Q&A, non-repo thinking | Chat modes: Auto / Fast / **Expert** / Heavy (4.6-generation Chat) |
+| **Chat → Build** (Build Mode) | Shareable sites, apps, games, dashboards in chat → `*.grok.me` | Picker tile **Build** — *not* the terminal CLI ([xAI](https://x.ai/news/grok-build-mode)) |
 | **Grok Bot** | Orchestration, connectors, PRs, multi-agent seating | Account default (Bot); not your main phone file editor |
 | **Grok Build** (`grok`) | Repo work, multi-file edits, long agent loops | Catalog default **`grok-4.6`** |
 | **Coding Team** (Benjamin → Lucas → Harper) | Design → ship → harden | Same `grok-4.6` via `~/.grok/agents/` |
 | **Aider** (`aider-grok`) | Focused diffs when the Build TUI is heavy | `AIDER_MODEL=grok-4.6` |
 
+
+## Chat Build Mode vs Grok Build CLI
+
+Same word, **two products**:
+
+| | **Build Mode** (Chat picker → **Build**) | **Grok Build** (`grok` / `grokhunter`) |
+|--|------------------------------------------|----------------------------------------|
+| Where | grok.com / iOS / Android Chat | Termux or desktop terminal |
+| Does | Describe → live preview in chat → publish `*.grok.me` (or custom domain) | Reads/edits your repo, shell, agents, skills |
+| Best for | Prototypes you want to share as a link | GrokHunter lab, multi-file code, Coding Team |
+| Code | Optional — you need not touch it | Primary surface — works in your files |
+| Tier note | Early Beta; announced for SuperGrok Heavy ([news](https://x.ai/news/grok-build-mode)) | Lab install + SuperGrok login or `XAI_API_KEY` |
+
+**Rule:** repo / lab work → terminal **Grok Build**. Shareable app-in-chat → Chat **Build Mode**. Do not treat the Chat **Build** tile as “open my phone rootfs.”
+
+Chat mode map (Auto/Fast/Expert/Heavy/Build): skill `grok-chat-model-map` / Studio plan PR [#48](https://github.com/FineComputer14451/Grok-Imagine-Cinematic-Studio/pull/48).
+
 ## Grok Build model
 
 Use the catalog default **`grok-4.6`** (no V9 `/model` pickers). Former aliases
@@ -25,11 +43,12 @@ Use the catalog default **`grok-4.6`** (no V9 `/model` pickers). Former aliases
 
 ## Day-to-day routing
 
-1. **Decide / research** → Grok chat 4.6 (or Bot for “what should we do?”).
-2. **Plan a change** → `grok` (default `grok-4.6`), or `grokhunter plan "…"`.
-3. **Implement** → default `grok-4.6` (or Coding Team Lucas); keep turns small.
-4. **Harden / review** → Harper, or another `grok` turn on the diff.
-5. **Bot** → install, tunnels, GitHub, connectors — glue, not primary editor on phone.
+1. **Decide / research** → Grok chat **Auto** or **Expert** (4.6-generation Chat), or Bot for “what should we do?”.
+2. **Shareable prototype (no local repo)** → Chat picker **Build** (Build Mode → preview / `grok.me`).
+3. **Plan a repo change** → terminal `grok` (default `grok-4.6`), or `grokhunter plan "…"`.
+4. **Implement in the lab** → default `grok-4.6` (or Coding Team Lucas); keep turns small — *not* Chat Build Mode.
+5. **Harden / review** → Harper, or another `grok` turn on the diff.
+6. **Bot** → install, tunnels, GitHub, connectors — glue, not primary editor on phone.
 
 ## Lab checklist (Termux / desktop)
 
@@ -45,7 +64,7 @@ Confirm the default coding model remains **`grok-4.6`**.
 ## Success criteria
 
 - `grokhunter status` shows `models=yes` and profile on 4.6.
-- You know: chat for think, Build for code, Bot for glue.
+- You know: chat for think, Chat **Build Mode** for shareable prototypes, terminal **Grok Build** for repo/lab code, Bot for glue.
 - Imagine models never selected for coding.
 
 ## Related

website/index.html

@@ -34,7 +34,7 @@
       href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;600&family=IBM+Plex+Sans:wght@400;500;600;700&display=swap"
       rel="stylesheet"
     />
-    <link rel="stylesheet" href="styles.css?v=20260907-full" />
+    <link rel="stylesheet" href="styles.css?v=20260907-buildmode" />
   </head>
   <body>
     <header class="header">
@@ -527,9 +527,10 @@ <h3>Grok Build Connect</h3>
               <h3>Chat ↔ Build workflow</h3>
               <p>
                 <a href="https://github.com/FineComputer14451/GrokHunter/blob/main/docs/GROK-46-WORKFLOW.md" target="_blank" rel="noopener noreferrer">docs/GROK-46-WORKFLOW.md</a>
-                — how Grok 4.6 chat pairs with on-device Grok Build, plus the
-                <a href="https://github.com/FineComputer14451/Grok-Imagine-Cinematic-Studio/blob/main/docs/guides/IMAGINE_MODELS_MAP.md" target="_blank" rel="noopener noreferrer">Imagine models map</a>
-                (incl. Agent Mode).
+                — Grok 4.6 chat vs on-device Grok Build. Chat picker <strong>Build</strong> is
+                <strong>Build Mode</strong> (shareable <code>grok.me</code> apps), not the Termux CLI.
+                Imagine map:
+                <a href="https://github.com/FineComputer14451/Grok-Imagine-Cinematic-Studio/blob/main/docs/guides/IMAGINE_MODELS_MAP.md" target="_blank" rel="noopener noreferrer">incl. Agent Mode</a>.
               </p>
             </article>
             <article class="card">
@@ -1205,6 +1206,19 @@ <h2>Common questions</h2>
                 Android Grok Bot currently has no custom-MCP settings screen.
               </p>
             </details>
+
+            <details class="faq-item">
+              <summary>Is Chat Build the same as Grok Build on Termux?</summary>
+              <p>
+                <strong>No.</strong> Chat picker <strong>Build</strong> is <strong>Build Mode</strong>
+                (in-chat sites/apps/games → <code>*.grok.me</code>). Terminal
+                <strong>Grok Build</strong> (<code>grok</code> / <code>grokhunter</code>) edits your lab repo.
+                See
+                <a href="https://github.com/FineComputer14451/GrokHunter/blob/main/docs/GROK-46-WORKFLOW.md" target="_blank" rel="noopener noreferrer">GROK-46-WORKFLOW.md</a>
+                and
+                <a href="https://x.ai/news/grok-build-mode" target="_blank" rel="noopener noreferrer">xAI Build Mode</a>.
+              </p>
+            </details>
             <details class="faq-item">
               <summary>What about V9 /model pickers?</summary>
               <p>
@@ -1451,6 +1465,6 @@ <h2>Ship code from your pocket</h2>
       </div>
     </footer>
 
-    <script src="app.js?v=20260907-full"></script>
+    <script src="app.js?v=20260907-buildmode"></script>
   </body>
 </html>