@mostra/runtime 0.10.0 → 0.12.0

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 (257) hide show
  1. package/dist/bin.js +4178 -310
  2. package/dist/bin.js.map +1 -1
  3. package/dist/index.d.ts.map +1 -1
  4. package/dist/index.js +1 -1
  5. package/dist/{instance-FExcyENK.js → instance-CBUlOmzG.js} +1892 -85
  6. package/dist/instance-CBUlOmzG.js.map +1 -0
  7. package/dist/reference/cli.md +1432 -0
  8. package/dist/reference/diagnostics.json +1579 -0
  9. package/dist/reference/errors/MOSTRA_A11Y_MINOR.md +23 -0
  10. package/dist/reference/errors/MOSTRA_A11Y_SERIOUS.md +23 -0
  11. package/dist/reference/errors/MOSTRA_ACTION_CANCELLED.md +23 -0
  12. package/dist/reference/errors/MOSTRA_ACTION_EVENT_INVALID.md +23 -0
  13. package/dist/reference/errors/MOSTRA_ACTION_EXPORT_INVALID.md +23 -0
  14. package/dist/reference/errors/MOSTRA_ACTION_INTERRUPTED.md +23 -0
  15. package/dist/reference/errors/MOSTRA_ACTION_PAUSED.md +23 -0
  16. package/dist/reference/errors/MOSTRA_ACTION_RUN_NOT_FOUND.md +23 -0
  17. package/dist/reference/errors/MOSTRA_ACTION_THREW.md +23 -0
  18. package/dist/reference/errors/MOSTRA_ACTION_TOO_LARGE.md +23 -0
  19. package/dist/reference/errors/MOSTRA_ACTION_UNKNOWN_FUNCTION.md +23 -0
  20. package/dist/reference/errors/MOSTRA_ACTION_UNSERIALIZABLE.md +23 -0
  21. package/dist/reference/errors/MOSTRA_ARTIFACT_BUNDLE_INVALID.md +23 -0
  22. package/dist/reference/errors/MOSTRA_ARTIFACT_DIR_NOT_EMPTY.md +23 -0
  23. package/dist/reference/errors/MOSTRA_ARTIFACT_ENTRY_AMBIGUOUS.md +23 -0
  24. package/dist/reference/errors/MOSTRA_ARTIFACT_ID_DROPPED.md +23 -0
  25. package/dist/reference/errors/MOSTRA_ARTIFACT_NOT_FOUND.md +23 -0
  26. package/dist/reference/errors/MOSTRA_ARTIFACT_NO_ENTRY.md +23 -0
  27. package/dist/reference/errors/MOSTRA_ARTIFACT_NO_PAGE.md +23 -0
  28. package/dist/reference/errors/MOSTRA_ARTIFACT_PATCH_REJECTED.md +23 -0
  29. package/dist/reference/errors/MOSTRA_ARTIFACT_PATH_INVALID.md +23 -0
  30. package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_MISSING.md +23 -0
  31. package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_UNREADABLE.md +23 -0
  32. package/dist/reference/errors/MOSTRA_ARTIFACT_TEMPLATE_UNKNOWN.md +23 -0
  33. package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_COLLECTED.md +23 -0
  34. package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_NOT_FOUND.md +23 -0
  35. package/dist/reference/errors/MOSTRA_BUILD_CRASHED.md +23 -0
  36. package/dist/reference/errors/MOSTRA_BUILD_FAILED.md +23 -0
  37. package/dist/reference/errors/MOSTRA_BUILD_TIMEOUT.md +23 -0
  38. package/dist/reference/errors/MOSTRA_BUILD_UNRESOLVED.md +23 -0
  39. package/dist/reference/errors/MOSTRA_CLI_CONFIG_UNWRITABLE.md +23 -0
  40. package/dist/reference/errors/MOSTRA_CLI_UNKNOWN_COMMAND.md +23 -0
  41. package/dist/reference/errors/MOSTRA_CLI_USAGE.md +23 -0
  42. package/dist/reference/errors/MOSTRA_CONSOLE_ERROR.md +23 -0
  43. package/dist/reference/errors/MOSTRA_CONSOLE_WARNING.md +23 -0
  44. package/dist/reference/errors/MOSTRA_DEP_INSTALL_FAILED.md +23 -0
  45. package/dist/reference/errors/MOSTRA_DEP_MISSING.md +23 -0
  46. package/dist/reference/errors/MOSTRA_DEP_NOT_FOUND.md +23 -0
  47. package/dist/reference/errors/MOSTRA_DEP_OFFLINE.md +23 -0
  48. package/dist/reference/errors/MOSTRA_DEP_SPEC_INVALID.md +23 -0
  49. package/dist/reference/errors/MOSTRA_DEP_TIMEOUT.md +23 -0
  50. package/dist/reference/errors/MOSTRA_DEP_WARM_CONFLICT.md +23 -0
  51. package/dist/reference/errors/MOSTRA_ENV_BIND_FAILED.md +23 -0
  52. package/dist/reference/errors/MOSTRA_ENV_BROWSER_MISSING.md +23 -0
  53. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_DOWNLOAD_FAILED.md +23 -0
  54. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_INVALID.md +23 -0
  55. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_UNAVAILABLE.md +23 -0
  56. package/dist/reference/errors/MOSTRA_ENV_HELPER_MISSING.md +23 -0
  57. package/dist/reference/errors/MOSTRA_ENV_NODE_UNSUPPORTED.md +23 -0
  58. package/dist/reference/errors/MOSTRA_ENV_PORT_TAKEN.md +23 -0
  59. package/dist/reference/errors/MOSTRA_ENV_RUNTIME_INSTALLING.md +23 -0
  60. package/dist/reference/errors/MOSTRA_ENV_RUNTIME_MISSING.md +23 -0
  61. package/dist/reference/errors/MOSTRA_ENV_SERVICE_FAILED.md +23 -0
  62. package/dist/reference/errors/MOSTRA_ENV_SHELL_MISSING.md +23 -0
  63. package/dist/reference/errors/MOSTRA_ENV_WARM_MISSING.md +23 -0
  64. package/dist/reference/errors/MOSTRA_FIELD_CONFLICT.md +23 -0
  65. package/dist/reference/errors/MOSTRA_FIELD_DUPLICATE_ID.md +23 -0
  66. package/dist/reference/errors/MOSTRA_FIELD_ID_INVALID.md +23 -0
  67. package/dist/reference/errors/MOSTRA_FIELD_ID_UNSTABLE.md +23 -0
  68. package/dist/reference/errors/MOSTRA_FIELD_MUTATION_ID_REUSED.md +23 -0
  69. package/dist/reference/errors/MOSTRA_FIELD_SHARED.md +23 -0
  70. package/dist/reference/errors/MOSTRA_FIELD_TOO_LARGE.md +23 -0
  71. package/dist/reference/errors/MOSTRA_FIELD_UNBOUND.md +23 -0
  72. package/dist/reference/errors/MOSTRA_HOME_DISK_FULL.md +23 -0
  73. package/dist/reference/errors/MOSTRA_HOME_GC_INCOMPLETE.md +23 -0
  74. package/dist/reference/errors/MOSTRA_HOME_GONE.md +23 -0
  75. package/dist/reference/errors/MOSTRA_HOME_INTEGRITY.md +23 -0
  76. package/dist/reference/errors/MOSTRA_HOME_LEDGER_UNREADABLE.md +23 -0
  77. package/dist/reference/errors/MOSTRA_HOME_LOCKED.md +23 -0
  78. package/dist/reference/errors/MOSTRA_HOME_MISMATCH.md +23 -0
  79. package/dist/reference/errors/MOSTRA_HOME_NETWORK_FILESYSTEM.md +23 -0
  80. package/dist/reference/errors/MOSTRA_HOME_NOT_ALWAYS_ON.md +23 -0
  81. package/dist/reference/errors/MOSTRA_HOME_NOT_OWNED.md +23 -0
  82. package/dist/reference/errors/MOSTRA_HOME_SOCKET_TOO_LONG.md +23 -0
  83. package/dist/reference/errors/MOSTRA_HOME_TOO_NEW.md +23 -0
  84. package/dist/reference/errors/MOSTRA_HOST_CONNECTION_CLOSED.md +23 -0
  85. package/dist/reference/errors/MOSTRA_HOST_CURSOR_COMPACTED.md +23 -0
  86. package/dist/reference/errors/MOSTRA_HOST_IDENTITY_UNAVAILABLE.md +23 -0
  87. package/dist/reference/errors/MOSTRA_HOST_INITIALIZE_ORDER.md +23 -0
  88. package/dist/reference/errors/MOSTRA_HOST_INTERNAL_ERROR.md +23 -0
  89. package/dist/reference/errors/MOSTRA_HOST_INVALID_PARAMS.md +23 -0
  90. package/dist/reference/errors/MOSTRA_HOST_MALFORMED.md +23 -0
  91. package/dist/reference/errors/MOSTRA_HOST_MESSAGE_TOO_LARGE.md +23 -0
  92. package/dist/reference/errors/MOSTRA_HOST_METHOD_UNKNOWN.md +23 -0
  93. package/dist/reference/errors/MOSTRA_HOST_NOTIFICATION_UNSUPPORTED.md +23 -0
  94. package/dist/reference/errors/MOSTRA_HOST_PORT_UNSUPPORTED.md +23 -0
  95. package/dist/reference/errors/MOSTRA_HOST_REQUEST_ID_REUSED.md +23 -0
  96. package/dist/reference/errors/MOSTRA_HOST_REVISION_UNSUPPORTED.md +23 -0
  97. package/dist/reference/errors/MOSTRA_HOST_SHUTDOWN_REFUSED.md +23 -0
  98. package/dist/reference/errors/MOSTRA_HOST_SUBSCRIPTION_UNKNOWN.md +23 -0
  99. package/dist/reference/errors/MOSTRA_HOST_TIMEOUT.md +23 -0
  100. package/dist/reference/errors/MOSTRA_HYGIENE_CONTENT_TYPE.md +23 -0
  101. package/dist/reference/errors/MOSTRA_HYGIENE_CSRF_MISSING.md +23 -0
  102. package/dist/reference/errors/MOSTRA_HYGIENE_FRAME_SESSION.md +23 -0
  103. package/dist/reference/errors/MOSTRA_HYGIENE_HEADERS_TOO_LARGE.md +23 -0
  104. package/dist/reference/errors/MOSTRA_HYGIENE_HOST_REFUSED.md +23 -0
  105. package/dist/reference/errors/MOSTRA_HYGIENE_NOT_SERVED.md +23 -0
  106. package/dist/reference/errors/MOSTRA_HYGIENE_ORIGIN_REFUSED.md +23 -0
  107. package/dist/reference/errors/MOSTRA_HYGIENE_RATE_LIMITED.md +23 -0
  108. package/dist/reference/errors/MOSTRA_HYGIENE_REQUEST_MALFORMED.md +23 -0
  109. package/dist/reference/errors/MOSTRA_HYGIENE_SCOPE_DENIED.md +23 -0
  110. package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_CONFLICT.md +23 -0
  111. package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_MISSING.md +23 -0
  112. package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_INVALID.md +23 -0
  113. package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_REVOKED.md +23 -0
  114. package/dist/reference/errors/MOSTRA_LIVE_SOURCE_FAILED.md +23 -0
  115. package/dist/reference/errors/MOSTRA_LIVE_TOO_LARGE.md +23 -0
  116. package/dist/reference/errors/MOSTRA_MANIFEST_INVALID.md +23 -0
  117. package/dist/reference/errors/MOSTRA_MANIFEST_NOT_LITERAL.md +23 -0
  118. package/dist/reference/errors/MOSTRA_MANIFEST_UNKNOWN_KEY.md +23 -0
  119. package/dist/reference/errors/MOSTRA_NETWORK_EXTERNAL_FAILED.md +23 -0
  120. package/dist/reference/errors/MOSTRA_NETWORK_REQUEST_FAILED.md +23 -0
  121. package/dist/reference/errors/MOSTRA_PLATFORM_UNSUPPORTED.md +23 -0
  122. package/dist/reference/errors/MOSTRA_PUBLISH_ID_CONFLICT.md +23 -0
  123. package/dist/reference/errors/MOSTRA_PUBLISH_SOURCE_CHANGED.md +23 -0
  124. package/dist/reference/errors/MOSTRA_PUBLISH_VERIFY_FAILED.md +23 -0
  125. package/dist/reference/errors/MOSTRA_REGRESSION_ACTION_REMOVED.md +23 -0
  126. package/dist/reference/errors/MOSTRA_REGRESSION_ARIA.md +23 -0
  127. package/dist/reference/errors/MOSTRA_REGRESSION_FIELD_REMOVED.md +23 -0
  128. package/dist/reference/errors/MOSTRA_REGRESSION_LIVE_REMOVED.md +23 -0
  129. package/dist/reference/errors/MOSTRA_REGRESSION_PAGE_REMOVED.md +23 -0
  130. package/dist/reference/errors/MOSTRA_REGRESSION_PIXELS.md +23 -0
  131. package/dist/reference/errors/MOSTRA_REMOTE_CONFIG_INVALID.md +23 -0
  132. package/dist/reference/errors/MOSTRA_REMOTE_HOME_MOVING.md +23 -0
  133. package/dist/reference/errors/MOSTRA_REMOTE_HOME_SUSPENDED.md +23 -0
  134. package/dist/reference/errors/MOSTRA_REMOTE_LIMIT_REACHED.md +23 -0
  135. package/dist/reference/errors/MOSTRA_REMOTE_LOGIN_FAILED.md +23 -0
  136. package/dist/reference/errors/MOSTRA_REMOTE_NOT_OWNER_INSTANCE.md +23 -0
  137. package/dist/reference/errors/MOSTRA_REMOTE_NO_INSTANCE.md +23 -0
  138. package/dist/reference/errors/MOSTRA_REMOTE_OPERATOR_UNAVAILABLE.md +23 -0
  139. package/dist/reference/errors/MOSTRA_REMOTE_OWNER_OFFLINE.md +23 -0
  140. package/dist/reference/errors/MOSTRA_REMOTE_PAUSED_BY_OPERATOR.md +23 -0
  141. package/dist/reference/errors/MOSTRA_REMOTE_QUEUE_FULL.md +23 -0
  142. package/dist/reference/errors/MOSTRA_REMOTE_RATE_LIMITED.md +23 -0
  143. package/dist/reference/errors/MOSTRA_REMOTE_SIGN_IN_REQUIRED.md +23 -0
  144. package/dist/reference/errors/MOSTRA_REMOTE_UNDER_REVIEW.md +23 -0
  145. package/dist/reference/errors/MOSTRA_REMOTE_UNREACHABLE.md +23 -0
  146. package/dist/reference/errors/MOSTRA_RUNTIME_BLANK.md +23 -0
  147. package/dist/reference/errors/MOSTRA_RUNTIME_NOT_READY.md +23 -0
  148. package/dist/reference/errors/MOSTRA_RUNTIME_PAGE_ERROR.md +23 -0
  149. package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_CRASHED.md +23 -0
  150. package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_PARKED.md +23 -0
  151. package/dist/reference/errors/MOSTRA_SECRET_MISSING.md +23 -0
  152. package/dist/reference/errors/MOSTRA_SHARE_NOT_ENABLED.md +23 -0
  153. package/dist/reference/errors/MOSTRA_SHARE_NOT_FOUND.md +23 -0
  154. package/dist/reference/errors/MOSTRA_SHARE_PORTS_EXHAUSTED.md +23 -0
  155. package/dist/reference/errors/MOSTRA_SHARE_TOOL_MISSING.md +23 -0
  156. package/dist/reference/errors/MOSTRA_SHARE_TOOL_NOT_READY.md +23 -0
  157. package/dist/reference/errors/MOSTRA_SHARE_TTL_INVALID.md +23 -0
  158. package/dist/reference/errors/MOSTRA_SHARE_TUNNEL_FAILED.md +23 -0
  159. package/dist/reference/errors/MOSTRA_SMOKE_BUDGET.md +23 -0
  160. package/dist/reference/errors/MOSTRA_SMOKE_NO_EFFECT.md +23 -0
  161. package/dist/reference/errors/MOSTRA_SUBMIT_ALREADY.md +23 -0
  162. package/dist/reference/errors/MOSTRA_SUBMIT_BLOCKED.md +23 -0
  163. package/dist/reference/errors/MOSTRA_SUBMIT_CHANNEL_DENIED.md +23 -0
  164. package/dist/reference/errors/MOSTRA_SUBMIT_NOT_FOUND.md +23 -0
  165. package/dist/reference/errors/MOSTRA_SUBMIT_PAUSED.md +23 -0
  166. package/dist/reference/errors/MOSTRA_SUBMIT_POLICY_NONE.md +23 -0
  167. package/dist/reference/errors/MOSTRA_SUBMIT_REVISION_MOVED.md +23 -0
  168. package/dist/reference/errors/MOSTRA_SUBMIT_SIGNAL_INVALID.md +23 -0
  169. package/dist/reference/errors/MOSTRA_SUBMIT_VIEW_INVALID.md +23 -0
  170. package/dist/reference/errors/MOSTRA_TARGET_UNAVAILABLE.md +23 -0
  171. package/dist/reference/errors/MOSTRA_TEAM_PRESENCE_RATE_LIMITED.md +23 -0
  172. package/dist/reference/errors/MOSTRA_TEAM_ROSTER_POLICY.md +23 -0
  173. package/dist/reference/errors/MOSTRA_TEAM_ROSTER_TOO_LARGE.md +23 -0
  174. package/dist/reference/errors/MOSTRA_TYPE_ERROR.md +23 -0
  175. package/dist/reference/errors/MOSTRA_TYPE_UNTYPED_PACKAGE.md +23 -0
  176. package/dist/reference/errors/MOSTRA_VERIFY_ACTION_SKIPPED.md +23 -0
  177. package/dist/reference/errors/MOSTRA_VERIFY_BASELINE_MISSING.md +23 -0
  178. package/dist/reference/errors/MOSTRA_VERIFY_CRASHED.md +23 -0
  179. package/dist/reference/errors/MOSTRA_VERIFY_LIVE_FAILED.md +23 -0
  180. package/dist/reference/errors/MOSTRA_VERIFY_NO_BASELINE.md +23 -0
  181. package/dist/reference/errors/MOSTRA_VERIFY_SECRET_MISSING.md +23 -0
  182. package/dist/reference/errors/MOSTRA_VERIFY_SKIP_CONSEQUENCE.md +23 -0
  183. package/dist/reference/errors/MOSTRA_VERIFY_TIMEOUT.md +23 -0
  184. package/dist/reference/self-hosting.md +130 -0
  185. package/dist/reference/telemetry.md +84 -0
  186. package/dist/skill/SKILL.md +124 -0
  187. package/dist/skill/assets/examples/dashboard/index.tsx +161 -0
  188. package/dist/skill/assets/examples/dashboard/live.ts +25 -0
  189. package/dist/skill/assets/examples/dashboard/styles.css +125 -0
  190. package/dist/skill/assets/examples/decision/index.tsx +95 -0
  191. package/dist/skill/assets/examples/decision/styles.css +125 -0
  192. package/dist/skill/assets/examples/inbox/actions.ts +23 -0
  193. package/dist/skill/assets/examples/inbox/index.tsx +109 -0
  194. package/dist/skill/assets/examples/inbox/styles.css +125 -0
  195. package/dist/skill/assets/studio.css +125 -0
  196. package/dist/skill/references/answers.md +219 -0
  197. package/dist/skill/references/design.md +154 -0
  198. package/dist/skill/references/libraries.md +167 -0
  199. package/dist/skill/references/long-lived.md +148 -0
  200. package/dist/skill/references/mcp.md +68 -0
  201. package/dist/skill/references/page.md +131 -0
  202. package/dist/skill/references/server.md +146 -0
  203. package/dist/skill/references/sharing.md +123 -0
  204. package/dist/skill/references/teams.md +78 -0
  205. package/dist/skill/references/verify.md +71 -0
  206. package/package.json +10 -5
  207. package/src/gateway/actions.ts +20 -0
  208. package/src/gateway/browser.ts +128 -1
  209. package/src/gateway/capabilities.ts +8 -0
  210. package/src/gateway/http.ts +12 -1
  211. package/src/gateway/index.ts +210 -6
  212. package/src/gateway/listener.ts +31 -6
  213. package/src/gateway/routes.ts +8 -0
  214. package/src/gateway/team.ts +181 -0
  215. package/src/gc/index.ts +5 -0
  216. package/src/instance/index.ts +22 -2
  217. package/src/interaction/ephemeral.ts +21 -0
  218. package/src/interaction/events.ts +17 -0
  219. package/src/interaction/index.ts +325 -20
  220. package/src/interaction/pause.ts +106 -0
  221. package/src/interaction/roster.ts +585 -0
  222. package/src/interaction/submissions.ts +42 -1
  223. package/src/interaction/team.ts +426 -0
  224. package/src/interaction/viewers.ts +34 -1
  225. package/src/interaction/wait.ts +150 -0
  226. package/src/ledger/index.ts +20 -1
  227. package/src/ledger/migrations.ts +86 -0
  228. package/src/link/author.ts +215 -0
  229. package/src/link/hosted.ts +51 -4
  230. package/src/link/http.ts +6 -1
  231. package/src/link/index.ts +3 -1
  232. package/src/link/manager.ts +169 -35
  233. package/src/protocol-server/client.ts +53 -0
  234. package/src/protocol-server/index.ts +1 -1
  235. package/src/server/api.ts +514 -72
  236. package/src/server/auth.ts +600 -74
  237. package/src/server/authorize.ts +816 -0
  238. package/src/server/clients.ts +235 -0
  239. package/src/server/config.ts +7 -0
  240. package/src/server/data.ts +59 -1
  241. package/src/server/directory.ts +91 -0
  242. package/src/server/feed.ts +277 -0
  243. package/src/server/handle.ts +172 -0
  244. package/src/server/hosted-pages.ts +532 -0
  245. package/src/server/hosted.ts +551 -18
  246. package/src/server/index.ts +353 -61
  247. package/src/server/mcp.ts +330 -0
  248. package/src/server/metering.ts +156 -0
  249. package/src/server/oauth-clients.ts +510 -0
  250. package/src/server/operator.ts +557 -0
  251. package/src/server/providers.ts +284 -0
  252. package/src/server/remove.ts +148 -0
  253. package/src/server/routing.ts +275 -0
  254. package/src/share/index.ts +50 -2
  255. package/src/verify/index.ts +7 -0
  256. package/src/verify/runner.ts +27 -2
  257. package/dist/instance-FExcyENK.js.map +0 -1
