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.
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): 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 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>
docs: refresh Settings dialog screenshots with Tool Reranking section Update captions to reflect current section layout (Provider + Model Parameters / Behavior + System Prompt + Tool Reranking / MCP + User Tools + Skills + Hooks + Test Connection). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
docs: reranker model params, Ollama /v1 gotcha, test outcomes - Configuration: /v1 vs /api Ollama warning in the main Ollama setup section, with both endpoint classes explained - Tool-Reranking: always-editable params table behavior, Test Reranker button with three outcome states, model selection guidance for Ollama rerankers (which models echo control tags, which work well) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
docs: tool reranking page (keyword + LLM) Covers the two reranker methods, the robustness contract, user/MCP tool handling, quality tips for custom tools, known lexical blind spots in the keyword path, and the LLM-reranker provider override. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
docs: document file attachments and file_attach hook - Add file_attach event to hooks documentation (events table, context keys, return values) - Add example PDF hook section with installation instructions and zero-dependencies design rationale - Update Attach button docs: text files, binary detection, drag-and-drop across entire chat panel Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
docs: document Model Parameters table and Strip Thinking History - Updated Parameters Section → Model Parameters Section with per-model sampling parameters table explanation and rationale - Added Strip Thinking History section explaining tristate checkbox, auto-detection, and when to change it - Updated config schema with model_params and strip_thinking_history - Updated Field Reference table - Updated Moonshot note (no longer "locked", now editable defaults) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
docs: update Settings screenshots (3 images for full dialog) Dialog now has too many sections for two screenshots. Third image covers User Tools, Skills, Hooks, and Test Connection. 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: update Settings dialog screenshots and Behavior section - New screenshots showing System Prompt section, tool calling checkbox, and current UI layout - Added "Model supports tool calling" to Behavior section table 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: update provider table for v0.4.0-alpha (22 providers) Add all 16 new providers to the comparison table with their default models and notes. Add Moonshot parameter constraints section. Update provider.name field reference. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Add Dynamic API Keys documentation (file: and cmd: prefixes) Explains OAuth/dynamic token support: file:/path reads token from file, cmd:command runs a shell command. Includes examples for gcloud, Azure, and cron-based refresh scripts. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Update settings dialog screenshots (now scrollable, two images) Settings dialog is now too tall for one screenshot. Split into: - settings-dialog.png: top half (Provider, Parameters, Behavior, MCP) - settings-dialog-2.png: bottom half (MCP buttons, User Tools, Hooks) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Document hooks system, context window, and hooks_disabled config field - Added Hooks section: structure, writing hooks, events table, return values, context keys, managing hooks in Settings, built-in hooks - Added Context Window to Parameters section - Added context_window and hooks_disabled to JSON schema and field reference - Added hooks directory to Other Configuration Directories table Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Document skill optimizer settings, workflow, and version history Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Add llm-vision-mcp installation and configuration guide Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Document vision routing, image controls, and vision config fields Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Document Capture button states and viewport capture config fields Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>