Desktop app for designing parametric 3D models in CadQuery together with the coding agent of your choice
TypeScript 3d-modeling3d-printing3d-printing-toolsagentagentic-aiai-cadcadcadqueryclaude-codecodexelectronfemllmmacdmakeropencodeparametric-designpythonsteptext-to-cad
Doku: Ordner-Modus und Agenten-Apps in Anleitung, Skill, Vorlage und Changelog
Kai-Jungsthoefel6be8640d793c
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex a26d2ee..79e44a9 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -8,6 +8,8 @@ the version is bumped.### Added+- "Open folder" uses SOMA in a folder of yours, for example a Git repository: viewer, skills, agent instructions and `soma`, without a .soma file. Before anything changes, SOMA lists the files it creates and changes, with Cancel. It adds a section to `AGENTS.md` and a line to `CLAUDE.md` (backed up first), leaves your Git history and `requirements.txt` alone, and never moves or deletes the folder.+- "Copy path for agent app" in the menu for new tabs copies the model folder, so an agent app such as Claude Desktop or the Codex app can work on the model. SOMA shows its changes, and `soma render` works from there too.- `soma anim build`, `info` and `check` warn about motion that plays back differently than written: jumps within one frame, turns so fast that they wobble between frames, and parts that are still hidden at the end.- `add_part(..., alpha=)` sets the opacity of a part. A reference with `alpha=1` is opaque, for scenery in animations such as a floor or a logo, and still stays out of `soma export --all`.diff --git a/CLAUDE.md b/CLAUDE.mdindex 23f473b..a99f410 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -19,7 +19,7 @@ A desktop app (Electron, TypeScript) in which a user designs 3D models in CadQueDetails in `app/README.md`.**`app/`** Electron app-- `src/main/` main process. Projects: `projects.ts` (save, open, history, export), `git.ts`, `zip.ts`, `workspace.ts`, `files.ts`, `watcher.ts`. Building and display: `build.ts` (prewarmed Python process), `previews.ts` (previews of versions and STEP files from the project), `measure.ts`, `dxf.ts` (E80), `drawings.ts` (document "Drawings", E97), `render.ts` + `bridge.ts` (`soma render`), `animations.ts`. Agent and skills: `terminals.ts`, `agents.ts`, `skills.ts`, `skilllibrary.ts` (own skills, E78). Environment: `packages.ts` (project environment, E67), `params.ts` (parameter panel, E74). App: `log.ts` (log file `logs/soma.log` in the app data, also catches `console.*`), `settings.ts`, `storage.ts`, `about.ts` (E81), `updates.ts` (new version on GitHub, E98), `help.ts` (E83), `dialogs.ts`.+- `src/main/` main process. Projects: `projects.ts` (save, open, history, export), `git.ts`, `zip.ts`, `workspace.ts`, `folders.ts` ("Open folder", a folder of the user as the model, E103), `files.ts`, `watcher.ts`. Building and display: `build.ts` (prewarmed Python process), `previews.ts` (previews of versions and STEP files from the project), `measure.ts`, `dxf.ts` (E80), `drawings.ts` (document "Drawings", E97), `render.ts` + `bridge.ts` (`soma render`), `animations.ts`. Agent and skills: `terminals.ts`, `agents.ts`, `skills.ts`, `skilllibrary.ts` (own skills, E78). Environment: `packages.ts` (project environment, E67), `params.ts` (parameter panel, E74). App: `log.ts` (log file `logs/soma.log` in the app data, also catches `console.*`), `settings.ts`, `storage.ts`, `about.ts` (E81), `updates.ts` (new version on GitHub, E98), `help.ts` (E83), `dialogs.ts`.- `src/preload/` the only bridge to the renderer.- `src/renderer/` interface, wired up in `main.ts`. Viewer: `viewer.ts`, `viewcube.ts`, `tree.ts` (structure tree, E82), tools `sectiontool.ts`, `explodetool.ts`, `measuretool.ts`, `markup.ts`. Panels: `code.ts`, `pdfview.ts`, `dxfview.ts`, `drawings.ts` + `drawlink.ts` (document "Drawings" and its link to 3D, E97), `markdown.ts`, `filetree.ts`, `versions.ts`, `fileview.ts` (STEP file from the project in the viewer), `terminals.ts`, `params.ts`, `skills.ts`, `help.ts`, `settings.ts` + `settingspages.ts`, `tutorial.ts` (guided tour, E94). Animation and analysis: `animtool.ts`, `animpanel.ts`, `animdata.ts`, `overlay.ts`, `resulttool.ts`, `resultview.ts`, `analysispanel.ts`, `videoview.ts`. Render window: `render.ts`/`render.html`. General: `ui.ts`, `icons.ts`, `busy.ts`, `shortcuts.ts`, `style.css`.- `src/shared/` `types.ts` (IPC contract), `settings.ts` (defaults, validation, mouse bindings, E81), `editable.ts`, `help.ts`, `skillname.ts`, `version.ts`.diff --git a/app/README.md b/app/README.mdindex 6539d35..0f4dedd 100644--- a/app/README.md+++ b/app/README.md@@ -76,7 +76,7 @@ SOMA_TEST_EXE="$LOCALAPPDATA/soma-dev/release/win-unpacked/SOMA.exe" node test/s| Pfad | Inhalt ||---|---|-| `src/main/` | Hauptprozess: `projects.ts` (offenes Projekt, Speichern, Öffnen, Verlauf, Wiederherstellen), `git.ts` (mitgeliefertes Git über dugite), `zip.ts` (Modelldatei .soma oder ZIP schreiben und sicher entpacken), `workspace.ts` (UUID-Arbeitsordner, Projektzustand doppelt, Projekt-Check nur melden), `build.ts` (Build als Einmal-Prozess mit Entprellung, Warteschlange, Zeitlimit, ein vorgewärmter Python-Prozess für alle Aufträge der App, gilt der letzte Build noch), `previews.ts` (Build als Vorschau eines Commits ablegen, STEP-Dateien des Projekts für den Viewer umwandeln, Cache nach Inhalt), `measure.ts` (langlebiger Python-Messdienst, `soma serve`), `skills.ts` (Bibliothek aus mitgelieferten und eigenen Skills, Stufen der Skills: Kopie nach `.soma/skills/`, bei Bedarf mit Hinweis, zwei Listen in `AGENTS.md`, Sicherung abweichender Kopien, Prüfung eines Skill-Texts), `help.ts` (Text und Bilder der Anleitung, Bilder nach `.soma/help/` im Projekt, E83), `skilllibrary.ts` (eigene Skills in den App-Daten für die Einstellungen: anlegen, speichern, zurücksetzen, löschen, importieren, mit Sicherung, E78), `settings.ts` (Einstellungen der App in `settings.json`, Kaputtes gemeldet und vor dem Ersetzen gesichert, E81), `log.ts` (Protokoll `logs/soma.log` in den App-Daten: `console.*` des Hauptprozesses und Fehler des Renderers, gescheiterte IPC-Anfragen, Builds, gestartete Agenten mit Version, ungefangene Ausnahmen; Rotation bei 2 MB, 3 alte Dateien), `storage.ts` (Größe der App-Daten je Bereich, Vorschau-Cache leeren, E81), `about.ts` (Versionen, Komponenten mit Lizenz, Python-Pakete aus den Metadaten, Text für Fehlermeldungen, E81), `updates.ts` (neueste Version unter GitHub Releases über `net.fetch`, einmal je Sitzung, abschaltbar, E98), `params.ts` (Werte des Nutzers in `parameters.json` lesen, prüfen und schreiben, E74), `dialogs.ts` (native Dialoge, im Test beantwortbar), `watcher.ts`, `terminals.ts` (node-pty, Projektumgebung, `soma` und `git` im PATH, `PIP_PYTHON`), `packages.ts` (Projektumgebung `.soma/env` anlegen lassen, fehlende Pakete aus `requirements.txt` installieren, E67), `files.ts` (Pfadschutz, Dateien nach `inputs/`, Markierungen nach `.soma/feedback/`, Schreiben aus dem Editor mit Konfliktprüfung und Sicherung), `dxf.ts` (DXF für die Ansicht über `soma dxfview`, nur bei geänderter Datei, E80), `agents.ts`, dazu für E58 `bridge.ts` (Verbindung für `soma render`: HTTP auf 127.0.0.1 mit Schlüssel, Adresse und Schlüssel auch in `bridge.json` der App-Daten für Agenten mit fremder Umgebung), `render.ts` (unsichtbares Render-Fenster, Aufträge nacheinander), `animations.ts` (Liste der Animationen und Ergebnisse, Bauen im Hintergrund) |+| `src/main/` | Hauptprozess: `projects.ts` (offenes Projekt, Speichern, Öffnen, Verlauf, Wiederherstellen), `git.ts` (mitgeliefertes Git über dugite), `zip.ts` (Modelldatei .soma oder ZIP schreiben und sicher entpacken), `workspace.ts` (UUID-Arbeitsordner, Projektzustand doppelt, Projekt-Check nur melden, geöffnete Ordner in `folders.json`), `folders.ts` (Ordner-Modus „Open folder“: was angelegt und geändert wird, Abschnitt in `AGENTS.md`, Verweis in `CLAUDE.md`, mit Sicherung, E103), `build.ts` (Build als Einmal-Prozess mit Entprellung, Warteschlange, Zeitlimit, ein vorgewärmter Python-Prozess für alle Aufträge der App, gilt der letzte Build noch), `previews.ts` (Build als Vorschau eines Commits ablegen, STEP-Dateien des Projekts für den Viewer umwandeln, Cache nach Inhalt), `measure.ts` (langlebiger Python-Messdienst, `soma serve`), `skills.ts` (Bibliothek aus mitgelieferten und eigenen Skills, Stufen der Skills: Kopie nach `.soma/skills/`, bei Bedarf mit Hinweis, zwei Listen in `AGENTS.md`, Sicherung abweichender Kopien, Prüfung eines Skill-Texts), `help.ts` (Text und Bilder der Anleitung, Bilder nach `.soma/help/` im Projekt, E83), `skilllibrary.ts` (eigene Skills in den App-Daten für die Einstellungen: anlegen, speichern, zurücksetzen, löschen, importieren, mit Sicherung, E78), `settings.ts` (Einstellungen der App in `settings.json`, Kaputtes gemeldet und vor dem Ersetzen gesichert, E81), `log.ts` (Protokoll `logs/soma.log` in den App-Daten: `console.*` des Hauptprozesses und Fehler des Renderers, gescheiterte IPC-Anfragen, Builds, gestartete Agenten mit Version, ungefangene Ausnahmen; Rotation bei 2 MB, 3 alte Dateien), `storage.ts` (Größe der App-Daten je Bereich, Vorschau-Cache leeren, E81), `about.ts` (Versionen, Komponenten mit Lizenz, Python-Pakete aus den Metadaten, Text für Fehlermeldungen, E81), `updates.ts` (neueste Version unter GitHub Releases über `net.fetch`, einmal je Sitzung, abschaltbar, E98), `params.ts` (Werte des Nutzers in `parameters.json` lesen, prüfen und schreiben, E74), `dialogs.ts` (native Dialoge, im Test beantwortbar), `watcher.ts`, `terminals.ts` (node-pty, Projektumgebung, `soma` und `git` im PATH, `PIP_PYTHON`), `packages.ts` (Projektumgebung `.soma/env` anlegen lassen, fehlende Pakete aus `requirements.txt` installieren, E67), `files.ts` (Pfadschutz, Dateien nach `inputs/`, Markierungen nach `.soma/feedback/`, Schreiben aus dem Editor mit Konfliktprüfung und Sicherung), `dxf.ts` (DXF für die Ansicht über `soma dxfview`, nur bei geänderter Datei, E80), `agents.ts`, dazu für E58 `bridge.ts` (Verbindung für `soma render`: HTTP auf 127.0.0.1 mit Schlüssel, Adresse und Schlüssel auch in `bridge.json` der App-Daten für Agenten mit fremder Umgebung), `render.ts` (unsichtbares Render-Fenster, Aufträge nacheinander), `animations.ts` (Liste der Animationen und Ergebnisse, Bauen im Hintergrund) || `src/preload/` | Schmale, feste Schnittstelle zum Renderer (kein Node-Zugriff dort), `render-preload.ts` für das Render-Fenster || `src/renderer/` | Oberfläche: `main.ts` (Verdrahtung: Kopfzeile mit Spalten-Schaltern, Seitenleiste und Code-Spalte, Reiter Analysis und Animation mit Punkt für Neues, Werkzeuge neben dem Strukturbaum, Menüs, Auswahl, Export, Übergabe an den Agenten auch per Ziehen ins Terminal, Startseite), `viewer.ts` (three.js, Klick auf Code, Ansichten, Drehpunkt, Mausbelegungen und orthografische Kamera (E81), Schnittebene mit gefüllter Schnittfläche und Kontur, verschobene Bauteile der Explosion mit Wegen, Strahltest der Demontage-Analyse mit BVH aus `three-mesh-bvh`, Vorschaubild, Bild für die Markierung), `viewcube.ts` (Ansichtswürfel in 3D), `sectiontool.ts` (Schnitt: Karte, Ebene, Text für den Agenten), `explodetool.ts` (Explosion: Demontage-Analyse mit Baugruppen und schrägen Richtungen, Elternteile, Lage, Abspielen Schritt für Schritt, Karte, Texte für den Agenten), `busy.ts` (Ladeanzeige über dem Viewer mit Fortschritt und Abbrechen, für die Analyse der Explosion), `skills.ts` (Skills in der Seitenleiste: Zeilen mit Stufen-Schalter, Karte daneben mit Einstellungen), `help.ts` (Hilfe über der App: Abschnitte der Anleitung, E83), `tutorial.ts` (geführte Tour, E94: Karte mit Schritt, Titel und Text, oranger Rahmen um das Element, Abdunklung aus vier Flächen, Klicks gehen durch, ohne Element Karte in der Mitte; die zehn Schritte am Modell „Tutorial“), `settings.ts` (Einstellungen über der App mit Reitern, Reiter „Skills“ mit Liste, Markdown-Editor, Vorschau und Prüfung beim Tippen, E78), `settingspages.ts` (Reiter Viewer, Shortcuts, Storage und About, E81), `params.ts` (Parameter in der Seitenleiste: Felder nach Art, Gruppen, Zurücksetzen auf den Wert aus dem Code, E74), `markup.ts` (Zeichenfläche der Markierung, Formen als bearbeitbare Objekte), `measuretool.ts` (Messen: Ablauf, Karte, Text für den Agenten), `tree.ts` (Strukturbaum oben links im Viewer, E82: ohne Hintergrund, Baumstriche, Gruppen, Auge und Transparenz vor dem Namen, Referenzen als Gruppe am Ende, Suche, F3, Mehrfachauswahl, Ziehen über die Augen), `shortcuts.ts` (Liste aller Tasten für den Reiter Shortcuts der Einstellungen), `code.ts` (Code-Spalte mit Editor: CodeMirror 6, Speichern auf Wunsch, Abgleich mit Änderungen des Agenten, Konflikte, Umschalter für Markdown), `dxfview.ts` (DXF-Ansicht im Code-Panel: Pfade auf einer Canvas, Zoom, Layer, Mark up view, E80), `drawings.ts` (Dokument „Drawings“, E97: alle Blätter aus `.soma/drawings/index.json` als ein PDF in der Code-Spalte, Kopf je Blatt, Treffer auf Ansichten und Maße über die Blatt-mm des Index, Karte zur Auswahl), `drawlink.ts` (Zeichnung und 3D: Kamera in Blickrichtung, Schnittebene ins Schnittwerkzeug, Maß als Punkte, Strecke und Maßzahl), `markdown.ts` (Markdown als Dokument: Tokens von `marked` direkt als DOM, ohne `innerHTML`), `filetree.ts` (Dateibaum in der Seitenleiste, offene Datei hervorgehoben), `versions.ts` (Verlaufsleiste), `fileview.ts` (STEP-Datei aus dem Projekt im Viewer: Banner, Neuladen bei Änderung, schließt sich mit der Versionsvorschau aus), `terminals.ts` (xterm.js, Tabs, Einklappen, Einfügen), `ui.ts` (Menüs, Meldungen, Helfer), `icons.ts` (Symbole), `style.css` (Farben mit fester Bedeutung, siehe Kopf der Datei) || `src/renderer/` (E58) | `animdata.ts` (Animation aus der glTF-Datei auswerten), `animtool.ts` (Abspielleiste unten im Bild), `animpanel.ts` (Reiter Animation: Liste mit Videos, Schritte, E82), `overlay.ts` (Untertitel, Beschriftungen, Legende auf einer 2D-Fläche, im Viewer wie im Video), `resultview.ts` und `resulttool.ts` (Ergebnisse farbig, Legende, Leiste und Beschriftungen im Bild), `analysispanel.ts` (Reiter Analysis: Liste und Bericht, E82), `videoview.ts` (Video-Player mit Standbild markieren), `render.html` und `render.ts` (unsichtbares Render-Fenster: Bild, Übersicht, MP4 mit WebCodecs und mediabunny) |@@ -86,7 +86,7 @@ SOMA_TEST_EXE="$LOCALAPPDATA/soma-dev/release/win-unpacked/SOMA.exe" node test/s| `resources/help/` | Bilder der Anleitung (E83) mit nummerierten Markierungen, erzeugt mit `npm run help:shots` (`test/helpshots.mjs`, Ausschnitte und Nummern in `test/helpshots-spec.mjs`). Der Text ist der Skill `resources/skills/soma-app.md`, die Liste unter jedem Bild nennt dieselben Bezeichnungen wie die Markierungen (`npm run test:unit` prüft das) || `resources/icon.*` | App-Icon (E44) für Fenster und Taskleiste: `icon.svg` als Vorlage, `icon.ico` (16 bis 256 px) und `icon.png`. Neu erzeugen mit `python scripts/make-icon.py` (braucht Edge und Pillow, kleine Größen bekommen einen dickeren Strich) || `../python/soma/` | Hilfsbibliothek und Kommandozeile (`soma build`, `soma export`, `soma glb` für Vorschauen, `soma serve` Messdienst, `soma warm` vorgewärmter Prozess der App, `soma env` und `env.py` Projektumgebung und `requirements.txt` (E67), `measure.py` exakte Werte mit OCC, `fasteners.py` Normteile mit Tabellen aus bd_warehouse in `data/fasteners/`, `cqcompat.py` Kompatibilitätsmodus für CadQuery-Skripte ohne `add_part` (E100), `cqexport.py` mit `soma cadquery export|import` und `cqruntime.py` als Block exportierter Skripte (Apache 2.0, E101), `anim.py` und `animrun.py` Animationen mit `soma anim`, `analysis.py` Auswertungen mit `soma analyze`, `fem.py` Festigkeit mit `soma analyze fem` (gmsh, Kontakt, Schrauben mit Vorspannung, eigener Solver mit pyamg als Rückfall), `ccx.py` CalculiX als Rechenwerk (E84), `render.py` Auftrag an die App für `soma render`, `drawing.py` und `drawrun.py` technische Zeichnungen mit `soma drawing` (E76: HLR aus OCP, DXF mit ezdxf, PDF und PNG über matplotlib, Prüfung), `dxfview.py` DXF für die Ansicht der App mit `soma dxfview` (E80, Zeichenmodul von ezdxf), `gltf.py` GLB-Schreiber, `progress.py` Fortschritt langer Befehle) |-| `test/` | `smoke.mjs`, `versions.mjs`, `editor.mjs`, `measure.mjs`, `stepview.mjs`, `cadquery.mjs`, `groups.mjs`, `section.mjs`, `explode.mjs`, `skills.mjs`, `params.mjs`, `tutorial.mjs`, `updates.mjs`, `fasteners.mjs`, `drawing.mjs`, `drawview.mjs`, `dxf.mjs`, `animation.mjs` (Ende-zu-Ende), `unit.mjs` (ohne Electron), `buildlock.mjs` (Sperre von `soma build`, nur Python), `harness.mjs` (App starten und steuern), `cdp.mjs` (kleiner DevTools-Client, puppeteer scheitert an Electron 44) |+| `test/` | `smoke.mjs`, `versions.mjs`, `editor.mjs`, `measure.mjs`, `stepview.mjs`, `cadquery.mjs`, `folder.mjs` (Ordner-Modus), `groups.mjs`, `section.mjs`, `explode.mjs`, `skills.mjs`, `params.mjs`, `tutorial.mjs`, `updates.mjs`, `fasteners.mjs`, `drawing.mjs`, `drawview.mjs`, `dxf.mjs`, `animation.mjs` (Ende-zu-Ende), `unit.mjs` (ohne Electron), `buildlock.mjs` (Sperre von `soma build`, nur Python), `harness.mjs` (App starten und steuern), `cdp.mjs` (kleiner DevTools-Client, puppeteer scheitert an Electron 44) |## Noch nicht enthaltendiff --git a/app/resources/help/agent.png b/app/resources/help/agent.pngindex 55c39a4..7cf4de3 100644Binary files a/app/resources/help/agent.png and b/app/resources/help/agent.png differdiff --git a/app/resources/skills/shell-environment.md b/app/resources/skills/shell-environment.mdindex 869888a..833a9ad 100644--- a/app/resources/skills/shell-environment.md+++ b/app/resources/skills/shell-environment.md@@ -13,7 +13,8 @@ topics: Why it happens; Running soma; Installing packages; Reading files in Wind## Why it happensThe app's terminals put `soma`, `pip` and the model's own Python environment on the PATH. Some agents run their-commands somewhere else, for example in a background service that kept the environment of another program. Then+commands somewhere else, for example in a background service that kept the environment of another program,+or in an agent app such as Claude Desktop or the Codex app that has this folder open. Then`soma` is missing or another `pip` answers. The working folder is still the model's folder, so call everythingthrough the model's environment directly.diff --git a/app/resources/skills/soma-app.md b/app/resources/skills/soma-app.mdindex 6e39bcf..e5cfe29 100644--- a/app/resources/skills/soma-app.md+++ b/app/resources/skills/soma-app.md@@ -45,7 +45,7 @@ The logo at the top left opens the start page.-1. **New model**: starts from a small example (a box with a lid) and opens a terminal in the model folder (Ctrl N). The arrow next to it also offers **From CadQuery script**, which starts from an existing CadQuery script instead (see "CadQuery scripts").+1. **New model**: starts from a small example (a box with a lid) and opens a terminal in the model folder (Ctrl N). The arrow next to it also offers **From CadQuery script**, which starts from an existing CadQuery script instead (see "CadQuery scripts"), and **Open folder**, which uses SOMA in a folder of yours (see "Your own folder").2. **Open**: opens a .soma or ZIP file (Ctrl O).3. **Tutorial**: a short guided tour of the app with an example model. No agent needed. The cross hides the card.4. **Recent**: models you worked on, the newest first. The field above filters them by name. "Open" marks the model that is open right now, "never saved" one that was never saved as a .soma file. The bin on a card removes the model from this computer, a saved .soma file stays.@@ -74,6 +74,8 @@ disappears like any new model you did not change.2. **New tab**: opens the menu below.3. **Start agent**: starts one of the agents found on this computer.4. **Empty terminal**: a plain command line, for example for `soma build`.+5. **Copy path for agent app**: copies the model folder. Open it in an agent app such as Claude Desktop or the Codex+ app, and SOMA shows its changes like those of an agent in a tab.Type your wishes into the agent and press Enter. Everything with **Send to agent** (a part, a measurement, an error,a drawing) puts a short note into the agent's input. Add your own words, then press Enter. You can also drag a file@@ -201,6 +203,25 @@ SOMA works with plain CadQuery scripts in both directions.The block and the standard parts are under the Apache License 2.0, so the exported script is yours like any model.+## Your own folder++**Open folder** (model menu, or the arrow next to New model) uses SOMA in a folder of yours, for example a Git repository.+The folder itself is the model: there is no .soma file to save, and your files stay where they are.++- **Entry point:** `model.py` if there is one. Otherwise SOMA asks which script builds the model (plain CadQuery with+ `show_object` or `result` works too), or creates `model.py` from the template.+- **Before anything changes**, SOMA lists what it creates and what it changes, with Cancel. It creates `.soma/` (app+ data, cache and skills, with its own `.gitignore` for the intermediate results) and `output/`. It adds a marked section+ for SOMA to `AGENTS.md` and a line pointing to it to `CLAUDE.md`, or creates the two files. Changed files are backed up+ first. Packages the model needs go into `.soma/requirements.txt`, a `requirements.txt` of yours stays as it is.+- **Git:** SOMA creates no repository and commits nothing here. If the folder is a repository, the history shows its+ commits. A version shows in the viewer if its commit contains `output/model.step`. **Restore** is not available:+ commit yourself or ask the agent.+- **Saving:** Ctrl S writes the editor's changes into the folder. **Export › Everything as ZIP** makes a copy as a file,+ without the Git history.+- **Start page:** the card says "Folder". The bin only removes it from the list, the folder stays. If you move or rename+ the folder, the card says "folder missing": open it again with **Open folder** at its new place.+## Settingsdiff --git a/app/resources/template/AGENTS.md b/app/resources/template/AGENTS.mdindex 47c5b9f..7c898c6 100644--- a/app/resources/template/AGENTS.md+++ b/app/resources/template/AGENTS.md@@ -41,7 +41,7 @@ Run them in this terminal. They work without the app.| `soma build` | Runs `model.py`, writes `output/model.step` and the viewer cache. **Run it after every change and read the result.** On errors it prints the file, line and message || `soma export <Part> --format stl` | Exports one part (formats: step, stl, 3mf, amf, brep, iges, obj, vrml, glb, gltf, dxf, svg) || `soma export --all --format step` | Exports all parts except references |-| `soma render` | Saves a picture of the current model to `renders/view-iso.png` (`--view top` or a direction `--view=1,-2,1`, `--hide`/`--only` parts or groups, `--fit` parts, `--zoom 2`, `--size 1280x800`, `--out`). **Open the picture and look at it** to check your work, also inside: hide what is in the way. Works only in the terminals of the app, it renders with the app's viewer |+| `soma render` | Saves a picture of the current model to `renders/view-iso.png` (`--view top` or a direction `--view=1,-2,1`, `--hide`/`--only` parts or groups, `--fit` parts, `--zoom 2`, `--size 1280x800`, `--out`). **Open the picture and look at it** to check your work, also inside: hide what is in the way. Needs the app with this model open, it renders with the app's viewer || `soma analyze overhang` (or `thickness`, `clearance`) | Value at every spot of the surface with a summary per part. Details in the skill for analysis || `soma analyze fem analyses/x.py` | Stresses, safety and deflection under a load case described in `analyses/x.py`. Details in the skill for FEM || `soma anim build`, `soma anim info "Name"` | Animations from `animations/`. Details in the skill for animation |