vibe64 0.1.35 → 0.1.37

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (210) hide show
  1. package/bin/run.js +1984 -1685
  2. package/bin/server.js +158 -111
  3. package/bin/upgrade-state.js +5754 -5522
  4. package/dist/assets/GithubBrowserTabs-BykoCFfz.js +1 -0
  5. package/dist/assets/{StudioErrorNotice-sQfmeR-z.js → StudioErrorNotice-CSrUw1QV.js} +1 -1
  6. package/dist/assets/{Vibe64AsyncModuleState-Dx7YKRPp.js → Vibe64AsyncModuleState-Do9EqX3S.js} +1 -1
  7. package/dist/assets/Vibe64AuthSettingsButton-CIwtchKm.js +5 -0
  8. package/dist/assets/Vibe64AuthSettingsButton-M44SSmZ9.css +1 -0
  9. package/dist/assets/{Vibe64DashboardBackButton-yE6cyYg2.js → Vibe64DashboardBackButton-BH_8j_VR.js} +1 -1
  10. package/dist/assets/Vibe64DashboardShell-DXVDJUAY.js +1 -0
  11. package/dist/assets/{Vibe64DashboardShell-MBkUHjs-.css → Vibe64DashboardShell-De2mbdpI.css} +1 -1
  12. package/dist/assets/{Vibe64DatabaseWorkspace-BONJdxBS.js → Vibe64DatabaseWorkspace-Ca8IHSRq.js} +3 -3
  13. package/dist/assets/{Vibe64DatabaseWorkspace-CR4pzzcf.css → Vibe64DatabaseWorkspace-DPDMxhAW.css} +1 -1
  14. package/dist/assets/Vibe64OutputControls-Co5YzwcK.css +1 -0
  15. package/dist/assets/Vibe64OutputControls-DngQNTTt.js +8 -0
  16. package/dist/assets/{Vibe64RepositoryWorkspace-CVHcT93M.css → Vibe64RepositoryWorkspace-Agyt4O-V.css} +1 -1
  17. package/dist/assets/{Vibe64RepositoryWorkspace-ByQlZbyO.js → Vibe64RepositoryWorkspace-BfsZozSJ.js} +2 -2
  18. package/dist/assets/Vibe64SessionFiles-Bl8wJ5Sk.css +1 -0
  19. package/dist/assets/Vibe64SessionFiles-n87RqqY6.js +41 -0
  20. package/dist/assets/{Vibe64TemporaryAiFixAction-BGlcrq4d.js → Vibe64TemporaryAiFixAction-BiuIE9mC.js} +1 -1
  21. package/dist/assets/{Vibe64UiStoryboardView-Brlwdvqi.js → Vibe64UiStoryboardView-BhKRpL0N.js} +1 -1
  22. package/dist/assets/{Vibe64UnavailableSessions-zwlWlcZD.js → Vibe64UnavailableSessions-Ca5nC7KH.js} +1 -1
  23. package/dist/assets/{_sessionId_-CvOkQbVy.js → _sessionId_-B_TTRB4c.js} +1 -1
  24. package/dist/assets/{_sessionTool_-Dwod5ns9.js → _sessionTool_-1V-z6Pbp.js} +1 -1
  25. package/dist/assets/_slug_-Buxpw0T4.css +1 -0
  26. package/dist/assets/_slug_-DsqilUs_.js +24 -0
  27. package/dist/assets/{access-BVu5XYm2.js → access-tl4ht_d8.js} +1 -1
  28. package/dist/assets/app-CZu7oxUO.css +1 -0
  29. package/dist/assets/app-DT4_MliP.js +1 -0
  30. package/dist/assets/{assistantRouting-CwbwfkwB.js → assistantRouting-D4XpXcEf.js} +1 -1
  31. package/dist/assets/{changes-olY8cnFK.js → changes-DZWHZguL.js} +1 -1
  32. package/dist/assets/client-BWV84wi2.js +2 -0
  33. package/dist/assets/client-DGrP-2AJ.css +1 -0
  34. package/dist/assets/conversation-B90ERX9h.js +17 -0
  35. package/dist/assets/conversation-vxJGwmtW.css +1 -0
  36. package/dist/assets/{dashboard-BnXD-H4R.js → dashboard-iREwhGqv.js} +1 -1
  37. package/dist/assets/definitions-CNu5E87y.js +1 -0
  38. package/dist/assets/{env-DJhnLOH7.css → env-BzRtyO0w.css} +1 -1
  39. package/dist/assets/env-D5KpTEw7.js +1 -0
  40. package/dist/assets/health-BJvooRnJ.css +1 -0
  41. package/dist/assets/health-BhoO1d4h.js +1 -0
  42. package/dist/assets/{history-BxlpB-YH.js → history-DVURy45X.js} +1 -1
  43. package/dist/assets/{incoming-BOxRVlOM.js → incoming-DzADFGqp.js} +1 -1
  44. package/dist/assets/index-GBRpNZLy.js +138 -0
  45. package/dist/assets/index-irlMYzLh.css +1 -0
  46. package/dist/assets/{integrations-BFltGDVI.js → integrations-Dy5jIiJ5.js} +2 -2
  47. package/dist/assets/issues-lh7R775d.js +1 -0
  48. package/dist/assets/learning-_O1PEaam.js +1 -0
  49. package/dist/assets/mdi-CG9pWOSj.js +1 -0
  50. package/dist/assets/placement-BF-zIEhA.js +1 -0
  51. package/dist/assets/pull-requests-ByE-Dvk7.js +1 -0
  52. package/dist/assets/{repository-JWLVST3D.js → repository-BUfUAyS9.js} +1 -1
  53. package/dist/assets/roboto-latin-wght-normal-ccAYIvAh.woff2 +0 -0
  54. package/dist/assets/{session-C5Nj8Dlq.js → session-BdhKrcX4.js} +1 -1
  55. package/dist/assets/settings-CzhIcn9K.js +1 -0
  56. package/dist/assets/shared-DpMvYJO3.js +2 -0
  57. package/dist/assets/studioGateApi-DcCqiD9V.js +1 -0
  58. package/dist/assets/studioUrls-DmMMIScP.js +1 -0
  59. package/dist/assets/useArchivedVibe64Sessions-CLHJOyeW.js +1 -0
  60. package/dist/assets/useCommand-Bqxb-naz.js +1 -0
  61. package/dist/assets/useEndpointResource-DWoQ2keu.js +1 -0
  62. package/dist/assets/useRealtimeEvent-Bwapstla.js +1 -0
  63. package/dist/assets/{useUiFeedback-0FqKuZRP.js → useUiFeedback-BPBF_0bp.js} +1 -1
  64. package/dist/assets/useVibe64ConversationLog-B4JgmxUf.js +1 -0
  65. package/dist/assets/useVibe64DatabaseTools-4o6S8eXq.js +1 -0
  66. package/dist/assets/useVibe64Learning-DyqXkpLw.js +1 -0
  67. package/dist/assets/useVibe64ProjectScope-Bp1ImZlz.js +1 -0
  68. package/dist/assets/useVibe64SessionData-YhhE_5pC.js +1 -0
  69. package/dist/assets/useVibe64SessionSelection-CuZCzAcY.js +1 -0
  70. package/dist/assets/useVibe64SystemGraph-B4RmsC9Y.js +1 -0
  71. package/dist/assets/{useVibe64Terminal-BPnN25WH.js → useVibe64Terminal-Cg3idMcy.js} +1 -1
  72. package/dist/assets/vibe64AssistantHost-CP6oxv5b.js +1 -0
  73. package/dist/assets/{vibe64SessionFocus-kqPOPaOH.js → vibe64SessionFocus-Cz5Vq1re.js} +1 -1
  74. package/dist/assets/{vibe64SessionInfo-BHxtTrLX.js → vibe64SessionInfo-BuBUdL-e.js} +1 -1
  75. package/dist/assets/{vibe64SessionPanelModel-BMf64fv7.js → vibe64SessionPanelModel-DDorOuiL.js} +1 -1
  76. package/dist/assets/{vibe64SessionToolDefinitions-NfLd1HZI.js → vibe64SessionToolDefinitions-BJaJH5LR.js} +1 -1
  77. package/dist/index.html +21 -20
  78. package/docs/colleague-usage/account-profile-and-appearance.md +8 -2
  79. package/docs/colleague-usage/ai-accounts-and-routing.md +127 -16
  80. package/docs/colleague-usage/ai-onboarding.md +229 -0
  81. package/docs/colleague-usage/coding-agent-goal-pause.md +5 -5
  82. package/docs/colleague-usage/coding-agents.md +21 -0
  83. package/docs/colleague-usage/colleague-watches.md +4 -23
  84. package/docs/colleague-usage/colleague.md +10 -2
  85. package/docs/colleague-usage/connected-projects.md +10 -2
  86. package/docs/colleague-usage/conversation-context.md +2 -0
  87. package/docs/colleague-usage/dashboard-navigation.md +19 -27
  88. package/docs/colleague-usage/database.md +6 -11
  89. package/docs/colleague-usage/development-copies.md +2 -1
  90. package/docs/colleague-usage/development-env.md +6 -0
  91. package/docs/colleague-usage/github-work.md +9 -0
  92. package/docs/colleague-usage/health-checks.md +11 -5
  93. package/docs/colleague-usage/integrations.md +3 -1
  94. package/docs/colleague-usage/learning-code-questions.md +23 -51
  95. package/docs/colleague-usage/learning-course-catalogue.md +8 -6
  96. package/docs/colleague-usage/learning-environment.md +337 -0
  97. package/docs/colleague-usage/learning-history.md +70 -101
  98. package/docs/colleague-usage/learning-mode-ui.md +129 -214
  99. package/docs/colleague-usage/learning-practice-projects.md +178 -78
  100. package/docs/colleague-usage/learning-teacher-guide.md +48 -26
  101. package/docs/colleague-usage/learning-with-colleague.md +195 -216
  102. package/docs/colleague-usage/lesson-authoring.md +41 -24
  103. package/docs/colleague-usage/lesson-step-bar.md +99 -0
  104. package/docs/colleague-usage/managed-app-access.md +7 -0
  105. package/docs/colleague-usage/message-delivery-recovery.md +7 -6
  106. package/docs/colleague-usage/preview-browser-checks.md +9 -1
  107. package/docs/colleague-usage/preview-starting-application.md +0 -1
  108. package/docs/colleague-usage/preview.md +12 -1
  109. package/docs/colleague-usage/project-messages.md +2 -2
  110. package/docs/colleague-usage/project-setup.md +9 -2
  111. package/docs/colleague-usage/running-vibe64-on-your-computer.md +61 -0
  112. package/docs/colleague-usage/sessions.md +25 -33
  113. package/docs/colleague-usage/teaching-content.md +14 -40
  114. package/docs/colleague-usage/temporary-chats.md +23 -2
  115. package/docs/colleague-usage/voice-chat.md +5 -10
  116. package/docs/colleague-usage/voice-face-and-speaking-voice.md +6 -8
  117. package/docs/colleague-usage/voice-recovery.md +3 -2
  118. package/docs/templates/learn-topic/README.md +6 -6
  119. package/docs/templates/learn-topic/training/lessons/TOPIC-01/lesson.json +28 -7
  120. package/docs/templates/learn-topic/training/lessons/TOPIC-01/notes.md +19 -0
  121. package/docs/templates/learn-topic/training/lessons/TOPIC-01/steps/check-understanding.md +3 -0
  122. package/docs/templates/learn-topic/training/lessons/TOPIC-01/steps/explain-idea.md +3 -0
  123. package/docs/templates/learn-topic/training/lessons/TOPIC-01/steps/try-it.md +3 -0
  124. package/docs/templates/learn-topic/training/outline.md +1 -1
  125. package/docs/training-content.md +319 -66
  126. package/node_modules/@jskit-ai/assistant-core/package.json +1 -1
  127. package/node_modules/@jskit-ai/assistant-runtime/package.json +1 -1
  128. package/node_modules/@jskit-ai/assistant-runtime/patterns/assistant-surface/PATTERN.md +3 -2
  129. package/node_modules/@jskit-ai/assistant-runtime/patterns/assistant-surface/example/integrations.json +3 -2
  130. package/node_modules/@jskit-ai/assistant-voice/package.json +1 -1
  131. package/node_modules/@jskit-ai/connectors-catalog/package.json +1 -1
  132. package/node_modules/@jskit-ai/connectors-catalog/patterns/ai-connections/PATTERN.md +4 -3
  133. package/node_modules/@jskit-ai/connectors-catalog/src/shared/ai-models.json +0 -1
  134. package/node_modules/@local/vibe64-accounts/package.json +1 -0
  135. package/node_modules/@local/vibe64-colleague/package.json +2 -1
  136. package/node_modules/@local/vibe64-core/package.json +3 -0
  137. package/node_modules/@local/vibe64-execution/package.json +1 -0
  138. package/node_modules/@local/vibe64-execution/src/host/execHelper.js +171 -174
  139. package/node_modules/@local/vibe64-execution/src/server/engines/stdioBridge.js +9 -9
  140. package/node_modules/@local/vibe64-execution/src/server/hostProfile.js +12 -0
  141. package/node_modules/@local/vibe64-genesis/README.md +10 -37
  142. package/node_modules/@local/vibe64-genesis/bin/vibe64-genesis-host-context +790 -779
  143. package/node_modules/@local/vibe64-genesis/package.json +1 -0
  144. package/node_modules/@local/vibe64-genesis/src/server/agentSpecs.js +255 -0
  145. package/node_modules/@local/vibe64-genesis/src/server/index.js +473 -450
  146. package/node_modules/@local/vibe64-genesis/src/server/promptContext.js +148 -148
  147. package/node_modules/@local/vibe64-project/package.json +2 -1
  148. package/node_modules/@local/vibe64-runtime/package.json +1 -2
  149. package/node_modules/@local/vibe64-runtime/src/server/codexAppServerProcess.js +526 -512
  150. package/node_modules/@local/vibe64-runtime/src/shared/assistantRoutingScores.json +0 -1
  151. package/node_modules/@local/vibe64-source-editor/package.json +1 -0
  152. package/node_modules/@local/vibe64-terminals/package.json +2 -0
  153. package/node_modules/@local/vibe64-terminals/src/server/opencodeSessionEnvironmentPlugin.js +129 -131
  154. package/node_modules/@local/vibe64-terminals/src/server/sessionWorkOperationCommand.js +1508 -1456
  155. package/node_modules/@local/vibe64-training/package.json +16 -27
  156. package/package.json +7 -7
  157. package/server.bundle.mjs +41339 -41635
  158. package/dist/assets/GithubBrowserTabs-DO5PHon-.js +0 -1
  159. package/dist/assets/GithubMarkdown-BQ6MfCDJ.js +0 -3
  160. package/dist/assets/GithubMarkdown-U7-j-qNI.css +0 -1
  161. package/dist/assets/Vibe64DashboardShell-CuCVMhOc.js +0 -1
  162. package/dist/assets/Vibe64OutputControls-DAAmA09l.js +0 -8
  163. package/dist/assets/Vibe64OutputControls-DPBsyDZM.css +0 -1
  164. package/dist/assets/Vibe64SessionFiles-B0u9HKdF.js +0 -107
  165. package/dist/assets/Vibe64SessionFiles-NjOMVwPR.css +0 -1
  166. package/dist/assets/_slug_-B31c15cc.css +0 -1
  167. package/dist/assets/_slug_-Dy35qLo1.js +0 -1
  168. package/dist/assets/app-DRXCcv05.css +0 -1
  169. package/dist/assets/app-zt7HwQKT.js +0 -1
  170. package/dist/assets/client-BrV4QPwG.js +0 -2
  171. package/dist/assets/client-C1bwIlu6.css +0 -1
  172. package/dist/assets/definitions-DaOPIkyB.js +0 -1
  173. package/dist/assets/env-DN0vW4EI.js +0 -1
  174. package/dist/assets/health-7oIQODer.css +0 -1
  175. package/dist/assets/health-Z6m96GDr.js +0 -1
  176. package/dist/assets/index-BUq-MczL.js +0 -86
  177. package/dist/assets/index-DtmBqE3h.css +0 -1
  178. package/dist/assets/issues-1iS5zoed.js +0 -1
  179. package/dist/assets/layout-BkWVNT37.js +0 -1
  180. package/dist/assets/mdi-C54lQ0i_.js +0 -1
  181. package/dist/assets/placement-DLsU3pCW.js +0 -1
  182. package/dist/assets/pull-requests-BJOwNL4k.js +0 -1
  183. package/dist/assets/settings-c273Ikrm.js +0 -1
  184. package/dist/assets/shared-YZb7ocaK.js +0 -2
  185. package/dist/assets/studioGateApi-DhA9IJGZ.js +0 -1
  186. package/dist/assets/studioUrls-Dj8rXeXO.js +0 -1
  187. package/dist/assets/useArchivedVibe64Sessions-CVZx2Rtm.js +0 -1
  188. package/dist/assets/useCommand-DWuxfAV0.js +0 -1
  189. package/dist/assets/useEndpointResource-MWVNfmMa.js +0 -1
  190. package/dist/assets/useVibe64ConversationLog-8cKh1eDm.js +0 -1
  191. package/dist/assets/useVibe64DatabaseTools-BcRG1s3i.js +0 -1
  192. package/dist/assets/useVibe64LearningMode-Bl0dGdCh.js +0 -28
  193. package/dist/assets/useVibe64LearningMode-C3PcXdVg.css +0 -1
  194. package/dist/assets/useVibe64ProjectScope-DOEVkBqX.js +0 -1
  195. package/dist/assets/useVibe64SessionData-DFTyLzci.js +0 -1
  196. package/dist/assets/useVibe64SessionSelection-j9lsllx4.js +0 -1
  197. package/dist/assets/useVibe64SystemGraph-tNkIwSBQ.js +0 -1
  198. package/dist/assets/vibe64AssistantHost-DdE_-lZF.js +0 -1
  199. package/dist/assets/vibe64LessonDashboard-DlKYjisq.js +0 -1
  200. package/dist/assets/vibe64ProjectScope.local-DqT6e5un.js +0 -1
  201. package/docs/colleague-usage/learning-chat-retention.md +0 -74
  202. package/docs/colleague-usage/learning-diagrams-and-voice.md +0 -97
  203. package/docs/colleague-usage/learning-lesson-watch.md +0 -95
  204. package/docs/colleague-usage/learning-native-session.md +0 -206
  205. package/docs/colleague-usage/learning-practical-exercises.md +0 -71
  206. package/docs/colleague-usage/learning-practical-gestures.md +0 -48
  207. package/docs/colleague-usage/learning-session-creation.md +0 -95
  208. package/docs/colleague-usage/lesson-practical-assessment.md +0 -54
  209. package/docs/colleague-usage/preview-lesson-presentation.md +0 -56
  210. package/docs/templates/learn-topic/training/lessons/TOPIC-01/lesson.md +0 -44
