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.
wiki: document MCP URL client transports (v0.20.0-alpha, #41) Closes the v0.20.0 documentation gap (its wiki banner bump was skipped, so the feature was never written up). - MCP-Integration: new "Connecting by URL (HTTP/SSE)" section — sse vs http (Streamable HTTP) transports, url/headers config, mutual-TLS fields (ca_bundle/client_cert/client_key), the https-always / http-loopback-only rule, and the 30s handshake vs per-server timeout. Overview + transport.py role updated to mention the client transports. - Configuration: add transport/timeout rows to the MCP Server Entry Format table + a pointer to the URL section.
wiki: v0.21.0-alpha — managed backups dir + auto-save fix - Home: bump latest-release banner to v0.21.0-alpha (also folds in the skipped v0.20.0-alpha MCP-URL-client release into the builds-on chain). - Configuration: document the retention family in the config reference — max_backups (new in v0.21.0) plus the previously-undocumented max_saved_conversations / max_session_logs / max_retention_age_days. - Architecture: note that execute_code auto-save snapshots now live in the managed <FreeCADAI dir>/backups/ dir, not beside the user's document.
wiki: bump latest-release banner to v0.19.0-alpha
Home: bump banner to v0.18.0-alpha
Home: bump latest-release banner to v0.17.0-alpha (HTTP/SSE MCP transport)
Home: bump latest-release banner to v0.16.5-alpha (#30 temperature fix)
Home: bump Latest release banner to v0.16.4-alpha
Home: bump Latest release banner to v0.16.3-alpha Sandbox reliability fixes (#18 empty-sketch null-shape, #14 headless Gui.ActiveDocument stub). Tool count unchanged (53) — both are bugfixes.
docs(config): execution_timeout default 60->30 (v0.16.2-alpha, #14) The real #14 fix (v0.16.2-alpha) was the sandbox harness no longer hanging on opened documents; with that fixed the default returned to 30s. The setting remains for heavy ops on large models.
docs(config): document Code execution timeout setting (v0.16.1-alpha, #14) Add the new execution_timeout setting to both the GUI settings table and the config.json reference table. Configurable code-execution timeout (default 60, range 5-600s) shipped in v0.16.1-alpha for issue #14.
docs(wiki): v0.16.0-alpha release banner + tool count 50->53 Update Home landing-page release banner to v0.16.0-alpha (datum-geometry & transform suite) and bump the built-in-tool count from 50 to 53 (create_datum_plane, create_datum_line, duplicate_object). Sync the Tool-Reranking headline count too. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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): add latest-release banner (v0.15.2-alpha) to Home Home had no version reference. Add a "Latest release" line linking to the v0.15.2-alpha release and the CHANGELOG. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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): bump tested FreeCAD version to 1.1.1 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
docs(wiki): refresh default Anthropic model and FreeCAD 1.1+ install paths (v0.15.1-alpha) - Configuration / Getting-Started / FAQ: default Anthropic model claude-sonnet-4-20250514 -> claude-sonnet-4-6, and refreshed the available-models lists (opus-4-8, haiku-4-5) to match v0.15.1-alpha (issue #15). Also fixed the stale "claude-sonnet-4-latest" CLI comment. - Installation: documented FreeCAD 1.1+ version-scoped Mod dirs (~/.local/share/FreeCAD/v1.1/Mod/) with a per-platform table and an "installed but doesn't appear" troubleshooting bullet (issue #14). Tool-Reference needed no changes — no tool behavior or signature changed; the #14 sandbox-timeout fix is internal and no specific timeout value was ever documented there. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
docs(wiki): document Up/Down input history and fix Stop-button description (v0.15.0-alpha) The pre-existing "Up arrow recalls previous message" line was aspirational — nothing implemented it. v0.15.0-alpha actually ships shell-style history (walks all prior user messages in the current conversation, draft preservation, caret-position gated). Also corrects the Stop control: it's the Send button morphing, not a separate appearing button. Co-Authored-By: Claude Opus 4.7 (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: v0.14.3-alpha — custom provider persistence fix (#12) FAQ entry covering the symptom (selector reverts to Anthropic on restart while custom URL/model values stay) and the root cause: the ParamGet mirror only encodes 11 providers; non-prefs providers left a stale ProviderIndex that shadowed the JSON, and the dialog's preset application wiped fields on switch-to-Custom because the preset ships empty strings. Cross-link from the Custom-provider section in Configuration.md. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
docs: v0.14.1+v0.14.2-alpha — github reranker default, theme troubleshooting - Configuration.md / Tool-Reranking.md: document the github provider's keyword-reranker default (top_n=8), applied only when the reranker UI is at factory state. Covers v0.14.1-alpha which skipped wiki updates. - FAQ.md: add a Troubleshooting entry for the chat panel painting dark on a light-themed FreeCAD (Linux + dark host Qt theme), pointing to v0.14.2-alpha as the fix and noting the custom-theme fallback caveat. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
docs: refresh Settings dialog screenshots for v0.14.0-alpha Captures the new Editor section, the New.../Edit... buttons in User Tools and Hooks, and the layout shift (System Prompt now in image 1, Editor straddles 2 and 3). Captions updated to match the sections actually visible in each image.
docs: v0.14.0-alpha — New/Edit buttons + editor preference Documents the New... / Edit... buttons added to Settings > User Tools and Settings > Hooks, plus the new Settings > Editor section that controls whether files open in FreeCAD's docked Python editor (default) or via the OS file association. Adds use_external_editor to the schema and field reference, and updates Creating-Custom-Tools quick start to recommend Settings > User Tools > New... as the primary path.
docs: v0.13.0-alpha — Configuration paths section, <FreeCADAI dir> placeholder Document the new path resolution (<FreeCAD user config dir>/FreeCADAI/ on FreeCAD 1.1+ Linux: ~/.config/FreeCAD/v1-1/FreeCADAI/) and the rename-then- move-plus-sweep migration in Configuration.md. Switch literal ~/.config/FreeCAD/FreeCADAI/ references to <FreeCADAI dir> placeholder across Architecture, Skills, Skills-Reference, Creating-Skills, Creating- Custom-Tools, Tool-Reranking, MCP-Integration, AGENTS-md, Getting-Started, FAQ. Architecture and Getting-Started link back to Configuration#configuration-paths. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
docs: v0.12.0-alpha — Edit -> Preferences page, cross-OS API keys - Configuration.md: new "FreeCAD Preferences Page" section explaining the Edit -> Preferences -> FreeCAD AI entry point, the 8 mirrored fields, and the JSON <-> ParamGet bridge that keeps the new page in sync with the existing AI Settings dialog. - Configuration.md: Dynamic API Keys gets the maintainer-untested disclaimer plus split sections for `file:` and `cmd:` with cross-OS examples (Linux secret-tool, macOS security, Windows CredentialManager / GPG / DPAPI). - Installation.md: Method 3 updated from "not available" to "submission in progress" with link to Addon Academy quality requirements. - Home.md: feature bullet for FreeCAD-native preferences. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
docs: capability detection, Plan-mode Check/Fix-with-AI, persistent dock Catches the wiki up to v0.11.0-alpha and v0.11.1-alpha: - Configuration.md: document Ollama /api/show capability detection (vision/tools/thinking) vs OCR probe path for other providers. Add tools_detected, thinking_detected, chat_dock_geometry, chat_dock_mw_state to schema and field reference. Note that detection results are persisted across sessions. - Getting-Started.md: add Review Code dialog section explaining the Edit/Check/Fix-with-AI/Execute buttons and the auto-attached viewport on error retries. - Home.md: refresh feature bullets for persistent dock layout, Plan-mode validation, and capability-aware vision routing. Edit -> Preferences page and ParamGet bridge work on master is not documented here yet; that ships with v0.12.0-alpha. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>