Skip to main content

​
What it is

The ComfyTV Bot is a sidebar chat panel (the ✨ icon) backed by a local agent CLI. Every message you send spawns an agent turn that can use the full ComfyTV MCP toolset — and only that toolset: it can read and edit your canvas, run stages, inspect images, and manage your library, but it has no shell, no file system access, and no other tools. Typical asks:
  • “Add an image stage with Z-Image Turbo, prompt a neon cat at night, 16:9, and run it.”
  • “Use that image as the reference for a 5-second image-to-video, wait for it, and QC the first frame.”
  • “Look at my canvas and tell me why the video stage failed.”
  • “Open the Director timeline and re-take clip 3 with a slower camera.”
  • “I just linked a new workflow — bind seed, width and height for me.”

​
No API keys, by design

The bot does not talk to any model API directly and ComfyTV never stores a key. Instead it drives the agent CLI already installed on your machine — currently Claude Code — using whatever login that CLI has (e.g. your subscription). The provider layer is pluggable, so other local agent CLIs can be added later. Prerequisites:
  1. Install Claude Code and sign in once (npm install -g @anthropic-ai/claude-code, then claude → login).
  2. In ComfyTV Settings → Agent & MCP, enable MCP server and then ComfyTV Bot (the bot requires MCP — it’s how the agent reaches your canvas).
If no agent CLI is found, the panel shows an install guide instead of a chat box.

​
Using the panel

  • Conversations are persistent: the list supports pin, rename and delete; each chat remembers its full context across turns (the CLI resumes the same session).
  • Streaming: replies stream in live; tool calls appear as collapsible chips (e.g. add_stage, wait_stage) so you can watch it work the canvas in real time — nodes appear and run on your canvas as it goes.
  • Stop aborts the current turn; partial output is kept.
  • Switching sidebar tabs (or closing the panel) does not interrupt a running turn — the turn continues server-side and the transcript catches up when you return.

​
How it works, briefly

Each turn spawns a fresh CLI process in headless mode, locked down to the ComfyTV MCP server (--strict-mcp-config, tools whitelisted to mcp__comfytv__*), resuming the chat’s session for continuity. The conversation state lives with the CLI; ComfyTV’s database keeps a display mirror of the transcript. Canvas writes still follow MCP rules — an open ComfyTV tab executes them, so keep the tab open while the bot works.

​
Troubleshooting

​
See also

  • Agent access (MCP) — the toolset the bot uses, and how to connect external agents
  • Sidebar — the Settings panel with both switches