Add Note

Add Note is the chat message of the comfyui_vfx-flow pack - the small, unglamorous node you bolt onto the end of a workflow so that when a render comes out, the person who needs to know about it actually gets told. It posts a note to your Autodesk Flow site, attached to the shot, task, or version you're working on, and it lands in Flow's activity stream just like a note anyone else in the studio would write.

Why bother? Because in a production pipeline, "this comp is done, please review" is a piece of data, not a Slack message. It has to be attached to the right shot, visible to the right people, and searchable later. If Publish to Flow is how your render becomes a version, Add Note is how that version gets context - a subject line, a note, a heads-up that shows up in review.

How it works

You feed it the flow pipe, write the note_text, and pick where the note lands. It creates a Note record in Flow linked to whatever you chose, with your user as the author when the context knows who you are.

The inputs that matter:

• note_text - the body. Multiline, so write something real.
• subject - the note's subject line, default ComfyUI Note. Change it; "ComfyUI Note" is how you get ignored by your coordinator.
• attach_to - shot (default), task, or version.
• version_id - only needed when attach_to is version. This is the intended wiring: connect Publish to Flow's version_id output here, and your note pins to the exact version you just published.

And the one that will bite you:

• do_post defaults to false. Same safety-toggle philosophy as Publish to Flow's do_publish. Nothing gets written to the shared database until you flip it on. Run a workflow with it off and you get a polite "Note not posted" message instead of a note - which is the feature, not a bug, but it will confuse you exactly once.

Outputs: note_id (STRING - the created note's ID, empty if you didn't post) and info (STRING - confirmation with the note ID and what it attached to, or the skip/error message).

Installing it

Same as the whole pack: ComfyUI Manager, search VFX Flow, install, restart. Or:

cd ComfyUI/custom_nodes
git clone https://github.com/beverlyhillscop90210/comfyui_vfx-flow
cd comfyui_vfx-flow
pip install -r requirements.txt

Only shotgun_api3>=3.3.0; no model downloads.

Where people get burned

• do_post off. It's the most common "why didn't my note post" - the toggle is off by design. Check it before assuming the node is broken.
• "No valid entity to attach to". For attach_to: task you need a task in the context (Task Selector has to have run and actually propagated it); for version you need a version_id. With shot it'll attach to the shot from the pipe - the most forgiving option.
• Empty note text is rejected outright, which is honestly good manners.

Add Note is a two-minute addition to a publish workflow, and it's the difference between producing versions and producing communicated versions. Small node, real pipeline value - flip do_post on and let the review trail start itself.