package/dist/index.html CHANGED
@@ -21,14 +21,14 @@
21
21
  }, true);
22
22
  </script>
23
23
  <style>#startup-shell{color:#25232a;background:#faf9fc;grid-template-rows:56px 1fr;font:15px system-ui,sans-serif;display:grid;position:fixed;inset:0}#startup-shell header{border-bottom:1px solid #dedce3;align-items:center;padding:0 24px;font-weight:600;display:flex}#startup-shell main{grid-template-columns:240px 1fr;min-height:0;display:grid}#startup-shell aside{border-right:1px solid #dedce3;padding:24px}#startup-shell .startup-placeholder{background:#e5e2eb;border-radius:4px;height:16px;margin-bottom:20px}#startup-shell section{padding:32px}#startup-shell a{min-height:48px;color:inherit;align-items:center;display:inline-flex}@media (width<=600px){#startup-shell main{grid-template-columns:1fr}#startup-shell aside{display:none}}@media (prefers-color-scheme:dark){#startup-shell{color:#eeeaf3;background:#19181d}#startup-shell header,#startup-shell aside{border-color:#3c3942}#startup-shell .startup-placeholder{background:#35323d}}</style>
24
- <script type="module" crossorigin src="/assets/index-BUq-MczL.js"></script>
24
+ <script type="module" crossorigin src="/assets/index-GBRpNZLy.js"></script>
25
25
  <link rel="modulepreload" crossorigin href="/assets/runtime-core.esm-bundler-DGXg_mpN.js">
