wiki: document connecting external MCP clients (#55) mcp_server_http.py was documented nowhere — not in the wiki, not in the README — despite being the better of the two entry points for interactive work, since FreeCAD is already running with your document open and you watch changes land in the viewport. The only worked example was Claude Desktop JSON over STDIO. Adds HTTP/SSE and STDIO sections with Claude Code CLI recipes, frames the two entry points by who owns the FreeCAD process, and records the session-start gotcha (Claude Code loads MCP tools at launch, so a mid-session add is invisible until the next one). Both paths verified end-to-end against FreeCAD 1.1.1 AppImage: SSE handshake → tools/list → tools/call, and the STDIO equivalent through the bash -c wrapper. The Flatpak invocation is credited to @s-light as contributor-verified, since this box only runs the AppImage. Also corrects the built-in tool count in three places: 33 → 56, counted from a live tools/list response rather than by grepping the source.
wiki: v0.21.2-alpha — release banner, sandbox Gui stub, list_documents flag Banner had been left at v0.21.0-alpha, so v0.21.1-alpha never landed here either; the new one covers both. Documents two behaviour details users can actually trip over: - The sandbox pre-check now installs a fake FreeCADGui defining only ActiveDocument, SendMsgToActiveView and updateGui. Every other Gui attribute raises AttributeError there — notably Gui.Selection and Gui.getDocument, which the real module provides. Verified against the stub: types.ModuleType has no __getattr__ fallback, so the no-op absorption applies only *below* Gui.ActiveDocument, not to the module itself. - list_documents' modified flag now reads Gui.getDocument(name).Modified and falls back to False with no GUI, so documents never show as modified over the headless STDIO MCP server.
docs(tool-reference): transform_object relative mode + duplicate_object entry
docs(tool-reference): add create_datum_line entry
docs(tool-reference): create_datum_plane
docs(tool-reference): create_sketch support/face attachment
docs(wiki): boolean_operation preserves parametric history (v0.15.2) Document that boolean_operation between two PartDesign Bodies now uses a parametric PartDesign::Boolean (history preserved) rather than a Part::Cut that collapsed the base Body's feature tree. Removes the now-false note that booleans "do not work directly with PartDesign bodies", and adds guidance to prefer in-Body subtractive features for drilling into a single solid. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
docs(wiki): document run_macro tool, Max tool-loop turns, and Dangerous mode (#13) - Tool-Reference: add run_macro entry; update tool count 50 → 51. - Configuration: add Max tool-loop turns row to Behavior section. - New page: Dangerous Mode — risks, how to arm, session scope, hand-edit persistence escape hatch, when it's the right tool. - _Sidebar: link the new page under Reference. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
docs: add edit_sketch tool and sketch-from-image skill - Add edit_sketch to Tool-Reference (clear_all, constraint overwrite, Y-axis) - Update create_sketch notes: auto-constraining, overwrite, Y-axis warning - Add sketch-from-image to Skills and Skills-Reference (early development) - Update tool count 48→50, skill count 6→7 (8→9 in reference) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
docs: add 11 new tools to Tool-Reference for v0.8.0-alpha Added: list_faces, list_edges, list_documents, switch_document, describe_model, create_variable_set, create_spreadsheet, set_expression. Updated fillet_edges/chamfer_edges with filter keywords. Updated modify_property with relative expressions. Tool count: 48 (was 37). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
docs: add assembly tools to Tool Reference Add create_assembly, add_assembly_joint, add_part_to_assembly with parameter tables, examples, joint type guide, and Ball joint warning. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
docs: add redo, undo_history, describe_model, Skills section Tool-Reference: updated undo with "until" param, added redo, undo_history, and describe_model tool docs. Configuration: added Skills section documentation, updated dialog section list. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
docs: add use_skill tool, system prompt section, config field - Tool-Reference: add use_skill tool documentation - Configuration: add System Prompt section, system_prompt_override field reference, add to config schema example Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
docs: add geometry validation, report_skill_params, VALIDATION.md documentation - Tool Reference: add report_skill_params tool (34 tools total) - Creating Skills: add VALIDATION.md section with format, check types, expressions, tolerances, conditional rules, --validate usage - Creating Skills: add VALIDATION.md to directory structure Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Add 12 missing tools to Tool-Reference.md (21 → 33) Modeling: shell_object, linear_pattern, polar_pattern, mirror_feature, multi_transform, scale_object, section_object, create_wedge Interactive: select_geometry Viewport: capture_viewport, set_view, zoom_object Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Fix image paths to use absolute raw GitHub wiki URLs GitHub wiki doesn't serve images from relative paths. Changed all image references from images/file.png to the absolute raw URL: https://raw.githubusercontent.com/wiki/ghbalf/freecad-ai/images/file.png Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add FreeCAD screenshots and embed in wiki pages 3D viewport screenshots (generated via FreeCAD scripted capture): - simple-box.png, box-fillets.png: Tutorial Simple Box - enclosure-base.png, enclosure-assembled.png: Tutorial Enclosure - boolean-fuse.png: Tool Reference boolean operations - fillet-vs-chamfer.png: Tool Reference fillet/chamfer UI screenshots (captured via Qt widget grab): - workbench-active.png: Full FreeCAD window with AI workbench - chat-panel.png: AI chat dock widget close-up - chat-panel-full.png: Full window with chat visible - settings-dialog.png: Settings dialog showing all sections Image references added to: Home, Getting-Started, Configuration, Tool-Reference, Tutorial Simple Box, Tutorial Enclosure. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add complete wiki documentation (16 pages) Covers installation, configuration, getting started, tool reference (21 tools), skills system (6 built-in skills), AGENTS.md, MCP integration, architecture, 3 tutorials (simple box, enclosure, gear), and FAQ/troubleshooting.