@@ -0,0 +1,1432 @@
1
+ # The mostra CLI
2
+
3
+ <!-- Generated from the command definitions in packages/cli/src/commands/. Don't edit; run `pnpm fix`. -->
4
+
5
+ Every command takes `--json`, which prints one envelope on stdout: `{ "ok": true, "result", "instance", "warnings" }` or `{ "ok": false, "error", "warnings" }`. Streaming commands print one envelope per line, the last one carrying `result` or `error`. Logs and progress go to stderr. Without a terminal, or with `--json`, no command asks a question.
6
+
7
+ Commands: `add`, `daemon`, `dev`, `docs`, `doctor`, `export`, `gc`, `host`, `list`, `login`, `logout`, `mcp`, `new`, `open`, `pause`, `publish`, `push`, `results`, `resume`, `roster`, `run`, `secret`, `share`, `state`, `status`, `telemetry`, `verify`, `wait`.
8
+
9
+ ## mostra new
10
+
11
+ ```text
12
+ Create an artifact in an empty directory, with a generated ID.
13
+
14
+ Usage:
15
+ mostra new <dir> [flags]
16
+
17
+ Arguments:
18
+ <dir> The directory to create it in; it must be empty or not exist.
19
+
20
+ Flags:
21
+ --title <text> The artifact's title. Default: the directory's name.
22
+ --template <family> Start from a template (templates arrive in a later release).
23
+ --request-id <id> Make a retry return the first attempt's result.
24
+
25
+ Global flags:
26
+ --json Print one JSON envelope on stdout (NDJSON for streams).
27
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
28
+ --cwd <dir> Resolve relative paths from this directory.
29
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
30
+ --help Show this command's help; with --json, its definition.
31
+
32
+ Output: ArtifactCreateResult (mostra docs cli)
33
+
34
+ Exit codes:
35
+ 0 success
36
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
37
+ 2 usage error
38
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
39
+ 4 timeout (--timeout passed)
40
+
41
+ Example:
42
+ mostra new ./sidebar-review --title 'Sidebar review'
43
+ ```
44
+
45
+ ## mostra dev
46
+
47
+ ```text
48
+ Preview an artifact's unpublished source with hot reload, until Ctrl-C; viewers never see it.
49
+
50
+ Usage:
51
+ mostra dev <path> [flags]
52
+
53
+ Arguments:
54
+ <path> The artifact's source: a file, a directory, or its ID.
55
+
56
+ Flags:
57
+ --port <port> The preview's port on 127.0.0.1; default one the system picks.
58
+
59
+ Global flags:
60
+ --json Print one JSON envelope on stdout (NDJSON for streams).
61
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
62
+ --cwd <dir> Resolve relative paths from this directory.
63
+ --help Show this command's help; with --json, its definition.
64
+
65
+ Output: DevStartResult (mostra docs cli)
66
+
67
+ Exit codes:
68
+ 0 success
69
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
70
+ 2 usage error
71
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
72
+
73
+ Example:
74
+ mostra dev ./sidebar-review
75
+ ```
76
+
77
+ ## mostra verify
78
+
79
+ ```text
80
+ Build, render and check an artifact's source; one verdict, nothing published.
81
+
82
+ Usage:
83
+ mostra verify <path> [flags]
84
+
85
+ Arguments:
86
+ <path> The artifact's source: a file, a directory, or its ID.
87
+
88
+ Flags:
89
+ --screenshots <when> Which screenshots the verdict marks as worth looking at. (on-failure, always, never) Default: on-failure.
90
+
91
+ Global flags:
92
+ --json Print one JSON envelope on stdout (NDJSON for streams).
93
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
94
+ --cwd <dir> Resolve relative paths from this directory.
95
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
96
+ --help Show this command's help; with --json, its definition.
97
+
98
+ Output: VerifyVerdict (mostra docs cli)
99
+
100
+ Exit codes:
101
+ 0 success
102
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
103
+ 2 usage error
104
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
105
+ 4 timeout (--timeout passed)
106
+
107
+ Example:
108
+ mostra verify ./sidebar-review
109
+ ```
110
+
111
+ ## mostra publish
112
+
113
+ ```text
114
+ Publish an artifact's source as a new immutable version, gated by verify, and print its link.
115
+
116
+ Usage:
117
+ mostra publish <path> [flags]
118
+
119
+ Arguments:
120
+ <path> The artifact's source: a file, a directory, or its ID.
121
+
122
+ Flags:
123
+ --force Publish despite verify's errors and record their codes; never what didn't build.
124
+ --policy <policy> The submission policy to use, instead of the manifest's. (once, once-per-viewer, epochs, none)
125
+ --request-id <id> Make a retry return the first attempt's receipt.
126
+
127
+ Global flags:
128
+ --json Print one JSON envelope on stdout (NDJSON for streams).
129
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
130
+ --cwd <dir> Resolve relative paths from this directory.
131
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
132
+ --help Show this command's help; with --json, its definition.
133
+
134
+ Output: PublishReceipt (mostra docs cli)
135
+
136
+ Exit codes:
137
+ 0 success
138
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
139
+ 2 usage error
140
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
141
+ 4 timeout (--timeout passed)
142
+ 6 conflict (already submitted, a compare-and-set mismatch, a reused request ID)
143
+
144
+ Example:
145
+ mostra publish ./sidebar-review
146
+ ```
147
+
148
+ ## mostra open
149
+
150
+ ```text
151
+ Print an artifact's capability link and open it in a browser; or mint, rotate or revoke a link.
152
+
153
+ Usage:
154
+ mostra open <artifact> [flags]
155
+
156
+ Arguments:
157
+ <artifact> The artifact: its source path or its ID.
158
+
159
+ Flags:
160
+ --new Mint a separate link instead of the artifact's default one.
161
+ --version <n|id> A new link that opens only this version.
162
+ --scope <a,b> A new link's scopes: view, draft, submit, review, signal, action:*. Default: all.
163
+ --ttl <d> A new link that expires after this long, such as 24h.
164
+ --viewer <ref> A new link that acts for this person, by your own stable key for them.
165
+ --viewer-name <name> The display name of --viewer.
166
+ --rotate <tokenId> Replace this link with a new one; the old one stops working.
167
+ --revoke <tokenId> Stop this link from working.
168
+ --browser Open a browser even without a terminal.
169
+ --no-browser Only print the link.
170
+ --request-id <id> Make a retried --new return the same link.
171
+
172
+ Global flags:
173
+ --json Print one JSON envelope on stdout (NDJSON for streams).
174
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
175
+ --cwd <dir> Resolve relative paths from this directory.
176
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
177
+ --help Show this command's help; with --json, its definition.
178
+
179
+ Output: CapabilityLink (mostra docs cli)
180
+
181
+ Exit codes:
182
+ 0 success
183
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
184
+ 2 usage error
185
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
186
+ 4 timeout (--timeout passed)
187
+
188
+ Example:
189
+ mostra open ./sidebar-review
190
+ ```
191
+
192
+ ## mostra share
193
+
194
+ ```text
195
+ Open an artifact to people beyond this machine: inside your tailnet, publicly with a link that expires, or hosted on a server.
196
+
197
+ Usage:
198
+ mostra share <artifact> [<server>] [flags]
199
+
200
+ Arguments:
201
+ <artifact> The artifact: its source path or its ID.
202
+ <server> With --cloud: the server's address. Default: the server signed in to last.
203
+
204
+ Flags:
205
+ --cloud Host it on a remote server you signed in to with mostra login: the link keeps working while this machine sleeps.
206
+ --tailnet Share inside your tailnet through Tailscale Serve; each viewer is their tailnet identity.
207
+ --public Share publicly: anyone with the link can open it until it expires.
208
+ --via <tunnel> The public tunnel: a Cloudflare quick tunnel (no account), or Tailscale Funnel (shows your device's tailnet name). (cloudflare, funnel) Default: cloudflare.
209
+ --ttl <d> How long the link works, such as 30m or 24h. Public: 1h by default, 7d at most.
210
+ --scope <a,b> The link's scopes: view, draft, submit, review, signal, action:*. Default: all.
211
+ --viewer <ref> The person the link is for, by your own stable key for them; without it, each link is a viewer of its own.
212
+ --viewer-name <name> The display name of --viewer.
213
+ --respondent <ref,…> With --cloud, the people you expect answers from, by your own key for each: each gets a personal link (mostra roster).
214
+ --request-id <id> Make a retried share return the same share instead of opening another.
215
+
216
+ Global flags:
217
+ --json Print one JSON envelope on stdout (NDJSON for streams).
218
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
219
+ --cwd <dir> Resolve relative paths from this directory.
220
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
221
+ --help Show this command's help; with --json, its definition.
222
+
223
+ Output: ShareStartResult (mostra docs cli)
224
+
225
+ Exit codes:
226
+ 0 success
227
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
228
+ 2 usage error
229
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
230
+ 4 timeout (--timeout passed)
231
+
232
+ Example:
233
+ mostra share ./sidebar-review --cloud
234
+ ```
235
+
236
+ ## mostra share stop
237
+
238
+ ```text
239
+ Stop a share, or every share of an artifact: its link stops working and its tunnel closes.
240
+
241
+ Usage:
242
+ mostra share stop <target>
243
+
244
+ Arguments:
245
+ <target> A share's ID (shr_…), or an artifact's source path or ID.
246
+
247
+ Global flags:
248
+ --json Print one JSON envelope on stdout (NDJSON for streams).
249
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
250
+ --cwd <dir> Resolve relative paths from this directory.
251
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
252
+ --help Show this command's help; with --json, its definition.
253
+
254
+ Output: ShareStopResult (mostra docs cli)
255
+
256
+ Exit codes:
257
+ 0 success
258
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
259
+ 2 usage error
260
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
261
+ 4 timeout (--timeout passed)
262
+
263
+ Example:
264
+ mostra share stop ./sidebar-review
265
+ ```
266
+
267
+ ## mostra share list
268
+
269
+ ```text
270
+ List the active shares, of every artifact or of one; --all adds the ones that ended.
271
+
272
+ Usage:
273
+ mostra share list [<artifact>] [flags]
274
+
275
+ Arguments:
276
+ <artifact> Only this artifact's shares: its source path or ID.
277
+
278
+ Flags:
279
+ --all Also list shares that ended, and why.
280
+
281
+ Global flags:
282
+ --json Print one JSON envelope on stdout (NDJSON for streams).
283
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
284
+ --cwd <dir> Resolve relative paths from this directory.
285
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
286
+ --help Show this command's help; with --json, its definition.
287
+
288
+ Output: ShareListResult (mostra docs cli)
289
+
290
+ Exit codes:
291
+ 0 success
292
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
293
+ 2 usage error
294
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
295
+ 4 timeout (--timeout passed)
296
+
297
+ Example:
298
+ mostra share list --all
299
+ ```
300
+
301
+ ## mostra login
302
+
303
+ ```text
304
+ Sign this machine's Mostra in to a remote server, so mostra share --cloud can host pages there.
305
+
306
+ Usage:
307
+ mostra login [<server>] [flags]
308
+
309
+ Arguments:
310
+ <server> The server's address, such as https://api.example.com. Default: the server signed in to last.
311
+
312
+ Flags:
313
+ --default Make this machine the account's default, the one chat apps create pages on. Default: the first machine linked.
314
+ --key-file <string> Link with a key the server's operator issued for an account, read from this file, instead of a person's sign-in (for an always-on machine).
315
+
316
+ Global flags:
317
+ --json Print one JSON envelope on stdout (NDJSON for streams).
318
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
319
+ --cwd <dir> Resolve relative paths from this directory.
320
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
321
+ --help Show this command's help; with --json, its definition.
322
+
323
+ Output: RemoteLoginWaitResult (mostra docs cli)
324
+
325
+ Exit codes:
326
+ 0 success
327
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
328
+ 2 usage error
329
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
330
+ 4 timeout (--timeout passed)
331
+
332
+ Example:
333
+ mostra login https://api.example.com
334
+ ```
335
+
336
+ ## mostra logout
337
+
338
+ ```text
339
+ Sign this machine's Mostra out of a remote server; its hosted pages keep working, and their answers wait for the next sign-in.
340
+
341
+ Usage:
342
+ mostra logout [<server>] [flags]
343
+
344
+ Arguments:
345
+ <server> The server's address. Default: the server signed in to last.
346
+
347
+ Flags:
348
+ --forget Also forget this machine's link to the server: the pages it shared there are no longer its own.
349
+
350
+ Global flags:
351
+ --json Print one JSON envelope on stdout (NDJSON for streams).
352
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
353
+ --cwd <dir> Resolve relative paths from this directory.
354
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
355
+ --help Show this command's help; with --json, its definition.
356
+
357
+ Output: RemoteLogoutResult (mostra docs cli)
358
+
359
+ Exit codes:
360
+ 0 success
361
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
362
+ 2 usage error
363
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
364
+ 4 timeout (--timeout passed)
365
+
366
+ Example:
367
+ mostra logout
368
+ ```
369
+
370
+ ## mostra pause
371
+
372
+ ```text
373
+ Pause an artifact: its pages stay viewable and its links valid, but it takes no answers and runs no actions until resumed.
374
+
375
+ Usage:
376
+ mostra pause <artifact> [flags]
377
+
378
+ Arguments:
379
+ <artifact> The artifact: its source path or its ID.
380
+
381
+ Flags:
382
+ --reason <string> Why, shown to the page's viewers beside the paused notice.
383
+
384
+ Global flags:
385
+ --json Print one JSON envelope on stdout (NDJSON for streams).
386
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
387
+ --cwd <dir> Resolve relative paths from this directory.
388
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
389
+ --help Show this command's help; with --json, its definition.
390
+
391
+ Output: ArtifactPauseResult (mostra docs cli)
392
+
393
+ Exit codes:
394
+ 0 success
395
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
396
+ 2 usage error
397
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
398
+ 4 timeout (--timeout passed)
399
+
400
+ Example:
401
+ mostra pause ./survey --reason "Closed for review until Monday"
402
+ ```
403
+
404
+ ## mostra resume
405
+
406
+ ```text
407
+ Resume a paused artifact: it takes answers and runs actions again.
408
+
409
+ Usage:
410
+ mostra resume <artifact>
411
+
412
+ Arguments:
413
+ <artifact> The artifact: its source path or its ID.
414
+
415
+ Global flags:
416
+ --json Print one JSON envelope on stdout (NDJSON for streams).
417
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
418
+ --cwd <dir> Resolve relative paths from this directory.
419
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
420
+ --help Show this command's help; with --json, its definition.
421
+
422
+ Output: ArtifactPauseResult (mostra docs cli)
423
+
424
+ Exit codes:
425
+ 0 success
426
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
427
+ 2 usage error
428
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
429
+ 4 timeout (--timeout passed)
430
+
431
+ Example:
432
+ mostra resume ./survey
433
+ ```
434
+
435
+ ## mostra roster add
436
+
437
+ ```text
438
+ Name the people an artifact expects answers from; each gets a personal link that acts as them.
439
+
440
+ Usage:
441
+ mostra roster add <artifact> [<ref…>] [flags]
442
+
443
+ Arguments:
444
+ <artifact> The artifact: its source path or its ID.
445
+ <ref> Each respondent, by your own stable key for them (an email, an account ID).
446
+
447
+ Flags:
448
+ --name <name> The display name of the one respondent given.
449
+ --email <address> Where a remote server that sends invitations writes to the one respondent given.
450
+ --file <path> Read respondents from a JSON file: [{ ref, name?, email? }].
451
+ --stdin Read respondents as JSON from stdin.
452
+ --scope <a,b> The personal links' scopes: view, draft, submit, review, signal, action:*. Default: all.
453
+ --ttl <d> How long the personal links work, such as 7d. Default: no limit.
454
+ --request-id <id> Make a retry return the first attempt's links.
455
+
456
+ Global flags:
457
+ --json Print one JSON envelope on stdout (NDJSON for streams).
458
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
459
+ --cwd <dir> Resolve relative paths from this directory.
460
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
461
+ --help Show this command's help; with --json, its definition.
462
+
463
+ Output: RosterAddResult (mostra docs cli)
464
+
465
+ Exit codes:
466
+ 0 success
467
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
468
+ 2 usage error
469
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
470
+ 4 timeout (--timeout passed)
471
+
472
+ Example:
473
+ mostra roster add ./retro ada@example.com grace@example.com
474
+ ```
475
+
476
+ ## mostra roster get
477
+
478
+ ```text
479
+ Show who an artifact expects answers from and where each stands: not opened, drafting or submitted.
480
+
481
+ Usage:
482
+ mostra roster get <artifact>
483
+
484
+ Arguments:
485
+ <artifact> The artifact: its source path or its ID.
486
+
487
+ Global flags:
488
+ --json Print one JSON envelope on stdout (NDJSON for streams).
489
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
490
+ --cwd <dir> Resolve relative paths from this directory.
491
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
492
+ --help Show this command's help; with --json, its definition.
493
+
494
+ Output: Roster (mostra docs cli)
495
+
496
+ Exit codes:
497
+ 0 success
498
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
499
+ 2 usage error
500
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
501
+ 4 timeout (--timeout passed)
502
+
503
+ Example:
504
+ mostra roster get ./retro
505
+ ```
506
+
507
+ ## mostra roster remove
508
+
509
+ ```text
510
+ Stop expecting answers from respondents; their links, drafts and submissions stay as they are.
511
+
512
+ Usage:
513
+ mostra roster remove <artifact> <ref…> [flags]
514
+
515
+ Arguments:
516
+ <artifact> The artifact: its source path or its ID.
517
+ <ref> Each respondent to remove, by their ref.
518
+
519
+ Flags:
520
+ --request-id <id> Make a retry return the first attempt's result.
521
+
522
+ Global flags:
523
+ --json Print one JSON envelope on stdout (NDJSON for streams).
524
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
525
+ --cwd <dir> Resolve relative paths from this directory.
526
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
527
+ --help Show this command's help; with --json, its definition.
528
+
529
+ Output: RosterRemoveResult (mostra docs cli)
530
+
531
+ Exit codes:
532
+ 0 success
533
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
534
+ 2 usage error
535
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
536
+ 4 timeout (--timeout passed)
537
+
538
+ Example:
539
+ mostra roster remove ./retro grace@example.com
540
+ ```
541
+
542
+ ## mostra wait
543
+
544
+ ```text
545
+ Block until an artifact's submission, signal, state change or event; still_waiting on timeout.
546
+
547
+ Usage:
548
+ mostra wait <artifact> [flags]
549
+
550
+ Arguments:
551
+ <artifact> The artifact: its source path or its ID.
552
+
553
+ Flags:
554
+ --until <condition> submitted, submitted:all (every expected respondent), submitted:<N>, signal:<name>, state:<fieldId> or event:<type>.
555
+ --after <cursor> Wait for what comes after this cursor. Default: the latest publish.
556
+ --timeout <d> Stop waiting after this long, with still_waiting and exit 5. Default: no limit.
557
+
558
+ Global flags:
559
+ --json Print one JSON envelope on stdout (NDJSON for streams).
560
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
561
+ --cwd <dir> Resolve relative paths from this directory.
562
+ --help Show this command's help; with --json, its definition.
563
+
564
+ Output: WaitResult (mostra docs cli)
565
+
566
+ Exit codes:
567
+ 0 success
568
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
569
+ 2 usage error
570
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
571
+ 5 still waiting (the wait timed out; the result says where to resume)
572
+
573
+ Example:
574
+ mostra wait ./sidebar-review --until submitted --timeout 30m
575
+ ```
576
+
577
+ ## mostra results
578
+
579
+ ```text
580
+ Print an artifact's submission in full: answers, state, choices, comments, actions and signals.
581
+
582
+ Usage:
583
+ mostra results <artifact> [flags]
584
+
585
+ Arguments:
586
+ <artifact> The artifact: its source path or its ID.
587
+
588
+ Flags:
589
+ --submission <id> This submission instead of the latest.
590
+ --all Every submission, oldest first (a survey's, a team's), instead of the latest.
591
+ --after <cursor> With --all, only submissions after this cursor.
592
+ --format <format> Markdown or JSON. Default: Markdown, or JSON with --json. (md, json)
593
+
594
+ Global flags:
595
+ --json Print one JSON envelope on stdout (NDJSON for streams).
596
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
597
+ --cwd <dir> Resolve relative paths from this directory.
598
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
599
+ --help Show this command's help; with --json, its definition.
600
+
601
+ Output: Results (mostra docs cli)
602
+
603
+ Exit codes:
604
+ 0 success
605
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
606
+ 2 usage error
607
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
608
+ 4 timeout (--timeout passed)
609
+
610
+ Example:
611
+ mostra results ./sidebar-review
612
+ ```
613
+
614
+ ## mostra state get
615
+
616
+ ```text
617
+ Read an artifact's state: the fields every viewer shares, with their revisions.
618
+
619
+ Usage:
620
+ mostra state get <artifact> [<id…>]
621
+
622
+ Arguments:
623
+ <artifact> The artifact: its source path or its ID.
624
+ <id> Only these field IDs.
625
+
626
+ Global flags:
627
+ --json Print one JSON envelope on stdout (NDJSON for streams).
628
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
629
+ --cwd <dir> Resolve relative paths from this directory.
630
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
631
+ --help Show this command's help; with --json, its definition.
632
+
633
+ Output: StateGetResult (mostra docs cli)
634
+
635
+ Exit codes:
636
+ 0 success
637
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
638
+ 2 usage error
639
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
640
+ 4 timeout (--timeout passed)
641
+
642
+ Example:
643
+ mostra state get ./tasks priorities
644
+ ```
645
+
646
+ ## mostra state set
647
+
648
+ ```text
649
+ Set one field of an artifact's state; viewers see it at once.
650
+
651
+ Usage:
652
+ mostra state set <artifact> <id> <value> [flags]
653
+
654
+ Arguments:
655
+ <artifact> The artifact: its source path or its ID.
656
+ <id> The field ID.
657
+ <value> The value, as JSON.
658
+
659
+ Flags:
660
+ --base <revision> Write only if the fields are unchanged since this revision; else a conflict (exit 6).
661
+ --as <actor> Who the change is attributed to. (agent, host) Default: agent.
662
+ --mutation-id <mut_…> Make a retry return the first attempt's result.
663
+
664
+ Global flags:
665
+ --json Print one JSON envelope on stdout (NDJSON for streams).
666
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
667
+ --cwd <dir> Resolve relative paths from this directory.
668
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
669
+ --help Show this command's help; with --json, its definition.
670
+
671
+ Output: StatePatchResult (mostra docs cli)
672
+
673
+ Exit codes:
674
+ 0 success
675
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
676
+ 2 usage error
677
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
678
+ 4 timeout (--timeout passed)
679
+ 6 conflict (already submitted, a compare-and-set mismatch, a reused request ID)
680
+
681
+ Example:
682
+ mostra state set ./tasks priorities '["Ship the CLI"]'
683
+ ```
684
+
685
+ ## mostra state patch
686
+
687
+ ```text
688
+ Change several fields of an artifact's state in one revision: [{ id, value } | { id, delete: true }].
689
+
690
+ Usage:
691
+ mostra state patch <artifact> [flags]
692
+
693
+ Arguments:
694
+ <artifact> The artifact: its source path or its ID.
695
+
696
+ Flags:
697
+ --ops <json> The operations, as JSON.
698
+ --file <path> Read the operations from a JSON file.
699
+ --stdin Read the operations from stdin.
700
+ --base <revision> Write only if the fields are unchanged since this revision; else a conflict (exit 6).
701
+ --as <actor> Who the change is attributed to. (agent, host) Default: agent.
702
+ --mutation-id <mut_…> Make a retry return the first attempt's result.
703
+
704
+ Global flags:
705
+ --json Print one JSON envelope on stdout (NDJSON for streams).
706
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
707
+ --cwd <dir> Resolve relative paths from this directory.
708
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
709
+ --help Show this command's help; with --json, its definition.
710
+
711
+ Output: StatePatchResult (mostra docs cli)
712
+
713
+ Exit codes:
714
+ 0 success
715
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
716
+ 2 usage error
717
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
718
+ 4 timeout (--timeout passed)
719
+ 6 conflict (already submitted, a compare-and-set mismatch, a reused request ID)
720
+
721
+ Example:
722
+ mostra state patch ./tasks --file ops.json
723
+ ```
724
+
725
+ ## mostra push
726
+
727
+ ```text
728
+ Push a value into an artifact's live source; pages showing it update at once.
729
+
730
+ Usage:
731
+ mostra push <artifact> <key> [flags]
732
+
733
+ Arguments:
734
+ <artifact> The artifact: its source path or its ID.
735
+ <key> The live source's key: its export name in live.ts, or a new one.
736
+
737
+ Flags:
738
+ --value <json> The value, as JSON.
739
+ --file <path> Read the value from a JSON file.
740
+ --stdin Read the value from stdin.
741
+ --append Add the value to the source's ring instead of replacing it.
742
+ --request-id <id> Make a retry return the first attempt's revision.
743
+
744
+ Global flags:
745
+ --json Print one JSON envelope on stdout (NDJSON for streams).
746
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
747
+ --cwd <dir> Resolve relative paths from this directory.
748
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
749
+ --help Show this command's help; with --json, its definition.
750
+
751
+ Output: LivePushResult (mostra docs cli)
752
+
753
+ Exit codes:
754
+ 0 success
755
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
756
+ 2 usage error
757
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
758
+ 4 timeout (--timeout passed)
759
+
760
+ Example:
761
+ mostra push ./dashboard prices --value '{"btc": 64000}'
762
+ ```
763
+
764
+ ## mostra add
765
+
766
+ ```text
767
+ Add npm packages to an artifact's lockfile at exact versions, installing them into the home's store.
768
+
769
+ Usage:
770
+ mostra add <package…> [flags]
771
+
772
+ Arguments:
773
+ <package> npm specs: name, name@version, name@range or name@tag.
774
+
775
+ Flags:
776
+ --artifact <path|id> The artifact. Default: the one in the current directory.
777
+ --request-id <id> Make a retry return the first attempt's result.
778
+
779
+ Global flags:
780
+ --json Print one JSON envelope on stdout (NDJSON for streams).
781
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
782
+ --cwd <dir> Resolve relative paths from this directory.
783
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
784
+ --help Show this command's help; with --json, its definition.
785
+
786
+ Output: DepsAddResult (mostra docs cli)
787
+
788
+ Exit codes:
789
+ 0 success
790
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
791
+ 2 usage error
792
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
793
+ 4 timeout (--timeout passed)
794
+
795
+ Example:
796
+ mostra add recharts@3 --artifact ./dashboard
797
+ ```
798
+
799
+ ## mostra export
800
+
801
+ ```text
802
+ Write a published version out of the home, as a portable bundle another home can run.
803
+
804
+ Usage:
805
+ mostra export <artifact> [flags]
806
+
807
+ Arguments:
808
+ <artifact> The artifact: its source path or its ID.
809
+
810
+ Flags:
811
+ --as <class> What to write: `bundle`, the version's builds, manifest, lockfile and source. (bundle) Default: bundle.
812
+ --out <path> Where: a new directory, or one archive when it ends in .tar.zst.
813
+ --version <number|id> The version. Default: the latest.
814
+
815
+ Global flags:
816
+ --json Print one JSON envelope on stdout (NDJSON for streams).
817
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
818
+ --cwd <dir> Resolve relative paths from this directory.
819
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
820
+ --help Show this command's help; with --json, its definition.
821
+
822
+ Output: ArtifactExportResult (mostra docs cli)
823
+
824
+ Exit codes:
825
+ 0 success
826
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
827
+ 2 usage error
828
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
829
+ 4 timeout (--timeout passed)
830
+
831
+ Example:
832
+ mostra export ./sidebar-review --out ./sidebar-review.tar.zst
833
+ ```
834
+
835
+ ## mostra run
836
+
837
+ ```text
838
+ Make a bundle `mostra export` wrote a version of this home, with the same IDs, and print its link.
839
+
840
+ Usage:
841
+ mostra run <bundle> [flags]
842
+
843
+ Arguments:
844
+ <bundle> The bundle: its directory or its .tar.zst archive.
845
+
846
+ Flags:
847
+ --request-id <id> Make a retry return the first attempt's receipt.
848
+
849
+ Global flags:
850
+ --json Print one JSON envelope on stdout (NDJSON for streams).
851
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
852
+ --cwd <dir> Resolve relative paths from this directory.
853
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
854
+ --help Show this command's help; with --json, its definition.
855
+
856
+ Output: PublishReceipt (mostra docs cli)
857
+
858
+ Exit codes:
859
+ 0 success
860
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
861
+ 2 usage error
862
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
863
+ 4 timeout (--timeout passed)
864
+
865
+ Example:
866
+ mostra run ./sidebar-review.tar.zst
867
+ ```
868
+
869
+ ## mostra secret set
870
+
871
+ ```text
872
+ Store a secret that server code reads with secret(name); the value comes from stdin and is never shown.
873
+
874
+ Usage:
875
+ mostra secret set <name> [flags]
876
+
877
+ Arguments:
878
+ <name> Letters, digits, _, . and -, starting with a letter or _.
879
+
880
+ Flags:
881
+ --artifact <path|id> The artifact's own secret, instead of one the whole home shares.
882
+
883
+ Global flags:
884
+ --json Print one JSON envelope on stdout (NDJSON for streams).
885
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
886
+ --cwd <dir> Resolve relative paths from this directory.
887
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
888
+ --help Show this command's help; with --json, its definition.
889
+
890
+ Output: SecretEntry (mostra docs cli)
891
+
892
+ Exit codes:
893
+ 0 success
894
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
895
+ 2 usage error
896
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
897
+ 4 timeout (--timeout passed)
898
+
899
+ Example:
900
+ mostra secret set MAIL_TOKEN --artifact ./inbox < token.txt
901
+ ```
902
+
903
+ ## mostra secret list
904
+
905
+ ```text
906
+ List the secrets' names and scopes; values are never shown.
907
+
908
+ Usage:
909
+ mostra secret list [flags]
910
+
911
+ Flags:
912
+ --artifact <path|id> The artifact's own secret, instead of one the whole home shares.
913
+
914
+ Global flags:
915
+ --json Print one JSON envelope on stdout (NDJSON for streams).
916
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
917
+ --cwd <dir> Resolve relative paths from this directory.
918
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
919
+ --help Show this command's help; with --json, its definition.
920
+
921
+ Output: SecretListResult (mostra docs cli)
922
+
923
+ Exit codes:
924
+ 0 success
925
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
926
+ 2 usage error
927
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
928
+ 4 timeout (--timeout passed)
929
+
930
+ Example:
931
+ mostra secret list --artifact ./inbox
932
+ ```
933
+
934
+ ## mostra secret rm
935
+
936
+ ```text
937
+ Delete a secret.
938
+
939
+ Usage:
940
+ mostra secret rm <name> [flags]
941
+
942
+ Arguments:
943
+ <name> The secret's name.
944
+
945
+ Flags:
946
+ --artifact <path|id> The artifact's own secret, instead of one the whole home shares.
947
+
948
+ Global flags:
949
+ --json Print one JSON envelope on stdout (NDJSON for streams).
950
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
951
+ --cwd <dir> Resolve relative paths from this directory.
952
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
953
+ --help Show this command's help; with --json, its definition.
954
+
955
+ Output: SecretDeleteResult (mostra docs cli)
956
+
957
+ Exit codes:
958
+ 0 success
959
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
960
+ 2 usage error
961
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
962
+ 4 timeout (--timeout passed)
963
+
964
+ Example:
965
+ mostra secret rm MAIL_TOKEN --artifact ./inbox
966
+ ```
967
+
968
+ ## mostra list
969
+
970
+ ```text
971
+ List the home's published artifacts.
972
+
973
+ Usage:
974
+ mostra list [flags]
975
+
976
+ Flags:
977
+ --family <family> Only artifacts of this family.
978
+
979
+ Global flags:
980
+ --json Print one JSON envelope on stdout (NDJSON for streams).
981
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
982
+ --cwd <dir> Resolve relative paths from this directory.
983
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
984
+ --help Show this command's help; with --json, its definition.
985
+
986
+ Output: ArtifactListResult (mostra docs cli)
987
+
988
+ Exit codes:
989
+ 0 success
990
+ 2 usage error
991
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
992
+ 4 timeout (--timeout passed)
993
+
994
+ Example:
995
+ mostra list --family dashboard
996
+ ```
997
+
998
+ ## mostra status
999
+
1000
+ ```text
1001
+ Show the instance (processes, workers, deliveries) or one artifact (versions, policy, links).
1002
+
1003
+ Usage:
1004
+ mostra status [<artifact>]
1005
+
1006
+ Arguments:
1007
+ <artifact> An artifact: its source path or its ID.
1008
+
1009
+ Global flags:
1010
+ --json Print one JSON envelope on stdout (NDJSON for streams).
1011
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
1012
+ --cwd <dir> Resolve relative paths from this directory.
1013
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
1014
+ --help Show this command's help; with --json, its definition.
1015
+
1016
+ Output: InstanceStatusResult or ArtifactDetail (mostra docs cli)
1017
+
1018
+ Exit codes:
1019
+ 0 success
1020
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
1021
+ 2 usage error
1022
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
1023
+ 4 timeout (--timeout passed)
1024
+
1025
+ Example:
1026
+ mostra status ./sidebar-review
1027
+ ```
1028
+
1029
+ ## mostra daemon start
1030
+
1031
+ ```text
1032
+ Start the home's daemon, or find the one already running.
1033
+
1034
+ Usage:
1035
+ mostra daemon start
1036
+
1037
+ Global flags:
1038
+ --json Print one JSON envelope on stdout (NDJSON for streams).
1039
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
1040
+ --cwd <dir> Resolve relative paths from this directory.
1041
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
1042
+ --help Show this command's help; with --json, its definition.
1043
+
1044
+ Output: DaemonStatus (mostra docs cli)
1045
+
1046
+ Exit codes:
1047
+ 0 success
1048
+ 2 usage error
1049
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
1050
+ 4 timeout (--timeout passed)
1051
+
1052
+ Example:
1053
+ mostra daemon start
1054
+ ```
1055
+
1056
+ ## mostra daemon stop
1057
+
1058
+ ```text
1059
+ Stop the home's daemon; open pages reconnect when it starts again.
1060
+
1061
+ Usage:
1062
+ mostra daemon stop
1063
+
1064
+ Global flags:
1065
+ --json Print one JSON envelope on stdout (NDJSON for streams).
1066
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
1067
+ --cwd <dir> Resolve relative paths from this directory.
1068
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
1069
+ --help Show this command's help; with --json, its definition.
1070
+
1071
+ Output: DaemonStop (mostra docs cli)
1072
+
1073
+ Exit codes:
1074
+ 0 success
1075
+ 2 usage error
1076
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
1077
+ 4 timeout (--timeout passed)
1078
+
1079
+ Example:
1080
+ mostra daemon stop
1081
+ ```
1082
+
1083
+ ## mostra daemon restart
1084
+
1085
+ ```text
1086
+ Stop the home's daemon and start it again, for instance after an update.
1087
+
1088
+ Usage:
1089
+ mostra daemon restart
1090
+
1091
+ Global flags:
1092
+ --json Print one JSON envelope on stdout (NDJSON for streams).
1093
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
1094
+ --cwd <dir> Resolve relative paths from this directory.
1095
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
1096
+ --help Show this command's help; with --json, its definition.
1097
+
1098
+ Output: DaemonStatus (mostra docs cli)
1099
+
1100
+ Exit codes:
1101
+ 0 success
1102
+ 2 usage error
1103
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
1104
+ 4 timeout (--timeout passed)
1105
+
1106
+ Example:
1107
+ mostra daemon restart
1108
+ ```
1109
+
1110
+ ## mostra daemon status
1111
+
1112
+ ```text
1113
+ Whether the home's daemon runs, when it would exit for lack of work, and its login service.
1114
+
1115
+ Usage:
1116
+ mostra daemon status
1117
+
1118
+ Global flags:
1119
+ --json Print one JSON envelope on stdout (NDJSON for streams).
1120
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
1121
+ --cwd <dir> Resolve relative paths from this directory.
1122
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
1123
+ --help Show this command's help; with --json, its definition.
1124
+
1125
+ Output: DaemonStatus (mostra docs cli)
1126
+
1127
+ Exit codes:
1128
+ 0 success
1129
+ 2 usage error
1130
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
1131
+ 4 timeout (--timeout passed)
1132
+
1133
+ Example:
1134
+ mostra daemon status
1135
+ ```
1136
+
1137
+ ## mostra daemon install
1138
+
1139
+ ```text
1140
+ Run the home's daemon as a login service (launchd, systemd or Task Scheduler), so links answer at any hour.
1141
+
1142
+ Usage:
1143
+ mostra daemon install [flags]
1144
+
1145
+ Flags:
1146
+ --no-start Write or remove the service's definition without asking launchd, systemd or Task Scheduler to load it.
1147
+
1148
+ Global flags:
1149
+ --json Print one JSON envelope on stdout (NDJSON for streams).
1150
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
1151
+ --cwd <dir> Resolve relative paths from this directory.
1152
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
1153
+ --help Show this command's help; with --json, its definition.
1154
+
1155
+ Output: ServiceStatus (mostra docs cli)
1156
+
1157
+ Exit codes:
1158
+ 0 success
1159
+ 2 usage error
1160
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
1161
+ 4 timeout (--timeout passed)
1162
+
1163
+ Example:
1164
+ mostra daemon install
1165
+ ```
1166
+
1167
+ ## mostra daemon uninstall
1168
+
1169
+ ```text
1170
+ Remove the home's login service; the daemon then exits after 30 idle minutes.
1171
+
1172
+ Usage:
1173
+ mostra daemon uninstall [flags]
1174
+
1175
+ Flags:
1176
+ --no-start Write or remove the service's definition without asking launchd, systemd or Task Scheduler to load it.
1177
+
1178
+ Global flags:
1179
+ --json Print one JSON envelope on stdout (NDJSON for streams).
1180
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
1181
+ --cwd <dir> Resolve relative paths from this directory.
1182
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
1183
+ --help Show this command's help; with --json, its definition.
1184
+
1185
+ Output: ServiceStatus (mostra docs cli)
1186
+
1187
+ Exit codes:
1188
+ 0 success
1189
+ 2 usage error
1190
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
1191
+ 4 timeout (--timeout passed)
1192
+
1193
+ Example:
1194
+ mostra daemon uninstall
1195
+ ```
1196
+
1197
+ ## mostra host
1198
+
1199
+ ```text
1200
+ Speak the host protocol on stdin and stdout, for a host that spawns Mostra; it sends no telemetry.
1201
+
1202
+ Usage:
1203
+ mostra host [flags]
1204
+
1205
+ Flags:
1206
+ --bind <address> Serve viewers on this address instead of 127.0.0.1.
1207
+ --url-host <name> The host name links use; a wildcard --bind needs it.
1208
+
1209
+ Global flags:
1210
+ --json Print one JSON envelope on stdout (NDJSON for streams).
1211
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
1212
+ --cwd <dir> Resolve relative paths from this directory.
1213
+ --help Show this command's help; with --json, its definition.
1214
+
1215
+ Output: the host protocol (INTERFACES §6) (mostra docs cli)
1216
+
1217
+ Exit codes:
1218
+ 0 success
1219
+ 2 usage error
1220
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
1221
+
1222
+ Example:
1223
+ mostra host --home ~/.my-host/mostra
1224
+ ```
1225
+
1226
+ ## mostra mcp
1227
+
1228
+ ```text
1229
+ Run Mostra's MCP server, so an MCP client can create, verify and publish artifacts, wait for answers and read results.
1230
+
1231
+ Usage:
1232
+ mostra mcp [flags]
1233
+
1234
+ Flags:
1235
+ --http Serve Streamable HTTP at /mcp instead of stdio; every request needs Authorization: Bearer <token>.
1236
+ --port <port> With --http, the port; default one the system picks.
1237
+ --bind <address> With --http, listen on this address instead of 127.0.0.1.
1238
+ --url-host <name> With --http, the host name clients use; a wildcard --bind needs it.
1239
+ --workspace <dir> Where relative artifact directories and new artifacts go. Default: MOSTRA_MCP_WORKSPACE, else ~/mostra-artifacts.
1240
+ --embedded This server runs on someone's behalf (a harness plugin or another host started it), so it sends no telemetry.
1241
+
1242
+ Global flags:
1243
+ --json Print one JSON envelope on stdout (NDJSON for streams).
1244
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
1245
+ --cwd <dir> Resolve relative paths from this directory.
1246
+ --help Show this command's help; with --json, its definition.
1247
+
1248
+ Output: the MCP protocol on stdin and stdout, or over HTTP (mostra docs cli)
1249
+
1250
+ Exit codes:
1251
+ 0 success
1252
+ 2 usage error
1253
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
1254
+
1255
+ Example:
1256
+ mostra mcp
1257
+ ```
1258
+
1259
+ ## mostra docs
1260
+
1261
+ ```text
1262
+ Print Mostra's reference: the guide to writing artifacts, the CLI, telemetry, and every diagnostic code's page.
1263
+
1264
+ Usage:
1265
+ mostra docs [<topic>]
1266
+
1267
+ Arguments:
1268
+ <topic> A topic or a diagnostic code. Default: the index.
1269
+
1270
+ Global flags:
1271
+ --json Print one JSON envelope on stdout (NDJSON for streams).
1272
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
1273
+ --cwd <dir> Resolve relative paths from this directory.
1274
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
1275
+ --help Show this command's help; with --json, its definition.
1276
+
1277
+ Output: DocsPage (mostra docs cli)
1278
+
1279
+ Exit codes:
1280
+ 0 success
1281
+ 2 usage error
1282
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
1283
+ 4 timeout (--timeout passed)
1284
+
1285
+ Example:
1286
+ mostra docs MOSTRA_DEP_MISSING
1287
+ ```
1288
+
1289
+ ## mostra doctor
1290
+
1291
+ ```text
1292
+ Check the platform, the runtime, the home, its daemon and ledger, and the login service.
1293
+
1294
+ Usage:
1295
+ mostra doctor [flags]
1296
+
1297
+ Flags:
1298
+ --deep Also hash every version against its recorded output digest.
1299
+
1300
+ Global flags:
1301
+ --json Print one JSON envelope on stdout (NDJSON for streams).
1302
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
1303
+ --cwd <dir> Resolve relative paths from this directory.
1304
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
1305
+ --help Show this command's help; with --json, its definition.
1306
+
1307
+ Output: DoctorResult (mostra docs cli)
1308
+
1309
+ Exit codes:
1310
+ 0 success
1311
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
1312
+ 2 usage error
1313
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
1314
+ 4 timeout (--timeout passed)
1315
+
1316
+ Example:
1317
+ mostra doctor
1318
+ ```
1319
+
1320
+ ## mostra gc
1321
+
1322
+ ```text
1323
+ Remove what nothing references: unreferenced versions' files, unused packages and caches.
1324
+
1325
+ Usage:
1326
+ mostra gc [flags]
1327
+
1328
+ Flags:
1329
+ --dry-run List what a run would remove, and remove nothing.
1330
+ --compact-events Also replace events before --before with one summary per artifact.
1331
+ --before <cursor> The cursor --compact-events compacts before.
1332
+
1333
+ Global flags:
1334
+ --json Print one JSON envelope on stdout (NDJSON for streams).
1335
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
1336
+ --cwd <dir> Resolve relative paths from this directory.
1337
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
1338
+ --help Show this command's help; with --json, its definition.
1339
+
1340
+ Output: GcRunResult (mostra docs cli)
1341
+
1342
+ Exit codes:
1343
+ 0 success
1344
+ 1 artifact failure (verify failed, publish refused, the artifact's state refused the request)
1345
+ 2 usage error
1346
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
1347
+ 4 timeout (--timeout passed)
1348
+
1349
+ Example:
1350
+ mostra gc --dry-run
1351
+ ```
1352
+
1353
+ ## mostra telemetry status
1354
+
1355
+ ```text
1356
+ Whether the CLI sends anonymous usage data, and why.
1357
+
1358
+ Usage:
1359
+ mostra telemetry status
1360
+
1361
+ Global flags:
1362
+ --json Print one JSON envelope on stdout (NDJSON for streams).
1363
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
1364
+ --cwd <dir> Resolve relative paths from this directory.
1365
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
1366
+ --help Show this command's help; with --json, its definition.
1367
+
1368
+ Output: TelemetryStatus (mostra docs telemetry)
1369
+
1370
+ Exit codes:
1371
+ 0 success
1372
+ 2 usage error
1373
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
1374
+ 4 timeout (--timeout passed)
1375
+
1376
+ Example:
1377
+ mostra telemetry status
1378
+ ```
1379
+
1380
+ ## mostra telemetry on
1381
+
1382
+ ```text
1383
+ Send anonymous usage data from this CLI; the notice says what it contains.
1384
+
1385
+ Usage:
1386
+ mostra telemetry on
1387
+
1388
+ Global flags:
1389
+ --json Print one JSON envelope on stdout (NDJSON for streams).
1390
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
1391
+ --cwd <dir> Resolve relative paths from this directory.
1392
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
1393
+ --help Show this command's help; with --json, its definition.
1394
+
1395
+ Output: TelemetryStatus (mostra docs telemetry)
1396
+
1397
+ Exit codes:
1398
+ 0 success
1399
+ 2 usage error
1400
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
1401
+ 4 timeout (--timeout passed)
1402
+
1403
+ Example:
1404
+ mostra telemetry on
1405
+ ```
1406
+
1407
+ ## mostra telemetry off
1408
+
1409
+ ```text
1410
+ Stop sending usage data, and delete the install ID and any unsent events.
1411
+
1412
+ Usage:
1413
+ mostra telemetry off
1414
+
1415
+ Global flags:
1416
+ --json Print one JSON envelope on stdout (NDJSON for streams).
1417
+ --home <dir> Use this Mostra home instead of MOSTRA_HOME or the default.
1418
+ --cwd <dir> Resolve relative paths from this directory.
1419
+ --timeout <d> Give up on the instance after this long (exit 4), such as 30s or 5m.
1420
+ --help Show this command's help; with --json, its definition.
1421
+
1422
+ Output: TelemetryStatus (mostra docs telemetry)
1423
+
1424
+ Exit codes:
1425
+ 0 success
1426
+ 2 usage error
1427
+ 3 environment error (no runtime, browser or socket; the home; an unsupported platform)
1428
+ 4 timeout (--timeout passed)
1429
+
1430
+ Example:
1431
+ mostra telemetry off
1432
+ ```