26
26
  <link rel="modulepreload" crossorigin href="/assets/ripple-BVltMmyV.js">
27
27
  <link rel="modulepreload" crossorigin href="/assets/normalize-CO2KHj_d.js">
28
28
  <link rel="modulepreload" crossorigin href="/assets/error-Dug56can.js">
29
29
  <link rel="modulepreload" crossorigin href="/assets/deepFreeze-BgoYkoTa.js">
30
- <link rel="modulepreload" crossorigin href="/assets/vibe64ProjectScope.local-DqT6e5un.js">
31
- <link rel="modulepreload" crossorigin href="/assets/useEndpointResource-MWVNfmMa.js">
30
+ <link rel="modulepreload" crossorigin href="/assets/useRealtimeEvent-Bwapstla.js">
31
+ <link rel="modulepreload" crossorigin href="/assets/useEndpointResource-DWoQ2keu.js">
32
32
  <link rel="modulepreload" crossorigin href="/assets/useApi-BPuI6ZR9-CFWU1m37.js">
33
33
  <link rel="modulepreload" crossorigin href="/assets/surface-DY1u73tB.js">
34
34
  <link rel="modulepreload" crossorigin href="/assets/placement-CwTqWLQH.js">
@@ -44,9 +44,10 @@
44
44
  <link rel="modulepreload" crossorigin href="/assets/VTextField-BR2eZeFT.js">
45
45
  <link rel="modulepreload" crossorigin href="/assets/VSheet-DZWsu0kL.js">
46
46
  <link rel="modulepreload" crossorigin href="/assets/VSelect-DL3HaA5m.js">
47
- <link rel="modulepreload" crossorigin href="/assets/layout-BkWVNT37.js">
48
- <link rel="modulepreload" crossorigin href="/assets/vibe64AssistantHost-DdE_-lZF.js">
49
- <link rel="modulepreload" crossorigin href="/assets/mdi-C54lQ0i_.js">
47
+ <link rel="modulepreload" crossorigin href="/assets/vibe64AssistantHost-CP6oxv5b.js">
48
+ <link rel="modulepreload" crossorigin href="/assets/useVibe64Learning-DyqXkpLw.js">
49
+ <link rel="modulepreload" crossorigin href="/assets/studioUrls-DmMMIScP.js">
50
+ <link rel="modulepreload" crossorigin href="/assets/mdi-CG9pWOSj.js">
50
51
  <link rel="modulepreload" crossorigin href="/assets/VBtn-B2MBK2DL.js">
51
52
  <link rel="modulepreload" crossorigin href="/assets/VAlert-P256xaE0.js">
52
53
  <link rel="modulepreload" crossorigin href="/assets/VAutocomplete-BDb95qJX.js">
@@ -59,27 +60,26 @@
59
60
  <link rel="modulepreload" crossorigin href="/assets/VSkeletonLoader-CttxM1tw.js">
60
61
  <link rel="modulepreload" crossorigin href="/assets/VSwitch-BRHeDJkH.js">
61
62
  <link rel="modulepreload" crossorigin href="/assets/_plugin-vue_export-helper-DNW4j-dv.js">
