From 3e7bedb6cca0ca9d90758660f30e157bb66cd13e Mon Sep 17 00:00:00 2001 From: Matt Miller Date: Tue, 14 Jul 2026 13:24:32 -0700 Subject: [PATCH 1/2] docs: clarify update/lifecycle entry points via help text (BE-3001) --- comfy_cli/cmdline.py | 13 ++++++++++--- comfy_cli/command/custom_nodes/command.py | 2 +- 2 files changed, 11 insertions(+), 4 deletions(-) diff --git a/comfy_cli/cmdline.py b/comfy_cli/cmdline.py index 4662b788..bd99154e 100644 --- a/comfy_cli/cmdline.py +++ b/comfy_cli/cmdline.py @@ -608,7 +608,7 @@ def install( rprint(f"ComfyUI is installed at: {comfy_path}") -@app.command(help="Update ComfyUI Environment [all|comfy|cli]") +@app.command(help="Update ComfyUI Environment [all|comfy|cli]. To update custom nodes, use `comfy node update`.") @tracking.track_command() def update( target: str = typer.Argument( @@ -1558,7 +1558,10 @@ def dependency(): depComp.install_deps() -@app.command(help="Download a standalone Python interpreter and dependencies based on an existing comfyui workspace") +@app.command( + help="Download a standalone Python interpreter and dependencies based on an existing comfyui workspace. " + "This bundles an interpreter; it does not update ComfyUI or custom nodes." +) @tracking.track_command() def standalone( cli_spec: Annotated[ @@ -1626,7 +1629,11 @@ def standalone( "preview", help="Render a previewable PNG from a media file (image → thumb, video → contact sheet, audio → waveform).", )(preview_command.preview_cmd) -app.add_typer(custom_nodes.manager_app, name="manager", help="Manage ComfyUI-Manager.") +app.add_typer( + custom_nodes.manager_app, + name="manager", + help="Enable/disable and configure ComfyUI-Manager (lifecycle, not updates).", +) app.add_typer(pr_command.app, name="pr-cache", help="Manage PR cache.") diff --git a/comfy_cli/command/custom_nodes/command.py b/comfy_cli/command/custom_nodes/command.py index 7f4b1c80..a0d434c3 100644 --- a/comfy_cli/command/custom_nodes/command.py +++ b/comfy_cli/command/custom_nodes/command.py @@ -743,7 +743,7 @@ def update_node_id_cache(): # `update, disable, enable, fix` allows `all` param -@app.command(help="Update custom nodes or ComfyUI") +@app.command(help="Update custom nodes or ComfyUI. To update ComfyUI itself or the CLI, use `comfy update`.") @tracking.track_command("node") def update( nodes: list[str] = typer.Argument( From d97d9d4d929a16392a8afd4c14be89740aef1acb Mon Sep 17 00:00:00 2001 From: Matt Miller Date: Fri, 17 Jul 2026 04:49:26 -0700 Subject: [PATCH 2/2] fix(help): escape brackets so `comfy update` shows its target list (BE-3001) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Rich parses square brackets in Typer `help=` as console markup, so `[all|comfy|cli]` was silently stripped from the rendered help. With this PR's appended cross-reference the panel read: Update ComfyUI Environment . To update custom nodes, use `comfy node update`. — the target list gone and a stray " ." left behind. Escaping the opening bracket makes it render literally: Update ComfyUI Environment [all|comfy|cli]. To update custom nodes, use `comfy node update`. Self-review finding; verified by rendering `comfy update --help`. Co-Authored-By: Claude Opus 4.8 --- comfy_cli/cmdline.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/comfy_cli/cmdline.py b/comfy_cli/cmdline.py index bd99154e..f8ac5852 100644 --- a/comfy_cli/cmdline.py +++ b/comfy_cli/cmdline.py @@ -608,7 +608,7 @@ def install( rprint(f"ComfyUI is installed at: {comfy_path}") -@app.command(help="Update ComfyUI Environment [all|comfy|cli]. To update custom nodes, use `comfy node update`.") +@app.command(help="Update ComfyUI Environment \\[all|comfy|cli]. To update custom nodes, use `comfy node update`.") @tracking.track_command() def update( target: str = typer.Argument(