oysterun 1.6.0-beta.1 → 1.6.0-beta.2

package/host-service/callback-durable-store.mjs

@@ -438,7 +438,7 @@ export function openDurableCallbackStore(db, {
         }
         const candidates = db
           .prepare(
-            `SELECT * FROM matrix_events INDEXED BY idx_matrix_events_room_completed_turn_candidate
+            `SELECT * FROM matrix_events
              WHERE room_id = @room_id AND is_state = 0 AND type = 'm.room.message'
                AND semantic_type IN ('message.assistant', 'tool.result', 'tool.failure', 'thinking.reasoning')
                AND json_extract(content_json, '$."org.oysterun.semantic.v1".provider_turn_id') = @turn_id
@@ -449,7 +449,7 @@ export function openDurableCallbackStore(db, {
           .all({ room_id: record.target_matrix_room_id, turn_id: record.target_provider_turn_id });
         const completions = db
           .prepare(
-            `SELECT * FROM matrix_events INDEXED BY idx_matrix_events_room_completed_turn_completion
+            `SELECT * FROM matrix_events
              WHERE room_id = @room_id AND is_state = 0 AND type = 'm.room.message'
                AND json_extract(content_json, '$."org.oysterun.semantic.v1".provider_completion_turn_id') = @turn_id
                AND json_extract(content_json, '$."org.oysterun.semantic.v1".provider_completion_marker') = 'oysterun_provider_complete_message_notification_v1'

package/host-service/completed-turn-navigation.mjs

@@ -182,14 +182,14 @@ function selectorSql(direction) {
       SELECT
         json_extract(c.content_json, '$."org.oysterun.semantic.v1".provider_turn_id') AS provider_turn_id,
         MAX(c.stream_seq) AS final_seq
-      FROM matrix_events AS c INDEXED BY ${MATRIX_COMPLETED_TURN_CANDIDATE_INDEX}
+      FROM matrix_events AS c
       WHERE ${CANDIDATE_WHERE}
       GROUP BY provider_turn_id
     ), successful_turns AS (
       SELECT
         json_extract(m.content_json, '$."org.oysterun.semantic.v1".provider_completion_turn_id') AS provider_turn_id,
         MAX(m.stream_seq) AS completion_seq
-      FROM matrix_events AS m INDEXED BY ${MATRIX_COMPLETED_TURN_COMPLETION_INDEX}
+      FROM matrix_events AS m
       WHERE ${COMPLETION_WHERE}
       GROUP BY provider_turn_id
     )
@@ -268,14 +268,14 @@ function exactTargetSql() {
       SELECT
         json_extract(c.content_json, '$."org.oysterun.semantic.v1".provider_turn_id') AS provider_turn_id,
         MAX(c.stream_seq) AS final_seq
-      FROM matrix_events AS c INDEXED BY ${MATRIX_COMPLETED_TURN_CANDIDATE_INDEX}
+      FROM matrix_events AS c
       WHERE ${CANDIDATE_WHERE}
       GROUP BY provider_turn_id
     ), successful_turns AS (
       SELECT
         json_extract(m.content_json, '$."org.oysterun.semantic.v1".provider_completion_turn_id') AS provider_turn_id,
         MAX(m.stream_seq) AS completion_seq
-      FROM matrix_events AS m INDEXED BY ${MATRIX_COMPLETED_TURN_COMPLETION_INDEX}
+      FROM matrix_events AS m
       WHERE ${COMPLETION_WHERE}
       GROUP BY provider_turn_id
     )
@@ -425,6 +425,18 @@ export function readCompletedTurnFinalMessageNeighborsFromSQLite(
   });
   const noCompletedTurns = latestCompleted === null;
 
+  const navigationIndexesPresent = [
+    MATRIX_COMPLETED_TURN_CANDIDATE_INDEX,
+    MATRIX_COMPLETED_TURN_COMPLETION_INDEX,
+  ].every(
+    (name) =>
+      db
+        .prepare(
+          "SELECT 1 AS present FROM sqlite_master WHERE type = 'index' AND name = ?"
+        )
+        .get(name)?.present === 1
+  );
+
   return {
     status: "ok",
     session_id: hostSessionId,
@@ -449,16 +461,24 @@ export function readCompletedTurnFinalMessageNeighborsFromSQLite(
     },
     proof: {
       schema_version: NAVIGATION_SCHEMA_VERSION,
-      lookup_source: "routec_matrix_events_completed_turn_expression_indexes",
-      lookup_strategy: "indexed_completed_turn_final_message",
+      lookup_source: navigationIndexesPresent
+        ? "routec_matrix_events_completed_turn_expression_indexes"
+        : "routec_matrix_events_completed_turn_sql",
+      lookup_strategy: navigationIndexesPresent
+        ? "indexed_completed_turn_final_message"
+        : "unindexed_completed_turn_final_message",
       order_by: "final_candidate_stream_seq",
       candidate_predicate: "complete_message_notification_candidate",
       completion_predicate: "complete_message_notification_completion",
-      navigation_index_version: MATRIX_COMPLETED_TURN_NAVIGATION_INDEX_VERSION,
-      navigation_index_names: [
-        MATRIX_COMPLETED_TURN_CANDIDATE_INDEX,
-        MATRIX_COMPLETED_TURN_COMPLETION_INDEX,
-      ],
+      navigation_index_version: navigationIndexesPresent
+        ? MATRIX_COMPLETED_TURN_NAVIGATION_INDEX_VERSION
+        : null,
+      navigation_index_names: navigationIndexesPresent
+        ? [
+            MATRIX_COMPLETED_TURN_CANDIDATE_INDEX,
+            MATRIX_COMPLETED_TURN_COMPLETION_INDEX,
+          ]
+        : [],
       raw_event_scan_limit: null,
       raw_event_payload_returned: false,
       message_body_returned: false,

package/host-service/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oysterun-host-service",
-  "version": "1.6.0-beta.1",
+  "version": "1.6.0-beta.2",
   "type": "module",
   "description": "Oysterun host service — runs on Mac mini, manages Claude Code sessions",
   "scripts": {

package/host-service/routec-matrix-sqlite-store.mjs

@@ -751,14 +751,6 @@ export function ensureCallbackSchemaMigration(db) {
   };
 }
 
-function assertCompletedTurnNavigationIndexesReady(db) {
-  if (!completedTurnNavigationIndexesReady(db)) {
-    throw new Error(
-      "Route C Matrix SQLite completed-turn navigation index migration is required"
-    );
-  }
-}
-
 function latestStreamSeqForMaintenance(db) {
   const row = db
     .prepare(
@@ -937,8 +929,6 @@ function openDatabase(
     }
     if (migrateCompletedTurnNavigation) {
       ensureCompletedTurnNavigationIndexMigration(db);
-    } else {
-      assertCompletedTurnNavigationIndexesReady(db);
     }
     return db;
   } catch (err) {
@@ -1807,7 +1797,6 @@ function migrateJsonToSQLite({ jsonStoragePath, sqlitePath }) {
     importLegacyJsonSnapshotIntoSQLiteStreaming(db, jsonStoragePath);
     const deltaRecordCount = applyDeltaJsonlToSQLiteStreaming(db, deltaPath);
     ensureStreamSeqAuthorityMigration(db);
-    ensureCompletedTurnNavigationIndexMigration(db);
     const sourceAfter = fileSignature(jsonStoragePath);
     const deltaAfter = fileSignature(deltaPath);
     if (
@@ -1980,26 +1969,7 @@ function inspectStreamSeqAuthorityReadiness(sqlitePath) {
       };
     }
     const navigationIndexVersion = completedTurnNavigationIndexVersion(db);
-    if (!completedTurnNavigationIndexesReady(db)) {
-      return {
-        storage_ready: false,
-        migration_status: "completed_turn_navigation_index_migration_required",
-        unique_index_ready: true,
-        unique_index_name: MATRIX_STREAM_SEQ_UNIQUE_INDEX,
-        unique_index_version: MATRIX_STREAM_SEQ_INDEX_VERSION,
-        navigation_indexes_ready: false,
-        navigation_index_version: Number.isSafeInteger(navigationIndexVersion)
-          ? navigationIndexVersion
-          : null,
-        navigation_index_names: [
-          MATRIX_COMPLETED_TURN_CANDIDATE_INDEX,
-          MATRIX_COMPLETED_TURN_COMPLETION_INDEX,
-        ],
-        next_stream_seq: null,
-        startup_validation_status: "not_run",
-        startup_repair: readStartupRepairSummary(db),
-      };
-    }
+    const navigationIndexesReady = completedTurnNavigationIndexesReady(db);
     const latestStreamSeq = latestStreamSeqForMaintenance(db);
     const raw = db
       .prepare("SELECT value FROM matrix_schema_meta WHERE key = ?")
@@ -2025,8 +1995,10 @@ function inspectStreamSeqAuthorityReadiness(sqlitePath) {
       unique_index_ready: true,
       unique_index_name: MATRIX_STREAM_SEQ_UNIQUE_INDEX,
       unique_index_version: MATRIX_STREAM_SEQ_INDEX_VERSION,
-      navigation_indexes_ready: true,
-      navigation_index_version: MATRIX_COMPLETED_TURN_NAVIGATION_INDEX_VERSION,
+      navigation_indexes_ready: navigationIndexesReady,
+      navigation_index_version: Number.isSafeInteger(navigationIndexVersion)
+        ? navigationIndexVersion
+        : null,
       navigation_index_names: [
         MATRIX_COMPLETED_TURN_CANDIDATE_INDEX,
         MATRIX_COMPLETED_TURN_COMPLETION_INDEX,
@@ -2135,7 +2107,6 @@ export function openRouteCMatrixSQLiteStore({ jsonStoragePath }) {
   if (!existsSync(sqlitePath)) {
     const db = openDatabase(sqlitePath, {
       migrateStreamSeqAuthority: true,
-      migrateCompletedTurnNavigation: true,
     });
     const counts = storeCounts(db);
     writeProof(
@@ -2901,7 +2872,6 @@ export function getRouteCMatrixSQLiteStorageHealth({
     if (!readiness.storage_ready && migrateIfNeeded) {
       const migrationDb = openDatabase(sqlitePath, {
         migrateStreamSeqAuthority: true,
-        migrateCompletedTurnNavigation: true,
       });
       migrationDb.close();
     }
@@ -2924,9 +2894,11 @@ export function getRouteCMatrixSQLiteStorageHealth({
     legacy_json_preserved: existsSync(jsonStoragePath),
     legacy_delta_preserved: existsSync(`${jsonStoragePath}.delta.jsonl`),
     migration_status:
-      migrationProof?.status === "failed"
-        ? readiness.migration_status
-        : migrationProof?.status || readiness.migration_status,
+      readiness.navigation_indexes_ready !== true
+        ? "validated_existing_sqlite_navigation_indexes_optional_absent"
+        : migrationProof?.status === "failed"
+          ? readiness.migration_status
+          : migrationProof?.status || readiness.migration_status,
     migration_proof_path: proofPath,
     migration_proof_summary: migrationProof
       ? {

package/host-service/routec-matrix-storage-adapter.mjs

@@ -1427,7 +1427,7 @@ export function ensureRouteCMatrixStorageReadyBeforeHostListen() {
     jsonStoragePath: storagePath,
     migrateIfNeeded: true,
   });
-  if (health.storage_ready !== true || health.navigation_indexes_ready !== true) {
+  if (health.storage_ready !== true) {
     throw new Error(
       `Route C Matrix storage is not ready before Host listen: ${health.migration_status || "unknown"}`
     );
@@ -1436,7 +1436,7 @@ export function ensureRouteCMatrixStorageReadyBeforeHostListen() {
     status: "ready",
     storage_path: storagePath,
     sqlite_storage_path: health.sqlite_storage_path,
-    navigation_indexes_ready: true,
+    navigation_indexes_ready: health.navigation_indexes_ready === true,
     navigation_index_version: health.navigation_index_version,
     duration_ms: Date.now() - startedAtMs,
   };

package/host-service/server.mjs

@@ -3616,9 +3616,15 @@ routeCMatrixFacade = createRouteCMatrixFacade({
     }
   },
 });
-const callbackStore = openDurableCallbackStore(
-  openRouteCMatrixSQLiteStore({ jsonStoragePath: getRouteCMatrixStoragePath() })
-);
+// Matrix storage must be bootstrapped before the first consumer opens it. Keep
+// this ahead of callback, unread, notification, and request-serving setup so a
+// newly added module-level consumer cannot bypass storage readiness.
+const STARTUP_MATRIX_STORAGE_READINESS =
+  ensureRouteCMatrixStorageReadyBeforeHostListen();
+const STARTUP_MATRIX_STORAGE = openRouteCMatrixSQLiteStore({
+  jsonStoragePath: getRouteCMatrixStoragePath(),
+});
+const callbackStore = openDurableCallbackStore(STARTUP_MATRIX_STORAGE);
 callbackHostIntegration = createCallbackHostIntegration({
   store: callbackStore,
   getSession: (sessionId) => sessionManager.getSession(sessionId),
@@ -24962,18 +24968,18 @@ const STARTUP_NODE_NPM_LIFECYCLE_TOOLCHAIN = (() => {
   }
 })();
 
-const STARTUP_MATRIX_STORAGE_READINESS = (() => {
-  const readiness = ensureRouteCMatrixStorageReadyBeforeHostListen();
+const STARTUP_MATRIX_CONSUMER_READINESS = (() => {
   const unreadReadiness = ensureCompletedSessionUnreadSchema(
-    openRouteCMatrixSQLiteStore({
-      jsonStoragePath: getRouteCMatrixStoragePath(),
-    }),
+    STARTUP_MATRIX_STORAGE,
     { hostUserId: HOST_OWNER_READ_CURSOR_USER_ID }
   );
   console.log(
-    `[oysterun-host] Matrix SQLite readiness complete before listen (${readiness.duration_ms}ms; P214 ${unreadReadiness.duration_ms}ms)`
+    `[oysterun-host] Matrix SQLite readiness complete before consumers (${STARTUP_MATRIX_STORAGE_READINESS.duration_ms}ms; P214 ${unreadReadiness.duration_ms}ms)`
   );
-  return { ...readiness, completed_session_unread: unreadReadiness };
+  return {
+    ...STARTUP_MATRIX_STORAGE_READINESS,
+    completed_session_unread: unreadReadiness,
+  };
 })();
 
 server.listen(PORT, () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oysterun",
-  "version": "1.6.0-beta.1",
+  "version": "1.6.0-beta.2",
   "type": "module",
   "description": "Oysterun Host installer and local service",
   "bin": {

package/static/site/blog/generated_manifest.json

@@ -2,7 +2,7 @@
   "schema": "oysterun.static_blog_manifest.v3",
   "content_schema": "oysterun.static_content_bundle.v2",
   "shell_schema": "oysterun.static_site_shell.v3",
-  "shell_sha256": "ac1341c43809bdeee08014f7f04061bf1df876b5431106f9e3eb9aabb0b67809",
+  "shell_sha256": "1b499d9ab1382144b285cf0dc75c00da0d3e3095aed750a0110025be3f93caa3",
   "generated_slugs": [
     "voice-input-model-experiment"
   ],
@@ -32,7 +32,7 @@
         "type": "svg"
       },
       "content_sha256": "49a68eec9d4d83126308962f646d673dacd526b867b2d3818b834c06a893e1a9",
-      "shell_sha256": "ac1341c43809bdeee08014f7f04061bf1df876b5431106f9e3eb9aabb0b67809",
+      "shell_sha256": "1b499d9ab1382144b285cf0dc75c00da0d3e3095aed750a0110025be3f93caa3",
       "files": [
         {
           "path": "en/index.html",

package/static/site/docs/choose-and-recover-a-provider/en/index.html

@@ -4,7 +4,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>Choose and recover an Oysterun provider</title>
-    <meta name="description" content="Choose Claude or Codex in Session Setup, separate dashboard access from provider login, and follow one bounded recovery path when its command or login is unavailable." />
+    <meta name="description" content="Choose Codex, Claude, or Grok in Session Setup, separate dashboard access from provider login, and follow one bounded recovery path when its command or login is unavailable." />
     <meta name="robots" content="index,follow" />
     <link rel="icon" href="/assets/oysterun_logo_v5.PNG" type="image/png" />
     <link rel="stylesheet" href="/assets/site.css" />
@@ -70,7 +70,7 @@
             </details>
             <details class="docs-task-group" open id="docs-group-sessions-providers">
               <summary>Sessions and providers</summary>
-              <ul><li><a href="/docs/configure-session-files-and-settings/en/index.html" data-doc-search-text="choose a session folder and control which settings are saved choose a focused start folder, preserve your setup draft when canceling or confirming the folder picker, and decide whether session settings apply once or persist with the project. sessions and providers">Choose a Session folder and control which settings are saved</a></li><li><a href="/docs/choose-and-recover-a-provider/en/index.html" aria-current="page" data-doc-search-text="choose and recover an oysterun provider choose claude or codex in session setup, separate dashboard access from provider login, and follow one bounded recovery path when its command or login is unavailable. sessions and providers">Choose and recover an Oysterun provider</a></li><li><a href="/docs/understand-agent-activity/en/index.html" data-doc-search-text="how to tell whether an oysterun agent is working or idle send one safe message from the sessions page and distinguish available, occupied, working, terminal, and unknown states without duplicate work. sessions and providers">How to tell whether an Oysterun agent is working or idle</a></li></ul>
+              <ul><li><a href="/docs/configure-session-files-and-settings/en/index.html" data-doc-search-text="choose a session folder and control which settings are saved choose a focused start folder, preserve your setup draft when canceling or confirming the folder picker, and decide whether session settings apply once or persist with the project. sessions and providers">Choose a Session folder and control which settings are saved</a></li><li><a href="/docs/choose-and-recover-a-provider/en/index.html" aria-current="page" data-doc-search-text="choose and recover an oysterun provider choose codex, claude, or grok in session setup, separate dashboard access from provider login, and follow one bounded recovery path when its command or login is unavailable. sessions and providers">Choose and recover an Oysterun provider</a></li><li><a href="/docs/understand-agent-activity/en/index.html" data-doc-search-text="how to tell whether an oysterun agent is working or idle send one safe message from the sessions page and distinguish available, occupied, working, terminal, and unknown states without duplicate work. sessions and providers">How to tell whether an Oysterun agent is working or idle</a></li></ul>
             </details>
             <details class="docs-task-group" open id="docs-group-chat-messages-files">
               <summary>Chat, messages, and files</summary>
@@ -95,7 +95,7 @@
           <header class="article-title-block">
             <p class="eyebrow">Docs</p>
             <h1 id="article-title">Choose and recover an Oysterun provider</h1>
-            <p class="article-description">Choose Claude or Codex in Session Setup, separate dashboard access from provider login, and follow one bounded recovery path when its command or login is unavailable.</p>
+            <p class="article-description">Choose Codex, Claude, or Grok in Session Setup, separate dashboard access from provider login, and follow one bounded recovery path when its command or login is unavailable.</p>
             <p class="article-date"><time datetime="2026-08-27">2026-08-27</time></p>
           </header>
 
@@ -109,9 +109,10 @@
             <strong>On this page</strong>
             <ol><li class="article-toc-level-1 article-toc-top"><a href="#article-title" data-article-toc-link data-article-toc-target="article-title" aria-current="location">Article start</a></li>
               <li class="article-toc-level-2"><a href="#prepare-provider" data-article-toc-link data-article-toc-target="prepare-provider">1. Start from the intended Host and folder</a></li>
-              <li class="article-toc-level-2"><a href="#choose-runtime" data-article-toc-link data-article-toc-target="choose-runtime">2. Choose Claude or Codex in Session Setup</a></li>
+              <li class="article-toc-level-2"><a href="#choose-runtime" data-article-toc-link data-article-toc-target="choose-runtime">2. Choose Codex, Claude, or Grok in Session Setup</a></li>
               <li class="article-toc-level-3"><a href="#claude-controls" data-article-toc-link data-article-toc-target="claude-controls">Claude</a></li>
               <li class="article-toc-level-3"><a href="#codex-controls" data-article-toc-link data-article-toc-target="codex-controls">Codex</a></li>
+              <li class="article-toc-level-3"><a href="#grok-controls" data-article-toc-link data-article-toc-target="grok-controls">Grok</a></li>
               <li class="article-toc-level-2"><a href="#refresh-catalog" data-article-toc-link data-article-toc-target="refresh-catalog">3. Refresh the selected catalog once when needed</a></li>
               <li class="article-toc-level-2"><a href="#prove-ready" data-article-toc-link data-article-toc-target="prove-ready">4. Prove runtime readiness with one Session</a></li>
               <li class="article-toc-level-2"><a href="#recover-command" data-article-toc-link data-article-toc-target="recover-command">5. Recover an unavailable runtime without hiding it</a></li>
@@ -133,8 +134,8 @@
   <section aria-labelledby="prepare-provider">
     <h2 id="prepare-provider">1. Start from the intended Host and folder</h2>
     <ul>
-      <li>Open the intended Oysterun Host and reach <strong>Sessions</strong>. Entering the Host dashboard password unlocks Oysterun only; it does not sign Claude or Codex in.</li>
-      <li>Confirm that the intended Claude Code or Codex command resolves for the same operating-system user that runs the Host. An installation owned only by another user does not make that runtime available here.</li>
+      <li>Open the intended Oysterun Host and reach <strong>Sessions</strong>. Entering the Host dashboard password unlocks Oysterun only; it does not sign Codex, Claude Code, or Grok in.</li>
+      <li>Confirm that the intended Codex, Claude Code, or Grok command resolves for the same operating-system user that runs the Host. An installation owned only by another user does not make that runtime available here.</li>
       <li>Know which <strong>Start Folder</strong> the new Session should use. Provider readiness is checked for the Session you are about to create, not for a different Host or folder.</li>
     </ul>
     <aside class="safety-note">
@@ -143,11 +144,11 @@
   </section>
 
   <section aria-labelledby="choose-runtime">
-    <h2 id="choose-runtime">2. Choose Claude or Codex in Session Setup</h2>
+    <h2 id="choose-runtime">2. Choose Codex, Claude, or Grok in Session Setup</h2>
     <ol>
       <li>From <strong>Sessions</strong>, choose <strong>New Session</strong>.</li>
       <li>In <strong>Session Setup</strong>, find <strong>Provider Runtime</strong>, then <strong>Agent Runtime</strong>.</li>
-      <li>Choose <strong>Claude</strong> or <strong>Codex</strong>. Oysterun shows only runtimes whose saved command is currently available on this Host. Seeing only Codex, for example, means Claude is not currently offered by that Host.</li>
+      <li>Choose <strong>Codex</strong>, <strong>Claude</strong>, or <strong>Grok</strong>. Oysterun shows only runtimes whose saved command is currently available on this Host. A missing runtime is not currently offered by that Host.</li>
       <li>Read the visible <strong>Model</strong>, <strong>Reasoning Effort</strong>, and provider-specific fixed control before continuing.</li>
     </ol>
 
@@ -160,9 +161,13 @@
         <h3 id="codex-controls">Codex</h3>
         <p>Codex uses <strong>Approval Style</strong>. In normal Oysterun Sessions it is disabled intentionally and says <strong>Fixed for Oysterun Sessions.</strong> Codex has no <code>auto</code> reasoning choice. Oysterun displays the product label <code>max</code> when the selected Codex model supports native <code>xhigh</code>.</p>
       </article>
+      <article class="provider-card grok-card">
+        <h3 id="grok-controls">Grok</h3>
+        <p>Grok requires the official CLI version <strong>1.0.25 or newer</strong>. Its Model and Reasoning Effort choices come from structured provider metadata; update the CLI if Oysterun reports an older or unverifiable version.</p>
+      </article>
     </div>
 
-    <p>If a saved default runtime is unavailable, Oysterun can temporarily select another available runtime for a fresh Session and says which saved provider is unavailable and which provider new Sessions will use. Treat the highlighted <strong>Claude</strong> or <strong>Codex</strong> button—not the old default—as the current choice. Switching providers is a deliberate new choice: recheck Model and Reasoning Effort before starting.</p>
+    <p>If a saved default runtime is unavailable, Oysterun can temporarily select another available runtime for a fresh Session and says which saved provider is unavailable and which provider new Sessions will use. Treat the highlighted <strong>Codex</strong>, <strong>Claude</strong>, or <strong>Grok</strong> button—not the old default—as the current choice. Switching providers is a deliberate new choice: recheck Model and Reasoning Effort before starting.</p>
   </section>
 
   <section aria-labelledby="refresh-catalog">
@@ -209,8 +214,8 @@
 
     <ol>
       <li>Open the Oysterun menu and choose <strong>Host Preferences</strong>.</li>
-      <li>Find <strong>Claude Runtime Defaults</strong> or <strong>Codex Runtime Defaults</strong>.</li>
-      <li>Read <strong>Claude Command</strong> or <strong>Codex Command</strong>. A blank field disables that runtime explicitly. An available command says <strong>Available on this Host.</strong>; an unresolved one says <strong>Unavailable on this Host.</strong></li>
+      <li>Find the intended <strong>Codex</strong>, <strong>Claude</strong>, or <strong>Grok Runtime Defaults</strong>.</li>
+      <li>Read the matching provider command. A blank field disables that runtime explicitly. An available command says <strong>Available on this Host.</strong>; an unresolved one says <strong>Unavailable on this Host.</strong></li>
       <li>Fix the provider installation or executable path for the Host's operating-system user. If you change the command field, choose <strong>Save</strong>, then return to Session Setup.</li>
       <li>Select the runtime, refresh its models once, and continue only after a success status and valid Model/Reasoning Effort choices are visible.</li>
     </ol>
@@ -229,7 +234,7 @@
 
     <ol>
       <li>Use the machine terminal. If it is not otherwise available, choose the <strong>Open Terminal</strong> link in the visible system row.</li>
-      <li>For Codex, run <code>codex /login</code>. For Claude, run <code>claude /login</code>.</li>
+      <li>For Codex, run <code>codex /login</code>. For Claude, run <code>claude /login</code>. For Grok, run <code>grok login</code>.</li>
       <li>Finish the provider-owned browser or terminal login without capturing its URL, code, token, or output as public evidence.</li>
       <li>Return to the same affected Chat. The system row calls for <strong>Restart session</strong>; use <strong>More Options</strong> (vertical ellipsis) → <strong>Restart</strong>. This restarts only that provider Session; it is not permission to restart the Oysterun Host.</li>
       <li>Send one short non-sensitive message. A normal response is the recovery verdict.</li>

package/static/site/docs/choose-and-recover-a-provider/en/index.md

@@ -1,6 +1,6 @@
 # Choose and recover an Oysterun provider
 
-Choose Claude or Codex in Session Setup, separate dashboard access from provider login, and follow one bounded recovery path when its command or login is unavailable.
+Choose Codex, Claude, or Grok in Session Setup, separate dashboard access from provider login, and follow one bounded recovery path when its command or login is unavailable.
 
 Choose the agent runtime that should own a new Session, keep Oysterun dashboard access separate from provider login, and prove that the selected provider can answer now instead of treating an installed command or loaded model list as readiness.
 
@@ -32,8 +32,8 @@ reaches Chat; and a short message receives a response from that Session. A refre
 
    Sessions
 
-   . Entering the Host dashboard password unlocks Oysterun only; it does not sign Claude or Codex in.
-- Confirm that the intended Claude Code or Codex command resolves for the same operating-system user that runs the Host. An installation owned only by another user does not make that runtime available here.
+   . Entering the Host dashboard password unlocks Oysterun only; it does not sign Codex, Claude Code, or Grok in.
+- Confirm that the intended Codex, Claude Code, or Grok command resolves for the same operating-system user that runs the Host. An installation owned only by another user does not make that runtime available here.
 - Know which
 
    Start Folder
@@ -44,7 +44,7 @@ Keep secrets out of Oysterun content:
 
 never paste a provider token, login code, Host password, dashboard token, or private login URL into Chat, an AgentFolder file, a support report, or a screenshot. Enter provider credentials only in the provider's supported login flow.
 
-## 2. Choose Claude or Codex in Session Setup
+## 2. Choose Codex, Claude, or Grok in Session Setup
 
 1. From
 
@@ -70,13 +70,17 @@ never paste a provider token, login code, Host password, dashboard token, or pri
    .
 1. Choose
 
+   Codex
+
+   ,
+
    Claude
 
-   or
+   , or
 
-   Codex
+   Grok
 
-   . Oysterun shows only runtimes whose saved command is currently available on this Host. Seeing only Codex, for example, means Claude is not currently offered by that Host.
+   . Oysterun shows only runtimes whose saved command is currently available on this Host. A missing runtime is not currently offered by that Host.
 1. Read the visible
 
    Model
@@ -95,7 +99,11 @@ Claude uses **Permission Mode**. In normal Oysterun Sessions it is disabled inte
 
 Codex uses **Approval Style**. In normal Oysterun Sessions it is disabled intentionally and says **Fixed for Oysterun Sessions.** Codex has no `auto` reasoning choice. Oysterun displays the product label `max` when the selected Codex model supports native `xhigh`.
 
-If a saved default runtime is unavailable, Oysterun can temporarily select another available runtime for a fresh Session and says which saved provider is unavailable and which provider new Sessions will use. Treat the highlighted **Claude** or **Codex** button—not the old default—as the current choice. Switching providers is a deliberate new choice: recheck Model and Reasoning Effort before starting.
+### Grok
+
+Grok requires the official CLI version **1.0.25 or newer**. Its Model and Reasoning Effort choices come from structured provider metadata; update the CLI if Oysterun reports an older or unverifiable version.
+
+If a saved default runtime is unavailable, Oysterun can temporarily select another available runtime for a fresh Session and says which saved provider is unavailable and which provider new Sessions will use. Treat the highlighted **Codex**, **Claude**, or **Grok** button—not the old default—as the current choice. Switching providers is a deliberate new choice: recheck Model and Reasoning Effort before starting.
 
 ## 3. Refresh the selected catalog once when needed
 
@@ -190,24 +198,20 @@ Unavailable on this Host
    Host Preferences
 
    .
-1. Find
-
-   Claude Runtime Defaults
-
-   or
+1. Find the intended
 
-   Codex Runtime Defaults
+   Codex
 
-   .
-1. Read
+   ,
 
-   Claude Command
+   Claude
 
-   or
+   , or
 
-   Codex Command
+   Grok Runtime Defaults
 
-   . A blank field disables that runtime explicitly. An available command says
+   .
+1. Read the matching provider command. A blank field disables that runtime explicitly. An available command says
 
    Available on this Host.
 
@@ -256,6 +260,10 @@ together without exposing an authentication URL, code, account, or secret.
 
    claude /login
 
+   . For Grok, run
+
+   grok login
+
    .
 1. Finish the provider-owned browser or terminal login without capturing its URL, code, token, or output as public evidence.
 1. Return to the same affected Chat. The system row calls for

package/static/site/docs/choose-and-recover-a-provider/zh/index.html

@@ -4,7 +4,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>選擇並恢復 Oysterun 提供者</title>
-    <meta name="description" content="在 Session Setup 選擇 Claude 或 Codex、分清 dashboard 與提供者登入，並在命令或登入失效時走完一次有界復原。" />
+    <meta name="description" content="在 Session Setup 選擇 Codex、Claude 或 Grok、分清 dashboard 與提供者登入，並在命令或登入失效時走完一次有界復原。" />
     <meta name="robots" content="index,follow" />
     <link rel="icon" href="/assets/oysterun_logo_v5.PNG" type="image/png" />
     <link rel="stylesheet" href="/assets/site.css" />
@@ -70,7 +70,7 @@
             </details>
             <details class="docs-task-group" open id="docs-group-sessions-providers">
               <summary>Session 與提供者</summary>
-              <ul><li><a href="/docs/configure-session-files-and-settings/zh/index.html" data-doc-search-text="選擇 session 資料夾並控制設定是否儲存 選擇範圍明確的 start folder、在 folder picker 取消或確認時保留設定草稿，並判斷 session 設定只套用一次或寫入專案設定。 session 與提供者">選擇 Session 資料夾並控制設定是否儲存</a></li><li><a href="/docs/choose-and-recover-a-provider/zh/index.html" aria-current="page" data-doc-search-text="選擇並恢復 oysterun 提供者 在 session setup 選擇 claude 或 codex、分清 dashboard 與提供者登入，並在命令或登入失效時走完一次有界復原。 session 與提供者">選擇並恢復 Oysterun 提供者</a></li><li><a href="/docs/understand-agent-activity/zh/index.html" data-doc-search-text="如何判讀 oysterun agent 正在工作或已經閒置 從 sessions 頁面實際送出一則安全訊息，分辨可用、占用、工作、完成與未知狀態，避免重複派工。 session 與提供者">如何判讀 Oysterun Agent 正在工作或已經閒置</a></li></ul>
+              <ul><li><a href="/docs/configure-session-files-and-settings/zh/index.html" data-doc-search-text="選擇 session 資料夾並控制設定是否儲存 選擇範圍明確的 start folder、在 folder picker 取消或確認時保留設定草稿，並判斷 session 設定只套用一次或寫入專案設定。 session 與提供者">選擇 Session 資料夾並控制設定是否儲存</a></li><li><a href="/docs/choose-and-recover-a-provider/zh/index.html" aria-current="page" data-doc-search-text="選擇並恢復 oysterun 提供者 在 session setup 選擇 codex、claude 或 grok、分清 dashboard 與提供者登入，並在命令或登入失效時走完一次有界復原。 session 與提供者">選擇並恢復 Oysterun 提供者</a></li><li><a href="/docs/understand-agent-activity/zh/index.html" data-doc-search-text="如何判讀 oysterun agent 正在工作或已經閒置 從 sessions 頁面實際送出一則安全訊息，分辨可用、占用、工作、完成與未知狀態，避免重複派工。 session 與提供者">如何判讀 Oysterun Agent 正在工作或已經閒置</a></li></ul>
             </details>
             <details class="docs-task-group" open id="docs-group-chat-messages-files">
               <summary>對話、訊息與檔案</summary>
@@ -95,7 +95,7 @@
           <header class="article-title-block">
             <p class="eyebrow">文件</p>
             <h1 id="article-title">選擇並恢復 Oysterun 提供者</h1>
-            <p class="article-description">在 Session Setup 選擇 Claude 或 Codex、分清 dashboard 與提供者登入，並在命令或登入失效時走完一次有界復原。</p>
+            <p class="article-description">在 Session Setup 選擇 Codex、Claude 或 Grok、分清 dashboard 與提供者登入，並在命令或登入失效時走完一次有界復原。</p>
             <p class="article-date"><time datetime="2026-08-27">2026-08-27</time></p>
           </header>
 
@@ -109,9 +109,10 @@
             <strong>本文目錄</strong>
             <ol><li class="article-toc-level-1 article-toc-top"><a href="#article-title" data-article-toc-link data-article-toc-target="article-title" aria-current="location">文章開頭</a></li>
               <li class="article-toc-level-2"><a href="#prepare-provider" data-article-toc-link data-article-toc-target="prepare-provider">1. 從正確的 Host 與資料夾開始</a></li>
-              <li class="article-toc-level-2"><a href="#choose-runtime" data-article-toc-link data-article-toc-target="choose-runtime">2. 在 Session Setup 選擇 Claude 或 Codex</a></li>
+              <li class="article-toc-level-2"><a href="#choose-runtime" data-article-toc-link data-article-toc-target="choose-runtime">2. 在 Session Setup 選擇 Codex、Claude 或 Grok</a></li>
               <li class="article-toc-level-3"><a href="#claude-controls" data-article-toc-link data-article-toc-target="claude-controls">Claude</a></li>
               <li class="article-toc-level-3"><a href="#codex-controls" data-article-toc-link data-article-toc-target="codex-controls">Codex</a></li>
+              <li class="article-toc-level-3"><a href="#grok-controls" data-article-toc-link data-article-toc-target="grok-controls">Grok</a></li>
               <li class="article-toc-level-2"><a href="#refresh-catalog" data-article-toc-link data-article-toc-target="refresh-catalog">3. 有需要時，只重新整理所選目錄一次</a></li>
               <li class="article-toc-level-2"><a href="#prove-ready" data-article-toc-link data-article-toc-target="prove-ready">4. 用一個 Session 證明 runtime 已就緒</a></li>
               <li class="article-toc-level-2"><a href="#recover-command" data-article-toc-link data-article-toc-target="recover-command">5. 復原不可用的 runtime，且不隱藏錯誤</a></li>
@@ -133,8 +134,8 @@
   <section aria-labelledby="prepare-provider">
     <h2 id="prepare-provider">1. 從正確的 Host 與資料夾開始</h2>
     <ul>
-      <li>開啟預期的 Oysterun Host 並進入 <strong>Sessions</strong>。輸入 Host dashboard 密碼只會解鎖 Oysterun，不會替 Claude 或 Codex 登入。</li>
-      <li>確認預期的 Claude Code 或 Codex 命令，可由「執行 Host 的同一個作業系統使用者」解析。若它只安裝給另一個使用者，不會讓這裡的 runtime 變成可用。</li>
+      <li>開啟預期的 Oysterun Host 並進入 <strong>Sessions</strong>。輸入 Host dashboard 密碼只會解鎖 Oysterun，不會替 Codex、Claude Code 或 Grok 登入。</li>
+      <li>確認預期的 Codex、Claude Code 或 Grok 命令，可由「執行 Host 的同一個作業系統使用者」解析。若它只安裝給另一個使用者，不會讓這裡的 runtime 變成可用。</li>
       <li>先知道新 Session 應使用哪個 <strong>Start Folder</strong>。你要確認的是即將建立之 Session 的提供者狀態，不是另一個 Host 或資料夾。</li>
     </ul>
     <aside class="safety-note">
@@ -143,11 +144,11 @@
   </section>
 
   <section aria-labelledby="choose-runtime">
-    <h2 id="choose-runtime">2. 在 Session Setup 選擇 Claude 或 Codex</h2>
+    <h2 id="choose-runtime">2. 在 Session Setup 選擇 Codex、Claude 或 Grok</h2>
     <ol>
       <li>從 <strong>Sessions</strong> 選擇 <strong>New Session</strong>。</li>
       <li>在 <strong>Session Setup</strong> 找到 <strong>Provider Runtime</strong>，再找到 <strong>Agent Runtime</strong>。</li>
-      <li>選擇 <strong>Claude</strong> 或 <strong>Codex</strong>。Oysterun 只顯示其已儲存命令目前可在此 Host 使用的 runtime。例如只看到 Codex，表示此 Host 目前沒有提供 Claude。</li>
+      <li>選擇 <strong>Codex</strong>、<strong>Claude</strong> 或 <strong>Grok</strong>。Oysterun 只顯示其已儲存命令目前可在此 Host 使用的 runtime；缺少的 runtime 目前未由該 Host 提供。</li>
       <li>繼續前，讀取畫面上的 <strong>Model</strong>、<strong>Reasoning Effort</strong>，以及該提供者專用的固定控制項。</li>
     </ol>
 
@@ -160,9 +161,13 @@
         <h3 id="codex-controls">Codex</h3>
         <p>Codex 使用 <strong>Approval Style</strong>。在一般 Oysterun Sessions 中，它會刻意停用並顯示 <strong>Fixed for Oysterun Sessions.</strong> Codex 沒有 <code>auto</code> 推理選項。若所選 Codex 模型支援原生 <code>xhigh</code>，Oysterun 會顯示產品標籤 <code>max</code>。</p>
       </article>
+      <article class="provider-card grok-card">
+        <h3 id="grok-controls">Grok</h3>
+        <p>Grok 需要官方 CLI <strong>1.0.25 或更新版本</strong>。Model 與 Reasoning Effort 來自 provider 的結構化 metadata；若 Oysterun 回報版本過舊或無法驗證，請先更新 CLI。</p>
+      </article>
     </div>
 
-    <p>若已儲存的預設 runtime 不可用，Oysterun 可以暫時為新 Session 選取另一個可用 runtime，並說明哪個已儲存提供者不可用、新 Sessions 會使用哪個提供者。請以亮起的 <strong>Claude</strong> 或 <strong>Codex</strong> 按鈕判斷目前選擇，不要沿用舊預設的印象。切換提供者是一次有意識的新選擇；開始前要重新檢查 Model 與 Reasoning Effort。</p>
+    <p>若已儲存的預設 runtime 不可用，Oysterun 可以暫時為新 Session 選取另一個可用 runtime，並說明哪個已儲存提供者不可用、新 Sessions 會使用哪個提供者。請以亮起的 <strong>Codex</strong>、<strong>Claude</strong> 或 <strong>Grok</strong> 按鈕判斷目前選擇，不要沿用舊預設的印象。切換提供者是一次有意識的新選擇；開始前要重新檢查 Model 與 Reasoning Effort。</p>
   </section>
 
   <section aria-labelledby="refresh-catalog">
@@ -209,8 +214,8 @@
 
     <ol>
       <li>開啟 Oysterun 選單，選擇 <strong>Host Preferences</strong>。</li>
-      <li>找到 <strong>Claude Runtime Defaults</strong> 或 <strong>Codex Runtime Defaults</strong>。</li>
-      <li>讀取 <strong>Claude Command</strong> 或 <strong>Codex Command</strong>。空白欄位會明確停用該 runtime。可用命令顯示 <strong>Available on this Host.</strong>；無法解析的命令顯示 <strong>Unavailable on this Host.</strong></li>
+      <li>找到預期的 <strong>Codex</strong>、<strong>Claude</strong> 或 <strong>Grok Runtime Defaults</strong>。</li>
+      <li>讀取對應的 provider command。空白欄位會明確停用該 runtime。可用命令顯示 <strong>Available on this Host.</strong>；無法解析的命令顯示 <strong>Unavailable on this Host.</strong></li>
       <li>為 Host 的作業系統使用者修正提供者安裝或執行檔路徑。若變更命令欄位，選擇 <strong>Save</strong>，再返回 Session Setup。</li>
       <li>選擇該 runtime、重新整理模型一次；只有在成功狀態與有效的 Model／Reasoning Effort 選項都可見後才繼續。</li>
     </ol>
@@ -229,7 +234,7 @@
 
     <ol>
       <li>使用執行該提供者的機器 terminal；若無法用其他方式開啟，選擇可見系統列中的 <strong>Open Terminal</strong> 連結。</li>
-      <li>Codex 執行 <code>codex /login</code>；Claude 執行 <code>claude /login</code>。</li>
+      <li>Codex 執行 <code>codex /login</code>；Claude 執行 <code>claude /login</code>；Grok 執行 <code>grok login</code>。</li>
       <li>在提供者擁有的瀏覽器或 terminal 登入流程完成操作；不要把 URL、代碼、token 或輸出存成公開證據。</li>
       <li>回到同一個受影響的 Chat。系統列把動作稱為 <strong>Restart session</strong>；實際操作為 <strong>More Options</strong>（垂直省略號）→ <strong>Restart</strong>。這只會重新啟動該提供者 Session；它不代表你有權重新啟動 Oysterun Host。</li>
       <li>傳送一則不含敏感資料的簡短訊息。正常回覆就是復原判定。</li>