62
- <link rel="modulepreload" crossorigin href="/assets/StudioErrorNotice-sQfmeR-z.js">
63
+ <link rel="modulepreload" crossorigin href="/assets/StudioErrorNotice-CSrUw1QV.js">
63
64
  <link rel="modulepreload" crossorigin href="/assets/browserLocalStorage-B4C7rHrs.js">
64
65
  <link rel="modulepreload" crossorigin href="/assets/clipboard-CZs9aH3L.js">
65
- <link rel="modulepreload" crossorigin href="/assets/useVibe64Terminal-BPnN25WH.js">
66
- <link rel="modulepreload" crossorigin href="/assets/shared-YZb7ocaK.js">
67
- <link rel="modulepreload" crossorigin href="/assets/assistantRouting-CwbwfkwB.js">
66
+ <link rel="modulepreload" crossorigin href="/assets/useVibe64Terminal-Cg3idMcy.js">
67
+ <link rel="modulepreload" crossorigin href="/assets/shared-DpMvYJO3.js">
68
+ <link rel="modulepreload" crossorigin href="/assets/assistantRouting-D4XpXcEf.js">
68
69
  <link rel="modulepreload" crossorigin href="/assets/pathname-Bb895US8.js">
69
70
  <link rel="modulepreload" crossorigin href="/assets/usePaths-Db88-HOm.js">
70
- <link rel="modulepreload" crossorigin href="/assets/useUiFeedback-0FqKuZRP.js">
71
- <link rel="modulepreload" crossorigin href="/assets/useCommand-DWuxfAV0.js">
72
- <link rel="modulepreload" crossorigin href="/assets/studioUrls-Dj8rXeXO.js">
71
+ <link rel="modulepreload" crossorigin href="/assets/useUiFeedback-BPBF_0bp.js">
72
+ <link rel="modulepreload" crossorigin href="/assets/useCommand-Bqxb-naz.js">
73
73
  <link rel="modulepreload" crossorigin href="/assets/shared-BEwrtWSp.js">
74
74
  <link rel="modulepreload" crossorigin href="/assets/vibe64ApiResponses-DNLY1Kel.js">
75
- <link rel="modulepreload" crossorigin href="/assets/client-BrV4QPwG.js">
75
+ <link rel="modulepreload" crossorigin href="/assets/client-BWV84wi2.js">
76
76
  <link rel="modulepreload" crossorigin href="/assets/VTextarea-DbqamXJd.js">
77
77
  <link rel="modulepreload" crossorigin href="/assets/thinkingText-DewCOEcu.js">
78
- <link rel="modulepreload" crossorigin href="/assets/useVibe64ProjectScope-DOEVkBqX.js">
78
+ <link rel="modulepreload" crossorigin href="/assets/conversation-B90ERX9h.js">
79
+ <link rel="modulepreload" crossorigin href="/assets/useVibe64ProjectScope-Bp1ImZlz.js">
79
80
  <link rel="modulepreload" crossorigin href="/assets/vibe64BrowserTabOrigin-SF9E31vi.js">
80
- <link rel="modulepreload" crossorigin href="/assets/useVibe64DatabaseTools-BcRG1s3i.js">
81
- <link rel="modulepreload" crossorigin href="/assets/vibe64LessonDashboard-DlKYjisq.js">
82
- <link rel="modulepreload" crossorigin href="/assets/useVibe64SystemGraph-tNkIwSBQ.js">
81
+ <link rel="modulepreload" crossorigin href="/assets/useVibe64DatabaseTools-4o6S8eXq.js">
82
+ <link rel="modulepreload" crossorigin href="/assets/useVibe64SystemGraph-B4RmsC9Y.js">
83
83
  <link rel="stylesheet" crossorigin href="/assets/ripple-DqhAt1Ze.css">
84
84
  <link rel="stylesheet" crossorigin href="/assets/VAvatar-9ilDR2r2.css">
85
85
  <link rel="stylesheet" crossorigin href="/assets/VOverlay-DG-PukqI.css">
@@ -102,9 +102,10 @@
102
102
  <link rel="stylesheet" crossorigin href="/assets/VSwitch-FGoTnWb6.css">
103
103
  <link rel="stylesheet" crossorigin href="/assets/StudioErrorNotice-1K8E_MXD.css">
104
104
  <link rel="stylesheet" crossorigin href="/assets/useVibe64Terminal-Bk2QOSDO.css">
105
- <link rel="stylesheet" crossorigin href="/assets/client-C1bwIlu6.css">
105
+ <link rel="stylesheet" crossorigin href="/assets/client-DGrP-2AJ.css">
106
106
  <link rel="stylesheet" crossorigin href="/assets/VTextarea-DDl63AeD.css">
107
- <link rel="stylesheet" crossorigin href="/assets/index-DtmBqE3h.css">
107
+ <link rel="stylesheet" crossorigin href="/assets/conversation-vxJGwmtW.css">
108
+ <link rel="stylesheet" crossorigin href="/assets/index-irlMYzLh.css">
108
109
  </head>
109
110
  <body>
110
111
  <div id="app">
@@ -4,6 +4,12 @@ Open **Account settings** with the person-and-gear button at the right of the
4
4
  app header, then choose the **You** tab. The dialog is the same in Working and
5
5
  Learning.
6
6
 
7
+ On a phone (or a narrow window) **Account settings** fills the screen. Its
8
+ three tabs, **You**, **AI Accounts** and **GitHub**, share the width with each
9
+ icon above its label, so all of them show without scrolling sideways; a small
10
+ amber dot on a tab means that connection needs attention. Close the dialog with
11
+ the **X** at its top right. On a wider screen it opens as a centred dialog.
12
+
7
13
  ## Your name
8
14
 
9
15
  Under **Your profile** (You — all projects), type a name in **What should
@@ -16,8 +22,8 @@ name** stays disabled.
16
22
  ## Appearance
17
23
 
18
24
  Under **Appearance** (This browser), choose **Light**, **Dark** or **System**.
19
- The whole app switches immediately, including Learning's warm header and the
20
- teacher's tutor cards. **System** follows your device's light or dark setting
25
+ The whole app switches immediately, including the Learning environment (**L**),
26
+ its lesson reader and the Learn page's Lesson tab. **System** follows your device's light or dark setting
21
27
  and changes when the device does. Light is the default.
22
28
 
23
29
  The choice is saved in this browser only. Another browser, another device or a
@@ -24,11 +24,100 @@ runs. Waiting retains the stage: use its stage-specific **Continue** action when
24
24
  resolved, or **Retry** for an uncertain message. Stop remains respected.
25
25
  See [plans and workflow recovery](plans.md) for the full steps.
26
26
 
