Handbook · Author chat

Author chat in the editor

Where in the UI. Header → Author / Chat. Confirm banner applies writes. Do not start a second local editor server for live MCP.

Author chat is not a second product. It calls the same tools as containd-author and the MCP server. You bring your own API key (OpenAI-compatible; localStorage in the editor).

Read tools

context, validate, advise, describe_blocks, recipes, inspect_script, layout_describe, retrieve_docs, list_docs. It should look these up instead of guessing Blockly ids.

Writes

Only propose_apply, propose_rename_entity, propose_identity_cleanup, propose_smoke_fix. A confirm UI must run before the workspace changes. Blockly remains source of truth for scripts; the agent should prefer recipes over invented JS.

Tool tables: Author tools.