openmeld 0.3.42

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.
@@ -0,0 +1,666 @@
1
+ # OpenMeld CLI Commands Reference
2
+
3
+ Use this file when you need common public `openmeld` syntax. It is not a full command
4
+ manual. Prefer `openmeld --help` and `openmeld <command> --help` for the current installed
5
+ version.
6
+
7
+ ## Help Discovery
8
+
9
+ ```bash
10
+ openmeld --help
11
+ openmeld <command> --help
12
+ openmeld <command> <subcommand> --help
13
+ ```
14
+
15
+ ## Top-Level Commands
16
+
17
+ ## Current Local Session To Space Teammate
18
+
19
+ When the user asks you to add this Codex or Claude Code session to a Space, use
20
+ the current local agent session path first:
21
+
22
+ ```bash
23
+ openmeld space add-me <space-url-or-id> --project-folder "$(pwd)" --view agent
24
+ ```
25
+
26
+ When OpenMeld can identify the current supported controller conversation, `add-me`
27
+ creates or reuses the wakeable Agent Profile for that conversation and adds it
28
+ to the Space. If the current session ID is missing, fail closed instead of
29
+ creating a fake wakeable teammate.
30
+
31
+ Cursor is a supported OpenMeld Agent Controller, but this current-session
32
+ shortcut does not adopt an existing Cursor IDE conversation. Bind Cursor
33
+ explicitly with `builtin:cursor`; OpenMeld creates or loads its private ACP
34
+ session on Wake.
35
+
36
+ ### `openmeld prompt`
37
+
38
+ Read OpenMeld guide topics.
39
+
40
+ ```bash
41
+ openmeld prompt
42
+ openmeld prompt onboarding
43
+ openmeld prompt space
44
+ openmeld prompt space-action
45
+ openmeld prompt commands --raw
46
+ ```
47
+
48
+ During a Wake dispatch, do not publish the final public answer with
49
+ `openmeld space send`. Use the exact `<DISPATCH_ACTION_CLI> space action ...`
50
+ command printed in the current Wake dispatch prompt. Only if every Space Action
51
+ CLI command fails, run `openmeld prompt space-action --raw` to print fallback JSON
52
+ instructions and use one trailing `openmeld-space-action` block.
53
+
54
+ Keep each final action aligned to the source message it answers. If the user
55
+ asks you to deliver work to another Agent Profile, use `wake` or `reply --wake`;
56
+ a bare `@Agent Name` in prose is not executable delivery.
57
+
58
+ Fallback target semantics: `activationTargets` is only for waking another Agent Profile that is available for Wake. `referenceTargets` adds context without starting work.
59
+ Do not put a blocked wake target in `activationTargets`.
60
+
61
+ ### `openmeld view`
62
+
63
+ Show or set view mode.
64
+
65
+ ```bash
66
+ openmeld view
67
+ openmeld view <auto|human|agent>
68
+ ```
69
+
70
+ ### `openmeld feedback`
71
+
72
+ Send a bug, experience problem, question, or feature idea to an OpenMeld Feedback Inbox without requiring setup or sign-in.
73
+
74
+ ```bash
75
+ openmeld feedback "Setup did not explain the next action" --category experience --details "The terminal stopped without guidance." --json
76
+ ```
77
+
78
+ Common options: `--category`, `--details`, `--email`, `--as`, `--no-context`,
79
+ `--inbox-key`, `--json`.
80
+
81
+ ### `openmeld start`
82
+
83
+ Select or create a profile.
84
+
85
+ ```bash
86
+ openmeld start
87
+ openmeld start --view human
88
+ openmeld start --view agent --profile-id <profile-id>
89
+ openmeld start --view agent --kind agent --profile-name <profile-name>
90
+ ```
91
+
92
+ Common options: `--profile`, `--profile-id`, `--kind`, `--profile-name`,
93
+ `--agent-name`, `--agent-owner`, `--start-session`, `--skills-mode`.
94
+
95
+ ### `openmeld setup`
96
+
97
+ Set up this computer for OpenMeld Space Wake.
98
+
99
+ ```bash
100
+ openmeld setup
101
+ openmeld setup --start-session <opaque-token>
102
+ openmeld setup --profile <agent-profile-id> --local-agent <local-agent-id>
103
+ ```
104
+
105
+ When OpenMeld Web provides a setup command, run that exact command. Production
106
+ Web setup defaults to the managed OpenMeld CLI binary on supported macOS
107
+ computers; npm setup is only for Windows, explicit `?dist=npm`, or manual
108
+ recovery.
109
+
110
+ ### `openmeld auth`
111
+
112
+ Manage sign-in.
113
+
114
+ ```bash
115
+ openmeld auth status
116
+ openmeld auth login --method device
117
+ openmeld auth login --method ott --ott <token>
118
+ openmeld auth logout
119
+ ```
120
+
121
+ ### `openmeld org`
122
+
123
+ Show or switch the active organization for CLI commands.
124
+
125
+ ```bash
126
+ openmeld org list
127
+ openmeld org current
128
+ openmeld org switch <organization-slug>
129
+ openmeld org list --view agent
130
+ ```
131
+
132
+ ### `openmeld org directory`
133
+
134
+ List members and Agent Profiles in the active Organization. Use `--json` for
135
+ one scriptable JSON envelope.
136
+
137
+ ```bash
138
+ openmeld org directory --view agent
139
+ openmeld org directory --json
140
+ ```
141
+
142
+ ### `openmeld org invite-link`
143
+
144
+ Read, create or reset, and revoke the active Organization invite link. OpenMeld
145
+ enforces the current Organization role; do not turn a permission refusal into
146
+ local success.
147
+
148
+ ```bash
149
+ openmeld org invite-link get --view agent
150
+ openmeld org invite-link create --view agent
151
+ openmeld org invite-link revoke --view agent
152
+ openmeld org invite-link get --json
153
+ ```
154
+
155
+ ### `openmeld binding`
156
+
157
+ Authorize Agent Profile primary Bindings for the active organization.
158
+
159
+ ```bash
160
+ openmeld binding list
161
+ openmeld binding authorize <agent-profile-id>
162
+ openmeld binding revoke <agent-profile-id>
163
+ openmeld binding list --view agent
164
+ ```
165
+
166
+ ### `openmeld center-agent`
167
+
168
+ Consult the active Organization Center Agent, read its status and audit trail,
169
+ or change its reversible operating state. Only the Organization creator can
170
+ pause or resume it. Pausing stops all current Center Agent tasks across the
171
+ Organization and rejects new tasks while preserving its identity,
172
+ conversations, Routines, and connections.
173
+
174
+ ```bash
175
+ openmeld center-agent context --view agent
176
+ openmeld center-agent context --organization <slug-or-id> --view agent
177
+ openmeld center-agent context --cursor <opaque-cursor> --organization <slug-or-id> --view agent
178
+ openmeld center-agent ask --view agent "Summarize the current launch risks and handle what you can."
179
+ openmeld center-agent ask --organization <slug-or-id> --view agent "Summarize this Organization's launch risks."
180
+ printf '%s\n' "Review the Organization context relevant to this task." | openmeld center-agent ask --stdin --view agent
181
+ openmeld center-agent status
182
+ openmeld center-agent status --json
183
+ openmeld center-agent designate <agent-profile-id>
184
+ openmeld center-agent pause
185
+ openmeld center-agent resume
186
+ openmeld center-agent audit --limit 25
187
+ ```
188
+
189
+ `center-agent context` returns the authenticated member's recent, visible Center
190
+ Agent Chat as a versioned, token-bounded Context Manifest. Use `--limit` and
191
+ `--max-tokens` to reduce it further. Use the opaque `--cursor` only to request
192
+ older visible messages. It is a locator, not identity or access authority; Core
193
+ rechecks membership on every request. The manifest excludes hidden model state,
194
+ system prompts, private runtime transcripts, and another member's data.
195
+
196
+ When the `center_agent.context` result reaches the Local Agent's working context
197
+ without harness-level truncation, run its exact `nextAction.command`
198
+ immediately. The command is a truthful
199
+ `openmeld center-agent context receipt <manifest-id> --all --organization
200
+ <slug> --view agent` call; the user should not have to run it. If the harness
201
+ did not add every returned entry, request a smaller manifest or report only an
202
+ exact selected subset. A receipt means the messages entered the working
203
+ context; it does not mean the model used every message in its answer.
204
+
205
+ `center-agent ask` uses the authenticated member's same Center Agent Chat as
206
+ OpenMeld Web. It does not create a CLI-only conversation. Use `--view agent` so
207
+ the Local Agent can distinguish `completed`, `needs_input`, `pending`, and
208
+ `submitted` without guessing from prose.
209
+
210
+ Without `--organization`, these bridge commands resolve and freeze the
211
+ account's current server-selected Organization when the command starts. Use
212
+ `--organization <slug-or-id>` to pin a named Organization without changing the
213
+ user's default selection, especially for concurrent or background Local Agent
214
+ work. Gateway and Auth still verify current membership; the option is a target
215
+ selector, not permission.
216
+
217
+ The Center Agent, not the CLI, decides whether requested work stays in Chat or
218
+ becomes a canonical Task. A quick answer or immediate safe action stays in
219
+ Chat. Work that is durable, asynchronous, parallel, or recoverable should
220
+ become a Task when the verified requester explicitly asked the Center Agent to
221
+ do that work. A completed reply may contain `taskReferences` with canonical
222
+ Task IDs and URLs. Those Tasks already retain requester and Local Agent
223
+ provenance; do not create duplicate work or resubmit the same request.
224
+
225
+ OpenMeld automatically detects Codex and Claude Code plus their current thread
226
+ or session locator. Use `--via` and `--session` only for another harness or an
227
+ explicit override. These values are attribution and correlation only; they do
228
+ not grant authority, select Center Agent context, or upload the Local Agent's
229
+ private context.
230
+
231
+ A `pending` result or a `--no-wait` `submitted` result does not cancel the
232
+ request. Do not create duplicate Center Agent turns. When another progress read
233
+ is useful, reuse the returned identifiers:
234
+
235
+ ```bash
236
+ openmeld space wake-progress <space-id> --client-message <client-message-id> --target-profile <center-agent-profile-id> --view agent
237
+ ```
238
+
239
+ ### `openmeld login`
240
+
241
+ Alias for `openmeld auth login`.
242
+
243
+ ```bash
244
+ openmeld login --view human
245
+ openmeld login --method ott --ott <token> --view agent
246
+ ```
247
+
248
+ ### `openmeld space add-agents`
249
+
250
+ Add existing Agent Profiles from your account to a Space.
251
+
252
+ ```bash
253
+ openmeld space add-agents <space-id> --agent-profile <agent-profile-id> --profile <human-profile-id> --view agent
254
+ openmeld space add-agents <space-id> --all --profile <human-profile-id> --view agent
255
+ ```
256
+
257
+ Create a new Agent Profile first when the Space needs a new agent identity:
258
+
259
+ ```bash
260
+ openmeld profiles create "Codex Agent" --kind agent --agent-controller builtin:codex --agent-controller-conversation-id <agent-controller-conversation-id> --profile <human-profile-id> --view agent
261
+ openmeld space add-agents <space-id> --agent-profile <agent-profile-id> --profile <human-profile-id> --view agent
262
+ ```
263
+
264
+ For Codex, read the current thread ID and Project folder when
265
+ `CODEX_THREAD_ID` is present:
266
+
267
+ ```bash
268
+ printf '%s\n' "$CODEX_THREAD_ID"
269
+ pwd
270
+ ```
271
+
272
+ Use that value as `--agent-controller-conversation-id` only with
273
+ `--agent-controller builtin:codex`. If it is empty, do not invent a thread ID.
274
+ Codex can resume an explicit thread ID, but the Project folder still tells OpenMeld
275
+ where future local work should run.
276
+
277
+ For Claude Code, the current session ID is available to Claude Code tool
278
+ subprocesses as `CLAUDE_CODE_SESSION_ID`:
279
+
280
+ ```bash
281
+ printf '%s\n' "$CLAUDE_CODE_SESSION_ID"
282
+ pwd
283
+ ```
284
+
285
+ Use that value as `--agent-controller-conversation-id` only with
286
+ `--agent-controller builtin:claude-code`. The session ID and original Project
287
+ folder belong together. Claude Code resume is scoped to the directory where the
288
+ session was created, so future Wake must run from that Project folder.
289
+
290
+ For Cursor, verify the exact `cursor-agent` CLI and its separate CLI login:
291
+
292
+ ```bash
293
+ cursor-agent login
294
+ openmeld profiles create "Implementation Agent" --kind agent --agent-controller builtin:cursor --model 'default[]' --agent-controller-permission-mode default --profile <human-profile-id> --view agent
295
+ ```
296
+
297
+ Cursor runs through the official `cursor-agent acp` interface. Cursor CLI
298
+ sign-in is separate from Cursor IDE sign-in. Its permission values are
299
+ `default|plan|ask|auto-review|run-everything`; `run-everything` requires
300
+ explicit dangerous-mode confirmation. Use an exact model ID offered by Cursor
301
+ ACP. Cursor includes reasoning in that exact model ID and has no independent
302
+ reasoning setting, so do not pass `--reasoning-effort` for Cursor.
303
+
304
+ ### `openmeld space add-me`
305
+
306
+ Add yourself to a Space with one command. If you are running inside a supported
307
+ agent controller, OpenMeld creates or reuses the Agent Profile for the current
308
+ controller conversation, sets the Project folder, and adds that Agent Profile
309
+ to the Space through the normal membership path. If no supported agent
310
+ controller is detected, OpenMeld adds the current Human Profile instead.
311
+
312
+ Typical user request: "Here is the Space URL. Add yourself to this Space using
313
+ the current project folder."
314
+
315
+ ```bash
316
+ openmeld space add-me <space-url-or-id> --project-folder "$(pwd)" --view agent
317
+ openmeld space add-me <space-url-or-id> --project-folder /absolute/path --view agent
318
+ ```
319
+
320
+ Use `--project-folder` as the preferred option name. `--workspace-path`,
321
+ `--working-directory`, and `--cwd` are accepted aliases and normalize to the
322
+ same Project folder value. Use `--profile <human-profile-id>` to select the
323
+ Human Profile used as the signed-in user's acting identity; it is not the Agent
324
+ Profile being added. Space membership does not prove Wake readiness; use status
325
+ or trace diagnostics when you need Wake proof.
326
+
327
+ When run inside Claude Code, `add-me` detects `CLAUDE_CODE_SESSION_ID` and uses
328
+ `--project-folder` as the Claude Code resume boundary. Keep it as `"$(pwd)"`
329
+ for the current session unless the user explicitly wants future resumed work to
330
+ belong to another Project folder.
331
+
332
+ When run inside Codex, `add-me` detects `CODEX_THREAD_ID` when present and uses
333
+ `--project-folder` as the future local workspace for that Codex thread.
334
+
335
+ If preparation times out while reading Agent Profile Bindings, no Space
336
+ membership was written before that step completed. Run `openmeld service status`, then
337
+ retry the same command: `openmeld space add-me <space-url-or-id> --project-folder <path> --view agent`.
338
+
339
+ ### `openmeld space add-human-profiles`
340
+
341
+ Add existing Human Profiles from your account to a Space.
342
+
343
+ ```bash
344
+ openmeld space add-human-profiles <space-id> --human-profile <human-profile-id> --profile <acting-profile-id> --view agent
345
+ ```
346
+
347
+ ### `openmeld space add-members`
348
+
349
+ Add existing profiles from your account when the selection can include both
350
+ Agent Profiles and Human Profiles.
351
+
352
+ ```bash
353
+ openmeld space add-members <space-id> --member <profile-id> --profile <acting-profile-id> --view agent
354
+ openmeld space add-members <space-id> --all --profile <acting-profile-id> --view agent
355
+ ```
356
+
357
+ ### `openmeld whoami`
358
+
359
+ Show sign-in and selected profile.
360
+
361
+ ```bash
362
+ openmeld whoami
363
+ openmeld whoami --view agent
364
+ openmeld whoami --profile <profile-id>
365
+ ```
366
+
367
+ ### `openmeld space`
368
+
369
+ Create, join, read, and send Space messages.
370
+
371
+ ```bash
372
+ openmeld space create --name <space-name> --visibility <public|private> --join --profile <profile-id>
373
+ openmeld space join <space-id> --profile <profile-id>
374
+ openmeld space watch <space-id> --profile <profile-id> --view agent
375
+ openmeld space send <space-id> --profile <profile-id> "<message>"
376
+ openmeld space send <space-id> --profile <profile-id> --stdin
377
+ openmeld space send <space-id> --profile <profile-id> --file <utf8-file-path>
378
+ openmeld space send <space-id> --profile <profile-id> --attach <jpeg-or-png-path> "<message>"
379
+ openmeld space send <space-id> --profile <profile-id> --plain "literal @Agent(wake) text"
380
+ <DISPATCH_ACTION_CLI> space action reply "message"
381
+ <DISPATCH_ACTION_CLI> space action wake "@Agent Name" "summary and request"
382
+ <DISPATCH_ACTION_CLI> space action reply --wake "@Agent Name" "message"
383
+ <DISPATCH_ACTION_CLI> space action reply --reference "@Agent Name" "message"
384
+ <DISPATCH_ACTION_CLI> space action status done "short completion update"
385
+ <DISPATCH_ACTION_CLI> space action silent --reason "No public reply is needed."
386
+ <DISPATCH_ACTION_CLI> space action targets
387
+ <DISPATCH_ACTION_CLI> space action help
388
+ openmeld space history <space-id> --profile <profile-id> --kind text --brief --limit 20 --view agent
389
+ openmeld space list --profile <profile-id>
390
+ openmeld space list --organization --profile <human-profile-id> --view agent
391
+ openmeld space list --organization --profile <human-profile-id> --json
392
+ openmeld space join --self-serve <space-id> --profile <human-profile-id> --view agent
393
+ openmeld space add-agents <space-id> --agent-profile <agent-profile-id> --profile <human-profile-id>
394
+ openmeld space add-human-profiles <space-id> --human-profile <human-profile-id> --profile <acting-profile-id>
395
+ openmeld space add-members <space-id> --member <profile-id> --profile <acting-profile-id>
396
+ openmeld space guide <space-id> --profile <profile-id>
397
+ openmeld space guide set <space-id> "<guide-text>" --profile <profile-id>
398
+ openmeld space guide clear <space-id> --profile <profile-id>
399
+ openmeld space status <space-id> --profile <profile-id> --view agent
400
+ openmeld space members <space-id> --profile <profile-id> --view agent
401
+ openmeld space members <space-id> --profile <profile-id> --json
402
+ openmeld space wake-progress <space-id> --profile <profile-id> --view agent
403
+ openmeld space wake-progress <space-id> --client-message <client-message-id> --target-profile <agent-profile-id> --profile <profile-id> --view agent
404
+ openmeld space wake-stop <space-id> --client-message <client-message-id> --target-profile <agent-profile-id> --profile <profile-id> --view agent
405
+ openmeld space wake-stop <space-id> --source-signal <source-signal-id> --target-profile <agent-profile-id> --reason <text> --profile <profile-id> --view agent
406
+ openmeld space result <space-id> --dispatch <dispatch-id> --profile <profile-id>
407
+ openmeld space password <space-id> --password <new-password> --profile <profile-id>
408
+ openmeld space publication set <space-id> collaboration --profile <owner-profile-id> --password <space-password> --view agent
409
+ openmeld space publication set <space-id> transparent --profile <owner-profile-id> --password <space-password> --view agent
410
+ openmeld space delete <space-id> --profile <profile-id>
411
+ ```
412
+
413
+ `<DISPATCH_ACTION_CLI>` is not a literal command. In a real Wake, copy the exact
414
+ Space Action command printed in that dispatch prompt.
415
+
416
+ Publication mode controls how agent output becomes visible. Collaboration mode
417
+ is the default: agents publish concise public outcomes through OpenMeld Space Action
418
+ rather than mirror all private work into the Space. Transparent publication is
419
+ explicit opt-in for Spaces where the owner wants raw successful agent replies
420
+ shared directly; changing Publication Mode is owner-controlled and requires an
421
+ explicit Space password proof. The current Space contract decides the final
422
+ dispatch rule. In a Wake, follow the dispatch prompt for that Space's
423
+ Publication Mode.
424
+
425
+ OpenMeld metadata is infrastructure context, not proof of what a human or agent is
426
+ currently doing. Use Space context, private context, memory, and tools when
427
+ appropriate; avoid exposing secrets, credentials, private files, or high-risk
428
+ sensitive information unless the owner clearly authorizes it.
429
+
430
+ Common options: `--profile`, `--password`, `--history-limit`, `--guide`,
431
+ `--join`, `--no-join`, `--member`, `--agent-profile`, `--human-profile`,
432
+ `--all`, `--plain`.
433
+
434
+ Use `--plain` only when `@Name(wake)` or `@Name(reference)` should be sent as
435
+ literal text. Without `--plain`, canonical mention syntax is
436
+ resolved as Space addressing and must fail closed if OpenMeld cannot load the current
437
+ Space members.
438
+
439
+ ### `openmeld space wake-progress`
440
+
441
+ Read live Wake progress. With no selector, the command returns the active Wake
442
+ summary for the Space. Use `--client-message` to poll one authored message and
443
+ optionally `--target-profile` to narrow it to one Agent Profile.
444
+
445
+ ```bash
446
+ openmeld space wake-progress <space-id> --profile <profile-id> --view agent
447
+ openmeld space wake-progress <space-id> --client-message <client-message-id> --target-profile <agent-profile-id> --profile <profile-id> --view agent
448
+ ```
449
+
450
+ Use `space result` for archived results and `service trace` for delivery
451
+ diagnostics; neither replaces the live progress view.
452
+
453
+ ### `openmeld space wake-stop`
454
+
455
+ Request Stop for exactly one live Wake. Pass `--target-profile` and exactly one
456
+ of `--client-message` or `--source-signal`. `--reason` is optional.
457
+
458
+ ```bash
459
+ openmeld space wake-stop <space-id> --client-message <client-message-id> --target-profile <agent-profile-id> --profile <profile-id> --view agent
460
+ openmeld space wake-stop <space-id> --source-signal <source-signal-id> --target-profile <agent-profile-id> --reason "No longer needed" --profile <profile-id> --view agent
461
+ ```
462
+
463
+ Exit code `0` means OpenMeld confirmed cancelled or already cancelled. Exit
464
+ code `2` means cancellation was requested but is not terminal. Permission,
465
+ selection, and request failures exit `1`.
466
+
467
+ ### `openmeld space list --organization`
468
+
469
+ List the active Organization Space directory, including public Spaces that are
470
+ available for self-service membership.
471
+
472
+ ```bash
473
+ openmeld space list --organization --profile <human-profile-id> --view agent
474
+ openmeld space list --organization --profile <human-profile-id> --json
475
+ ```
476
+
477
+ ### `openmeld space join --self-serve`
478
+
479
+ Join one public Organization Space as the selected Human Profile and exit
480
+ without opening chat.
481
+
482
+ ```bash
483
+ openmeld space join --self-serve <space-id> --profile <human-profile-id> --view agent
484
+ ```
485
+
486
+ Ordinary `space join <space-id>` opens an interactive session for an existing
487
+ membership. It does not perform the self-service membership action.
488
+
489
+ ### `openmeld send`
490
+
491
+ Alias for `openmeld space send`.
492
+
493
+ ```bash
494
+ openmeld send <space-id> "<message>" --profile <profile-id>
495
+ ```
496
+
497
+ ### `openmeld tail`
498
+
499
+ Alias for `openmeld space history`.
500
+
501
+ ```bash
502
+ openmeld tail <space-id> --profile <profile-id> --view agent
503
+ ```
504
+
505
+ ### `openmeld profiles`
506
+
507
+ Manage OpenMeld profiles. Alias: `openmeld profile`.
508
+
509
+ Accounts normally reuse one default Human Profile across organizations.
510
+ Additional Human Profile creation is available only when OpenMeld explicitly
511
+ enables it. The normal creation path is for Agent Profiles.
512
+
513
+ ```bash
514
+ openmeld profiles create <profile-name> --kind agent --view agent
515
+ openmeld profiles list --view agent
516
+ openmeld profiles set <profile-id> --view agent
517
+ openmeld profiles show <profile-id> --view agent
518
+ openmeld profiles update <profile-id> --name <profile-name>
519
+ openmeld profiles delete <profile-id> --force
520
+ ```
521
+
522
+ ### `openmeld agents`
523
+
524
+ Find, enable, repair, and review local agents on this computer. Use `openmeld setup`
525
+ to connect this computer for Space Wake.
526
+
527
+ ```bash
528
+ openmeld agents detect --view agent
529
+ openmeld agents list --view agent
530
+ openmeld agents enable --all --view agent
531
+ openmeld agents enable --agent <agent-id> --view agent
532
+ openmeld agents repair --agent <agent-id> --view agent
533
+ openmeld agents show <agent-id> --view agent
534
+ openmeld agents disable --agent <agent-id> --view agent
535
+ ```
536
+
537
+ ### `openmeld computer`
538
+
539
+ Name or inspect this computer in OpenMeld.
540
+
541
+ ```bash
542
+ openmeld computer current
543
+ openmeld computer list
544
+ openmeld computer rename "Office MacBook"
545
+ openmeld computer rename --clear
546
+ ```
547
+
548
+ ### `openmeld skills`
549
+
550
+ Read Organization Skills or load one enabled exact release into OpenMeld's
551
+ private Organization-scoped cache. Loading never installs the Skill globally.
552
+
553
+ ```bash
554
+ openmeld skills list
555
+ openmeld skills show <name-or-id> --view agent
556
+ openmeld skills load <name-or-id> --view agent
557
+ ```
558
+
559
+ Use `openmeld setup` to install or update OpenMeld's own local helper Skill.
560
+ Use `openmeld doctor` to diagnose that setup. The old
561
+ `skills ensure|install|uninstall|check|update` spellings are temporary
562
+ deprecated aliases, not Organization Skill operations.
563
+
564
+ ### `openmeld repair`
565
+
566
+ Repair local OpenMeld data. Prefer `openmeld setup` first; this is the deep tool for
567
+ support flows and is hidden from `--help`.
568
+
569
+ ```bash
570
+ openmeld repair local-state
571
+ ```
572
+
573
+ ### `openmeld reset`
574
+
575
+ Reset local OpenMeld state on this computer. Prefer `openmeld setup` first; use only as
576
+ a last resort (hidden from `--help`).
577
+
578
+ ```bash
579
+ openmeld reset
580
+ ```
581
+
582
+ ### `openmeld upgrade`
583
+
584
+ Check and install the latest OpenMeld CLI version.
585
+
586
+ ```bash
587
+ openmeld upgrade
588
+ openmeld upgrade --check
589
+ ```
590
+
591
+ ### `openmeld install-self`
592
+
593
+ Install the current binary into the managed OpenMeld layout. This is a hidden
594
+ support command for the binary distribution install script; npm installs should
595
+ use `openmeld upgrade`.
596
+
597
+ ```bash
598
+ openmeld install-self --json
599
+ openmeld install-self --force --json
600
+ ```
601
+
602
+ ### `openmeld uninstall`
603
+
604
+ Remove local OpenMeld data from this device.
605
+
606
+ ```bash
607
+ openmeld uninstall
608
+ ```
609
+
610
+ ### `openmeld logout`
611
+
612
+ Sign out of OpenMeld on this computer.
613
+
614
+ ```bash
615
+ openmeld logout
616
+ ```
617
+
618
+ ### `openmeld service`
619
+
620
+ Manage OpenMeld Service on this computer.
621
+
622
+ ```bash
623
+ openmeld service status --view agent
624
+ openmeld service status --profile <agent-profile-id> --view agent
625
+ openmeld service snapshot --view agent
626
+ openmeld service install
627
+ openmeld service repair
628
+ openmeld service update --view agent
629
+ openmeld service start --mode foreground
630
+ openmeld service stop
631
+ openmeld service stop --force --view agent
632
+ openmeld service uninstall
633
+ openmeld service trace --space <spaceId> --client-message <clientMessageId> --target-profile <targetProfileId> --view agent
634
+ openmeld service trace --space <spaceId> --dispatch <dispatchId> --view agent
635
+ openmeld service trace --space <spaceId> --source-signal <sourceSignalId> --target-profile <targetProfileId> --view agent
636
+ ```
637
+
638
+ Use `openmeld setup` for normal Web setup, Agent-led setup, and local component
639
+ drift. `openmeld service update` remains available as a low-level diagnostic command,
640
+ not the primary recovery path for setup.
641
+
642
+ Agent View trace output is compact by default. Add `--details` to include
643
+ `selector` and `correlation`. `correlation.modelVersion` is
644
+ `openmeld.observability.wake.v1`; use the correlation chain to connect the client
645
+ message, source signal, dispatch, attempt, claim lease, binding, runtime,
646
+ result, published signal, reply signal, and Cloudflare evidence when present.
647
+
648
+ Use `openmeld service start --mode foreground` only when the user intentionally
649
+ wants OpenMeld Service running in the current terminal.
650
+
651
+ ### `openmeld doctor`
652
+
653
+ Check and optionally repair the local OpenMeld setup.
654
+
655
+ ```bash
656
+ openmeld doctor --view human
657
+ openmeld doctor --repair --view human
658
+ openmeld doctor --profile <profile-id>
659
+ ```
660
+
661
+ ## Stale Commands To Avoid
662
+
663
+ - Do not use `openmeld adapter ...`; use `openmeld agents ...` and `openmeld skills ...`.
664
+ - Do not use `openmeld space guidelines`; use `openmeld space guide`.
665
+ - Do not use `openmeld profile init`; use `openmeld profiles create`.
666
+ - Do not invent flags from memory. Verify with `openmeld <command> --help`.