27
- Open **AI Accounts** in Management. No project or coding session is required.
28
- The local standalone editor does not require a hosted workspace login to open AI
29
- Accounts. Hosted connection changes require the workspace owner. A member's permitted models
30
- can differ from the owner's subscription models; account connection alone does not
31
- grant every collaborator use of it.
27
+ Open **Account settings → AI Accounts** from the account menu. No project or
28
+ coding session is required. AI Accounts is the same screen as
29
+ [AI onboarding](ai-onboarding.md): while no AI is connected (accounts marked
30
+ **Reconnect required** do not count) it shows **Pick the AI behind Vibe64** with
31
+ the ranked provider cards; once one is, it shows **Your AI setup** with your
32
+ cards first, each with **Manage**, and the collapsed **Advanced** panel below
33
+ them. Finishing a connection there returns to that overview (**Done**). The
34
+ guided flow with its **Why** screen opens from **Redo onboarding** in the account
35
+ menu (next to **Account settings**). Vibe64 includes no AI of its own; the free
36
+ option is GLM-4.7 Flash through a free Z.AI account (see below). OpenCode Zen is
37
+ an ordinary keyed provider: add your own Zen key to use it. Its free Big Pickle
38
+ model is not offered, and model routing or Colleague choices that named it were
39
+ cleared by the release upgrade, so the next use recommends one of your connected
40
+ AIs.
41
+
42
+ ## Install Claude Code, Codex or opencode first
43
+
44
+ Vibe64 talks to each AI through that AI's own program: **Claude Code** for Claude,
45
+ **Codex** for ChatGPT and OpenAI keys, and **opencode** for providers connected through
46
+ OpenCode. On your own computer these programs must be installed; Vibe64 uses the copy
47
+ you installed and the sign-in you already have (Claude Code and Codex keep their
48
+ logins in your home folder, so a login made in a terminal works in Vibe64 too).
49
+ opencode is different: Vibe64 runs your installed opencode program but signs it in with
50
+ the keys you add in AI Accounts, not with opencode's own login.
51
+
52
+ Before you pick a provider, its card in AI onboarding and **Your AI setup** says
53
+ **Needs Claude Code on this computer** (or Codex, or opencode) under its buttons
54
+ when that program is missing; the GLM free option says **Needs opencode on this
55
+ computer**. When a program is missing, AI Accounts (and the matching step of AI onboarding) shows
56
+ a warning instead of the sign-in button. In **Advanced → Add a connection**, an orchestrator whose
57
+ program is missing says **Not installed on this computer** under its name; choosing it
58
+ (or **Choose provider** for OpenCode) opens the same warning, and the setup dialog's
59
+ status chip reads **Not installed** or **Didn't start** instead of **Not connected**:
60
+
61
+ - **Claude Code isn't installed on this computer** (or Codex, or opencode). The warning
62
+ shows the official one-line install command with a **Copy** button and a link to
63
+ **Other ways to install** it. Open a terminal on this computer, paste the command,
64
+ press Enter, then choose **Check again**. You run the command yourself; Colleague
65
+ can explain it but cannot run it for you.
66
+ The command matches the computer Vibe64 runs on. On macOS and Linux:
67
+ - Claude Code: `curl -fsSL https://claude.ai/install.sh | bash`
68
+ - Codex: `curl -fsSL https://chatgpt.com/codex/install.sh | sh`
69
+ - opencode: `curl -fsSL https://opencode.ai/install | bash`
70
+
71
+ On Windows, in PowerShell (opencode uses its npm package, which needs Node.js):
72
+ - Claude Code: `irm https://claude.ai/install.ps1 | iex`
73
+ - Codex: `powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"`
74
+ - opencode: `npm install -g opencode-ai`
75
+ - **Codex didn't start** means the program is installed but could not be run at all.
76
+ Choose **Check again**; if it keeps failing, reinstall it with the same command. The
77
+ program's own error output is under **Details**, collapsed.
78
+ - A program that runs but isn't signed in, answers too slowly or reports a problem
79
+ with its login files shows the usual sign-in button and its message, so you can
80
+ sign in again.
81
+
82
+ Vibe64 looks for a program again every time it starts one, so a program installed
83
+ while Vibe64 is running is used as soon as you choose **Check again**; no restart is
84
+ needed. It looks on your `PATH` and in the official installers' folders
85
+ (`~/.local/bin`, `~/.claude/local`, `~/.opencode/bin`, `/opt/homebrew/bin` and
86
+ `/usr/local/bin`), so it finds them even when it was started outside a terminal. A
87
+ program installed somewhere else must be on the `PATH` of the terminal that starts
88
+ Vibe64. When Vibe64 starts, it prints one line for each program it can't find, and
89
+ **Dashboard → Health** shows a check for each. Where the host provides pinned versions
90
+ of these programs, none of these warnings or install commands appear.
91
+
92
+ ## Advanced in Your AI setup
93
+
94
+ Below the provider cards, AI Accounts (and **Your AI setup** in AI onboarding)
95
+ has a collapsed **Advanced** panel once any AI is configured. Its summary counts
96
+ the connections, for example **7 connections · 2 not on a card above**. Select it
97
+ to open:
98
+
99
+ - **Add a connection** opens **Choose an orchestrator** (Claude Code, Codex, or
100
+ OpenCode's provider catalog) for an exact orchestrator and provider pair. **Refresh** rechecks every account.
101
+ - **Model routing** has one button per connected orchestrator (**Claude Code**,
102
+ **Codex**, **OpenCode**); each opens that orchestrator's routing form.
103
+ - **Other connections** lists connected providers that have no card, such as
104
+ OpenCode Zen or another OpenCode catalog provider, each **through OpenCode**,
105
+ with **Replace key**, **Model routing** and **Remove**. OpenCode Zen's model
106
+ access controls (**Check & enable working models**, **Enable all current
107
+ models**, **Use the recommended model only**, **Cancel check**) are on its tile.
108
+ These providers also appear in the **Connected** or **Currently using** strip
109
+ at the top.
110
+ - **By tool · Claude Code**, **· Codex** and **· OpenCode** list every connection
111
+ of that orchestrator, with the same buttons.
112
+
113
+ If the connections cannot be read, Advanced shows **AI accounts could not load**
114
+ with **Try again**. On a phone the buttons fill the width. The provider cards'
115
+ own **Manage** covers the same actions for one provider. The free Z.AI connection's **Free-only
116
+ model access** switch (**Unlock all Z.AI models**, with a confirmation because
117
+ other Z.AI models use API credit) is in the GLM card's **Manage**, under **Free
118
+ option**.
119
+
120
+ ## Connect and check accounts
32
121
 
33
122
  Use the provider's displayed setup flow. API-key connections offer key entry and
34
123
  validation; subscription login can require an external browser, one-time code or
@@ -36,8 +125,8 @@ authorization code. You perform provider consent and secret entry. Wait for the
36
125
  saved connected state, and use **Refresh** or **Check saved key** when offered.
37
126
  Do not reconnect or resend a key solely because a status request was interrupted.
38
127
  DeepSeek, regular GLM API and GLM Coding Plan connections belong to the
39
- orchestrator shown in that row. Use **Add connection**, choose **Codex**,
40
- **Claude Code** or **OpenCode**, then its provider. Enter a key and complete
128
+ orchestrator shown in that row. Use **Advanced → Add a connection**, choose **Claude Code**,
129
+ **Codex** or **OpenCode**, then its provider. Enter a key and complete
41
130
  that row's verification. Each orchestrator can save a different key, or you can
42
131
  enter the same key independently for several orchestrators. Connecting or
43
132
  checking one row does not connect, check or copy a key to another. Regular GLM
@@ -50,8 +139,10 @@ assistant-workflow upgrade and preserves its recorded history; it clears saved p
50
139
  the provider. Reconnect the exact orchestrator/provider rows afterward. Colleague
51
140
  can explain this prerequisite; it cannot run the host upgrade or copy your keys.
52
141
 
53
- Use **Manage** on the exact row to check its saved key, replace it, or remove
54
- that connection. Replacement is checked before the working key is changed.
142
+ Open the provider card's **Manage** (or find the row under **Advanced**) and use
143
+ **Replace key** or **Manage sign-in** on the exact orchestrator's tile to check
144
+ or replace its key, or **Remove** to remove that connection; removing asks for
145
+ confirmation first. Replacement is checked before the working key is changed.
55
146
  Replacement and removal affect only that orchestrator/provider. If Codex reports
56
147
  another native subscriber, close the native terminal using that provider and retry.
57
148
  Claude Code also requires closing a terminal using the selected provider. If a
@@ -114,9 +205,11 @@ optional suggestions and **Configure Codex routing**, even if the key also works
114
205
  with Claude Code. Review **Current** and **Suggested**, select the changes you
115
206
  want, then use **Apply [number] changes**. **Keep current routing** leaves the
116
207
  connection ready without applying those suggestions. If no changes are suggested,
117
- use **Done** or the same orchestrator's Configure routing button.
208
+ use **Done** or the same orchestrator's routing button under **Advanced → Model
209
+ routing**.
118
210
 
119
- Open the orchestrator's **Configure routing** control to choose its supported
211
+ Open **Advanced → Model routing** and choose the orchestrator (or **Model
212
+ routing** on a connection's tile) to choose its supported
120
213
  **Senior**, **Junior**, **Helper** and **Router** destinations and thinking choices.
121
214
  The displayed routing form can also offer **Review recommendations**,
122
215
  **Confirm Helper** and **Save routing**. Follow any
@@ -153,15 +246,29 @@ Recommendation reviews and collaborator outcomes still name the complete model
153
246
  and thinking selection. On mobile, the controls may be stacked vertically.
154
247
 
155
248
  Senior and Junior share an orchestrator. Helper and Router have their own allowed
156
- choices. Shared Backup can supply a permitted alternative for collaborators.
249
+ choices. Helper also reviews your work when you press **Check my work** on a
250
+ lesson's review step: it uses the Helper of the practice session's workflow, on
251
+ your own account. Without an available Helper the review says so and records
252
+ nothing; choose one here, then press **Check my work** again. Shared Backup can supply a permitted alternative for collaborators.
157
253
  Changing routing applies to future work, not a running agent or Colleague's own
158
254
  model. Select Colleague's model through its own composer model picker; active work
159
255
  can prevent changing it until its turn stops.
160
256
 
257
+ Colleague needs no Model routing step of its own. If an AI shows **Connected**
258
+ but its roles were never saved (for example a Codex login that existed before
259
+ Vibe64 was installed), Colleague's first message or **Teach me** saves that
260
+ workflow's recommended routing, as starting a session does, and uses its
261
+ Senior model, trying Claude Code before Codex and then the other connected
262
+ workflows. Saved choices are never replaced. Colleague says it has **no usable
263
+ AI model** only when no connected workflow can supply a Senior model; connect an
264
+ AI, or open **Advanced → Model routing** and choose an available Senior, then press
265
+ Send or **Teach me** again. That message clears by itself once an AI is usable.
266
+
161
267
  If the form says routing changed elsewhere, use **Reload current choices** and
162
268
  review your retained draft before saving. If no permitted model is usable, finish
163
- the real account/access setup before promising an AI answer. An included model
164
- can be available on hosted installations; verify the actual catalogue.
269
+ the real account/access setup before promising an AI answer. Vibe64 includes no
270
+ AI of its own on any installation; AI Accounts or AI onboarding connects one,
271
+ including the free GLM-4.7 Flash option.
165
272
 
166
273
  Colleague can explain these steps, inspect account/routing readiness, open AI
167
274
  Accounts and save supported routing changes when the owner explicitly asks. It
@@ -193,13 +300,17 @@ or change Colleague's model. Ask for the actual routing before changing only the
193
300
  requested future workflow role. A correct lesson answer establishes understanding,
194
301
  not successful account setup or model execution.
195
302
 
196
- If an existing GLM Coding Plan hides **Connect regular Z.AI API**, use
197
- **Add connection** → OpenCode's **Choose provider**. Wait for the catalogue,
303
+ To connect the regular Z.AI API, use the GLM card's free option (**Start free**
304
+ or **Already have a key? Connect**), or **Advanced → Add a connection** → OpenCode's
305
+ **Choose provider**. Wait for the catalogue,
198
306
  search **Z.AI** in **Search OpenCode providers**, and choose **Z.AI** rather than
199
307
  **Z.AI Coding Plan**. This opens the same regular API key editor. That route has
200
308
  no key-creation link: use [Z.AI's key page](https://z.ai/manage-apikey/apikey-list)
201
309
  in another tab, finish its registration/sign-in steps, then return to the masked
202
310
  **API key** field and **Verify and connect**. Keep the key out of Colleague chat.
311
+ This is Vibe64's free option: GLM-4.7 Flash is free on Z.AI's regular API, so a
312
+ free Z.AI account is enough. AI onboarding's GLM card offers the same connection
313
+ directly through **Start free**.
203
314
 
204
315
  For one main conversation, open its chat mode menu and choose **Custom**. Select
205
316
  **Orchestrator**, then **Model** and **Thinking**, and press **Apply**. The model
@@ -0,0 +1,229 @@
1
+ # Set up your AI (AI onboarding)
2
+
3
+ Vibe64 works best with a frontier model. AI onboarding is a short full-screen
4
+ flow that explains why and helps you connect one: Claude (recommended), Codex,
5
+ DeepSeek or GLM, or the free option, GLM-4.7 Flash with a free Z.AI account.
6
+ It uses the same sign-in, key and Model routing steps as **AI Accounts**; it
7
+ never disconnects anything. Vibe64 includes no AI of its own: without a
8
+ connected AI, Colleague, sessions and background helpers (prompt hints, titles)
9
+ do not run, and Colleague shows **Set up your AI**.
10
+
11
+ ## When it appears
12
+
13
+ - When the editor opens and no AI is connected (a Claude or Codex sign-in, a
14
+ DeepSeek or GLM key, including the free Z.AI key, or another OpenCode key).
15
+ - It opens by itself at most once per page load, and not when AI status could
16
+ not load, another dialog is open, you are in Learning, or you chose
17
+ **Set up later** in this browser within the last 24 hours.
18
+ - Only someone who may connect AI sees it.
19
+
20
+ Open it again at any time from the account menu: select the account button at
21
+ the top right (**Account menu**), then **Redo onboarding**. The same menu holds
22
+ **Account settings**, whose **AI Accounts** tab is this same screen without the
23
+ **Why** step: the provider cards, **Manage** and **Advanced**, with its own
24
+ **Back** and **Done** (Done returns to the overview). While no AI is connected
25
+ (an expired sign-in or key that needs reconnecting does not count), AI Accounts
26
+ shows **Pick the AI behind Vibe64**, Colleague shows a small crowned **Set up your AI** note, and the top bar shows a gold crowned
27
+ **Set up AI** button beside the account button (smaller on a phone). While that
28
+ button shows, the account button stays neutral.
29
+ Each opens the flow at the provider choice, closing Account settings first; closing the flow returns focus to the
30
+ account button. While AI Accounts is saving, signing in or removing something,
31
+ the flow waits: these entries do nothing until it finishes.
32
+
33
+ ## Screen 1: why it matters
34
+
35
+ **First, give Vibe64 a brilliant mind.** says frontier AI makes Vibe64
36
+ dramatically better and lists three things it does (plans before it codes,
37
+ fixes its own bugs, understands your whole app). Beside it is a stack of the
38
+ four providers, each with an intelligence meter, Claude crowned on the front
39
+ card (on a phone, the crowned Claude tile sits above the headline). Choose
40
+ **Choose my AI** to continue, or **Set up later**. Three dots at the top show
41
+ the step (1 of 3).
42
+
43
+ ## Screen 2: choose your AI
44
+
45
+ **Pick the AI behind Vibe64** ranks the providers by how good Vibe64 feels
46
+ (**Our honest advice: Claude.**). The cards are stacked in one column, Claude
47
+ first with a wide gold crown on its tile. Every card shows three facts with a
48
+ five-segment meter (low ratings in a warning tone; hover a meter for its
49
+ rating), then the plan: its official name and price first, our budget advice
50
+ beneath where it differs from the price (Claude and Codex have none):
51
+
52
+ 1. **Claude** (crown, gold **Recommended** ribbon): very high intelligence, very
53
+ generous quota, very high speed. **Claude Pro, $20/month.** **Coding a lot?
54
+ Max · $100/month.**
55
+ 2. **Codex** (OpenAI): very good intelligence, with quota and speed issues; hits
56
+ limits on long sessions. **ChatGPT Pro, $100/month.** **Coding a lot?
57
+ $200/month.**
58
+ 3. **DeepSeek**: cheap, pay as you go (cost grows with work), weaker on long
59
+ coding tasks. **Prepaid API credit, pay as you go**; budget about $20 to
60
+ start. It works, but you will notice the gap: for $20 a month, Claude Pro
61
+ gives a far better experience.
62
+ 4. **GLM** (Z.AI): a budget subscription. **GLM Coding Plan, from $18/month**;
63
+ budget about $30/month for daily coding. It works, but there is no point in
64
+ getting it when Claude Pro is $20/month. Below the plan the card
65
+ shows **Free option: GLM-4.7 Flash with a free Z.AI account**: Z.AI's regular API
66
+ serves GLM-4.7 Flash free of charge (no plan or credit). It is good for
67
+ trying Vibe64; expect slower, simpler work than the paid plans.
68
+
69
+ Prices are set by each provider and can change. You pay the provider directly;
70
+ Vibe64 never resells AI.
71
+
72
+ Each card offers **Get [provider]**, which opens the provider's site in a new
73
+ tab and moves to Connect, and **Already subscribed? Connect** (Claude, Codex) or
74
+ **Already have a key? Connect** (DeepSeek, GLM), which goes straight to Connect.
75
+ The **Get** button's weight follows the rank: filled for Claude, tonal for
76
+ Codex, outlined for DeepSeek and GLM. The GLM card's free option has its own
77
+ **Start free** (opens Z.AI's API Keys page in a new tab and moves to Connect)
78
+ and **Already have a key? Connect**. Once the free key is connected the line
79
+ reads **Connected.**, and during a redo it offers **Use the free option as my
80
+ main AI**.
81
+
82
+ ## Screen 3: connect
83
+
84
+ **Connect [provider]** shows the chosen mark with the plan name and price, in
85
+ one column with two steps. Step 1, **Get a plan**, repeats any budget advice
86
+ with the **Open [site]** button (**Already subscribed** or, for DeepSeek,
87
+ **Already have credit** if you came from the Connect link). Step 2 holds the
88
+ normal AI Accounts setup directly:
89
+
90
+ - **Claude**: **Sign in with Claude**, using the Claude account that has your
91
+ plan, then paste the code it shows.
92
+ - **Codex**: **Sign in with ChatGPT**. In ChatGPT's Security settings turn on
93
+ **Enable device code authorization for Codex**, then sign in and enter the
94
+ short code.
95
+ - **DeepSeek**: **Paste your DeepSeek API key**, then **Check and connect**.
96
+ - **GLM**: **Paste your Z.AI Coding Plan key** (create it on Z.AI under Personal
97
+ Coding Plan → Plan Overview), then **Check and connect**.
98
+ - **GLM-4.7 Flash (free)**: **Paste your Z.AI API key** (Z.AI's API Keys page),
99
+ then **Connect**. Vibe64 checks it with one tiny free GLM-4.7 Flash request
100
+ before saving it. This key is a regular Z.AI API key, not a Coding Plan key.
101
+
102
+ Each choice runs through a program installed on this computer: Claude through
103
+ **Claude Code**, Codex, DeepSeek and GLM through **Codex**, and the free GLM-4.7
104
+ Flash through **opencode**. A card whose program is missing says **Needs
105
+ [program] on this computer** under its buttons before you choose it. If that
106
+ program is missing, Step 2 shows a warning instead of the sign-in or key form:
107
+
108
+ - **[Claude Code, Codex or opencode] isn't installed on this computer**, with its
109
+ official one-line install command, a **Copy** button and **Other ways to install**.
110
+ Open a terminal on this computer, paste the command and press Enter, then choose
111
+ **Check again**. You run the command yourself.
112
+ - **[Program] didn't start**: it is installed but could not be run at all. Choose
113
+ **Check again**; if it keeps failing, reinstall it. Its own error output is under
114
+ **Details**, collapsed. A program that runs but reports a sign-in problem keeps
115
+ the usual sign-in button.
116
+
117
+ Both warnings also offer **Choose another AI**. See
118
+ [AI accounts](ai-accounts-and-routing.md#install-claude-code-codex-or-opencode-first)
119
+ for the install commands and where Vibe64 looks for these programs.
120
+
121
+ DeepSeek and the GLM Coding Plan connect through Codex; the free GLM-4.7 Flash
122
+ option connects through OpenCode. Use **Back** (above the header on a
123
+ desktop, the arrow at the top left on a phone) to return to the provider list.
124
+ Keys are stored privately outside your projects and never shown again.
125
+
126
+ ## Success
127
+
128
+ The success screen appears, with the provider's mark arriving in a soft glow,
129
+ once the connection is saved and a Senior model is ready. On first setup
130
+ Colleague switches to the new AI and says hello: the heading reads
131
+ **[Provider] is connected** while a small Colleague card shows typing dots,
132
+ then **[Provider] is ready** with its one-line reply and a green check. The
133
+ hello is an ordinary Colleague message, so it also appears in Colleague's
134
+ conversation. If Colleague cannot reach the provider within about 15 seconds
135
+ (for example a bad key or no credit), the heading reads **Almost there** and
136
+ the card says **Colleague couldn't reach [provider]** with the reason and
137
+ **Retry**, **Check connection** (back to Connect) or **Continue anyway**; the
138
+ check appears only after a reply or **Continue anyway**. Below it **Main AI:
139
+ [provider] · [model]** and **Change it any time in Account settings → AI
140
+ Accounts**. Otherwise the screen shows
141
+ **Colleague: still using [model]** with **Use [provider] for Colleague**.
142
+ Choose **Start building** (the bottom bar on a phone) to close; Colleague opens
143
+ with its message box ready so you can ask it to build your first page.
144
+
145
+ In Learn mode Colleague's conversation is your teacher's, so setup sends no
146
+ hello there: the card says **Your teacher uses [provider] from your next
147
+ message**, the check appears at once, and the close button reads **Back to the
148
+ lesson** (or **Back to Learn** with no lesson in progress).
149
+
150
+ If the provider connected but no model is ready yet, Connect shows **[Provider]
151
+ is connected, but no model is ready for Colleague yet.** with **Review model
152
+ routing**; choose an available Senior there and save.
153
+
154
+ ## Redo with an existing setup
155
+
156
+ **Your AI setup** starts with a strip of the connected providers' marks. When
157
+ Colleague uses one of them it reads **Currently using · Main AI: [provider]**
158
+ with the only **Keep using [provider]** button; otherwise it reads **Connected
159
+ · [providers]** with **Choose a main AI below. We recommend Claude.** Cards you
160
+ use come first. Connected cards have a green outline with a **Connected** badge
161
+ (**Connected · in use** for the main AI), no plan or sign-up offer, and **Manage**; on a phone they
162
+ stay expanded. A card whose sign-in or key stopped working has an amber outline,
163
+ a **Reconnect required** badge and **Reconnect [provider]**, which opens its
164
+ connect step. Claude's card adds **Upgrade your experience** when you use
165
+ another AI. Choose **Use [provider] as my main AI** (on the other cards **Use as
166
+ main AI**) to switch, or **Get** another provider to add it. When switching
167
+ would replace the model Vibe64 builds with, **Build with [provider]?** offers
168
+ two choices: **Use [provider] for building** applies the suggested routing and
169
+ moves Colleague; **Keep [current] for building** leaves routing as it is.
170
+ **Show details** lists each change (Building, Quick tasks) with current and
171
+ suggested models. When nothing is set for building yet, the suggestions apply
172
+ without asking. Nothing is removed from the card itself.
173
+
174
+ ### Manage a provider
175
+
176
+ **Manage** opens a window (full screen on a phone) titled with the provider,
177
+ saying which tools it is connected through, for example **Connected through
178
+ Claude Code and Codex**, with **Billing & usage** when the provider has an
179
+ account page. Each connection is a tile naming the tool (Claude Code, Codex or
180
+ OpenCode), the account or billing, the model and the saved key's last
181
+ characters, with **Default** on the one used by default. Its buttons:
182
+
183
+ - **Manage sign-in** (Claude or Codex login) or **Replace key** (a provider
184
+ key); **Reconnect** when it stopped working.
185
+ - **Model routing** to choose the models for that tool.
186
+ - **Remove**, which asks for confirmation first.
187
+
188
+ GLM's Manage lists the free Z.AI connection under **Free option**, with the
189
+ **Free-only model access** switch (**Unlock all Z.AI models**); turning it on asks
190
+ for confirmation because other Z.AI models can use API credit. Close the window
191
+ with its close button or Escape; focus returns to **Manage**.
192
+
193
+ ## Closing and recovery
194
+
195
+ **Set up later** (next to **Choose my AI** on the first screen, then at the top
196
+ right; on a phone in the bottom bar of the first screen, then below the cards
197
+ and below the connect steps) closes the flow and keeps it from opening by itself in this browser for 24 hours. The
198
+ close button or Escape just closes it. While a sign-in, key check or routing
199
+ save runs, closing and **Back** wait for it to finish.
200
+
201
+ - **We couldn't check your current AI connections.** Use **Try again**;
202
+ connecting still works, but Connected badges are hidden until status loads.
203
+ - Sign-in and key errors are the same messages as in AI Accounts (for example
204
+ Z.AI overload or insufficient balance); retry the same step.
205
+ - **Manage** stays on this screen: closing it (its close button or Escape)
206
+ returns to the cards with focus on the **Manage** button you used. While a
207
+ removal, key change or routing save runs, Manage cannot be closed.
208
+ - Someone who may not connect AI sees **Only the Vibe64 owner can connect AI
209
+ accounts.** with **Close**.
210
+
211
+ ## Desktop and phone
212
+
213
+ On a desktop the choice screen is one column: Claude's card on top, its plan and
214
+ buttons beside its facts, then Codex, DeepSeek and GLM as full-width rows (facts,
215
+ plan, buttons), with the GLM free option across the bottom of its row. On a phone
216
+ everything is one column too: Claude is expanded, the other cards are compact rows you tap to expand, the top
217
+ bar holds only the back arrow or wordmark, the step dots and close, and
218
+ **Choose my AI**, **Set up later** and the "change it any time" note sit in a
219
+ bar at the bottom of the first screen. **Manage** opens as a centred window on a
220
+ desktop and fills the screen on a phone, with its tiles' buttons spread across
221
+ the full width. Motion (the crown's glint, the card
222
+ stack, the success glow) is turned off when your device asks for reduced
223
+ motion.
224
+
225
+ ## What Colleague can do
226
+
227
+ Colleague can explain these screens, compare the providers and offer to open
228
+ the flow. Choosing a plan, paying, signing in, entering a key and approving
229
+ routing remain your steps; never paste a key into chat.
@@ -41,11 +41,11 @@ available during that wait. Use **Resume goal** when you want work to continue.
41
41
  You can choose **Set goal** and **Start goal** while Claude is working. The goal
42
42
  uses the same conversation's steering path, and **Goal** shows it after Claude
43
43
  acknowledges the command. You do not need to stop the current work first.
44
- On Claude versions supporting targeted **Send now**, setting or resuming a goal
45
- while work is active preserves its background agents and background tasks.
46
- Foreground work may be interrupted so Claude can read the new instruction.
47
- Older Claude versions retain their previous interruption behavior. **Stop** and
48
- **Pause goal** still stop work; use those controls when cancellation is intended.
44
+ Setting or resuming a goal while Claude works never interrupts that work: a
45
+ running command (for example a long deploy), background agents and background
46
+ tasks all continue. Claude reads the goal after its current tool call finishes.
47
+ **Stop** and **Pause goal** still stop work; use those controls when cancellation
48
+ is intended.
49
49
  When a background task finishes, Claude stays working while it reads and handles
50
50
  the result. Its goal controls remain available during that follow-up, including
51
51
  a requested Pause after the worker's safe checkpoint. The worker finishing alone
@@ -48,8 +48,26 @@ running; it does not mean your submitted work stopped. Inspect the retained repl
48
48
  before resending. The same recovery applies on desktop and phone; Colleague can
49
49
  explain it, while the browser reconnection requires your interaction.
50
50
 
51
+ ## Exact Vibe64 contracts for coding agents
52
+
53
+ When a coding agent writes or repairs a Vibe64-owned project declaration, such as
54
+ the `## Workspace setup` or `## Outputs` section of `genesis/stack.md`, a Preview
55
+ identity adapter or an integration setup command, it reads the exact contract
56
+ with `vibe64-helper spec <name>`. `vibe64-helper spec` lists every contract.
57
+ These specs are part of the installed Vibe64 release, so the agent does not need
58
+ Vibe64's source. A Stack error ends with the spec to read, for example
59
+ `Exact grammar: vibe64-helper spec outputs.`
60
+
61
+ Colleague does not run this command. To get a contract applied, ask the coding
62
+ agent in Main chat; Colleague can explain which contract applies and offer to
63
+ send that request. Desktop and mobile behave the same.
64
+
51
65
  ## Send, steer and stop
52
66
 
67
+ A message that a lesson's **Do it for me** sent for you (in a practice
68
+ project's Main chat) is your message like any other and shows a small **Sent
69
+ by the lesson** chip under it.
70
+
53
71
  While **Send** is pending, Vibe64 prepares the selected assistant and waits for
54
72
  delivery acknowledgement. Codex reuses an already-ready project environment;
55
73
  missing resources or changed Env files still require preparation. Wait for
@@ -80,6 +98,9 @@ When an assistant cannot start, stops by itself or reports a failure, see [When
80
98
  conversation. Type the request and select **Send**.
81
99
  2. While it works, add instructions through **Steer**. This targets the active
82
100
  conversation; selecting another project does not move an earlier request.
101
+ Steering never stops running work: Claude reads the instruction after its
102
+ current command (such as a deploy) finishes, and Codex adds it to the active
103
+ turn. Use **Stop** when you want to cancel.
83
104
  3. Use its **Stop** control when you want to stop coding work. Stopping speech or
84
105
  Colleague's own turn has a different effect. For Codex, **Stop** targets this
85
106
  conversation; other conversations remain available even when they share your
@@ -21,29 +21,10 @@ watch without stopping the agent. Close this view to return to the same chat and
21
21
  draft. On phone, use **Close watches and assignments** in its header. Ask
22
22
  Colleague to list, cancel or resume watches if you prefer.
23
23
 
24
- In an active Learning task, “Watch me while I do this” starts the same polling
25
- watch shown in that dialog; asking how it works does not start anything. You can
26
- ask Colleague to read, pause, resume or stop it. Learning status reports the exact
27
- goal/target, active/paused/unavailable state, latest valid observation and time,
28
- last delivered-help receipt, and any saved assessment outcome. Observation and
29
- help are not themselves proof of completion. When Main points you to a place
30
- (a ring and caption on the real control), the view switch you then make yourself,
31
- such as Preview to **Dashboard → Database** or **Dashboard → Files**, is observed as
32
- your step; a database sub-view switch (Overview/ERD/Data) is not yet observed
33
- separately. Besides Vibe64 view and control
34
- steps, the watch notices a failed data-changing request that your own click or
35
- submit in the visible practice-app **Preview** started (method, a lesson-declared
36
- path or `other`, status and failure code only—never typed text, bodies, headers
37
- or queries); Main gets at most one hint for it per 30 seconds. A separate Learning watcher checks
38
- only those validated facts; Colleague manages its controls, while Main receives
39
- bounded updates and never checks your activity itself. Each observation is
40
- delivered to Main once. Switching between the practice project's **Preview** or
41
- **Dashboard** and the graduation-cap **Learning** option, and between project panes such as
42
- **Preview**, **Dashboard → Database** and **Dashboard → Files**, is observed; a
43
- lesson without a practice project, such as Lesson 0, can be watched too. Stop
44
- removes the watch without stopping Main, the lesson or the app, and polling grants
45
- no unrelated mutation permission. For the eye dialog's controls, see
46
- [Watching a lesson step by step](learning-lesson-watch.md).
24
+ Colleague does not watch lessons. In the Learning environment your own step
25
+ actions (an answer, **Done**, or an automatic check from your App press or a
26
+ code step's **Check now**) record step results directly; see
27
+ [The Learning environment (L)](learning-environment.md).
47
28
 
48
29
  You can ask “Which projects do I have?” from any page, including AI Accounts;
49
30
  no open project is required. Colleague checks the projects available to you.