Verktyg för smide

Teknisk guide

Den här guiden är för dig som vill använda verkstadsverktyget i ett eget GitHub-repo eller med OpenAI Codex, GitHub Copilot Cloud Agent eller Cursor Cloud Agents. Om du bara vill komma igång i Claude behöver du inte följa stegen här.

Viktigt: verktyget fungerar inte i en vanlig ChatGPT-chatt. Du behöver en kodagent som kan öppna ett GitHub-repo, köra Linux-kommandon, installera FreeCAD och lämna tillbaka filer. Instruktionerna kontrollerades den 21 oktober 2026, men leverantörernas menynamn kan ändras.

Du behöver

Ett GitHub-konto.
Ett privat repo när du arbetar med riktiga kunduppgifter.
Codex Cloud, betald GitHub Copilot eller Cursor med Cloud Agents.
Cirka 10–15 minuter första gången.

Välj en av två vägar

Rekommenderat för Codex, Copilot och CursorImportera hela originalrepot som en privat kopia. Då följer de färdiga miljöfilerna med.
För ett befintligt eget repoAnvänd installationsprompten längre ned. Agenten lägger då till skillen och skapar de miljöfiler som behövs.

Fyra ord i guiden

Repo: Projektmappen på GitHub där filer och inställningar sparas.
Gren: En separat version av repot där agenten gör sitt arbete.
Pull request: En sida på GitHub där du kan granska och hämta agentens resultat.
Miljö: Datorn i molnet där agenten installerar FreeCAD och kör verktyget.

Rekommenderat: importera en privat kopia

Codex, Copilot och Cursor lämnar ofta resultatet som en gren eller pull request på GitHub. Därför behöver du en egen privat kopia av repot. En fork av ett publikt repo är normalt publik, och där ska inga kunduppgifter ligga. Gå till github.com/new/import, klistra in https://github.com/richalund/Steelworks-shopdrawings, ge kopian ett namn, välj Private och tryck Begin import.

Välj den agent du vill använda

Tryck på Codex, GitHub Copilot eller Cursor för att visa instruktionerna för just den agenten.

OpenAI Codex i ChatGPT – inte vanlig ChatGPT

Använd Codex på webben eller i ChatGPT-datorappen. En vanlig ChatGPT-chatt kan inte installera FreeCAD eller köra projektets skript. En ny molnmiljö skapas på webben eller i datorappen; mobilen kan använda en miljö först efter att den har publicerats.

Öppna chatgpt.com/codex eller välj Codex i ChatGPT-datorappen. Anslut GitHub när du blir ombedd och ge åtkomst till din privata kopia av repot.
Starta en ny uppgift och välj Work in → Cloud → Select environment → Create environment. Välj ditt repo och tryck Get started.
Be Codex läsa AGENTS.md, installera FreeCAD och testa verktyget. Om installationskommandot behöver anges manuellt använder du bash .claude/skills/freecad-styrning/scripts/installera_linux.sh.
Slå på Allow Codex to access internet. Välj Package managers och lägg till de extra domänerna i nätverksavsnittet nedan.
Vänta tills installationen och testet lyckas. Granska rapporten, spara och välj Publish. Vänta på meddelandet Environment published.
Välj Start a new task i den publicerade miljön. Skriv till exempel: ”Läs AGENTS.md och rita en testgrind, 1000 bred och 1100 hög. Lägg PDF och bilder i leverans/testgrind och skapa en pull request.”

Aktuell hjälp finns i OpenAI:s guide till Codex Cloud-miljöer.

GitHub Copilot Cloud Agent – GitHub Mobile eller GitHub.com

Copilot Cloud Agent kräver ett betalt Copilot-abonnemang och måste vara aktiverad för repot.

I GitHub Mobile: öppna agentknappen längst ned till höger och välj New Session. På datorn kan du använda github.com/copilot/agents.
Välj din privata kopia av repot, skriv uppgiften och be Copilot skapa en pull request.
Installationen körs automatiskt från .github/workflows/copilot-setup-steps.yml. Om installationen misslyckas öppnar du sessionens logg eller kör arbetsflödet manuellt under Actions → Copilot Setup Steps.
För uppslag under själva ritningsarbetet: öppna repots Settings → Copilot → Internet access och lägg till eurocodeapplied.com samt de leverantörssidor som behövs. Installationsstegen körs separat och omfattas inte av agentens brandvägg.
Testa med: ”Läs AGENTS.md och rita en testgrind, 1000 bred och 1100 hög. Lägg PDF och bilder i leverans/testgrind och öppna en pull request.”

Se även GitHubs guide till Copilot Cloud Agent på mobilen.

Cursor Cloud Agents – Cursor-appen eller cursor.com/agents

Du behöver ett Cursor-abonnemang med tillgång till Cloud Agents. Skapa och testa miljön på webben eller i datorappen innan du startar jobb från mobilen.

Öppna cursor.com/agents eller Cloud Agents i Cursor och anslut GitHub. Välj din privata kopia av repot.
Skapa en miljö och välj uttryckligen repots .cursor/environment.json som konfigurationskälla. En tidigare personlig eller gemensam Cursor-miljö kan annars ta över. Om en sådan miljö redan är vald ska du byta till repofilen eller ange installationskommandot manuellt.
Vänta tills miljöns Build har lyckats. Filen kör bash .claude/skills/freecad-styrning/scripts/installera_linux.sh och förbereder FreeCAD innan agenten startar.
Starta agenten från den lyckade miljön och skriv: ”Läs AGENTS.md och rita en testgrind, 1000 bred och 1100 hög. Lägg PDF och bilder i leverans/testgrind och skapa en pull request.”

Se även Cursors guide till Cloud Agent-miljöer.

Alternativ 2: installera i ett befintligt eget repo

Har du redan ett eget repo kan en kodagent lägga in verktyget där. Starta en session i repot och klistra in hela prompten nedan.

Installera verkstadsskillen freecad-styrning i det här repot:
1. Hämta https://github.com/richalund/Steelworks-shopdrawings/releases/download/latest/freecad-styrning.zip och packa upp den så att mappen hamnar i .claude/skills/freecad-styrning.
2. Skapa eller uppdatera AGENTS.md. Skriv att agenten ska läsa .claude/skills/freecad-styrning/SKILL.md före ritningsarbete, lägga genererade filer i ut/ och lägga egna skript och uppgifter i egna/. Om en molnagent bara kan lämna tillbaka committade filer och repot är privat ska leveransen kopieras till leverans/<uppdrag>/ på uppdragets gren. Kunduppgifter får aldrig committas i ett publikt repo.
3. Förbered den agent som ska användas. För Claude Code: lägg till en SessionStart-hook i .claude/settings.json som i molnsessioner kör bash .claude/skills/freecad-styrning/scripts/installera_linux.sh i bakgrunden. För GitHub Copilot: skapa .github/workflows/copilot-setup-steps.yml med ett Ubuntu-jobb som heter copilot-setup-steps, kan köras med workflow_dispatch och kör samma installationskommando. För Cursor: skapa .cursor/environment.json med installationskommandot. För Codex används kommandot när molnmiljön skapas enligt avsnittet längre ned.
4. Skapa mappen egna/ och lägg ut/ och egna/foretag.json i .gitignore.
5. Kör bash .claude/skills/freecad-styrning/scripts/installera_linux.sh nu och vänta tills den är klar. Fråga mig sedan om företagsuppgifterna och rita en testgrind, 1000 bred och 1100 hög.
Committa och pusha på en ny gren och säg vilken version (filen VERSION) som installerades. När jag ber om att uppdatera skillen: gör steg 1 igen.

Så vet du att installationen fungerar

Installationen är klar när agenten har skapat leverans/testgrind/ med minst en PDF och en PNG – utan rött installationsfel.

Installationen avslutas utan ett rött fel och agenten kan hitta FreeCAD.
Testgrinden skapas utan påhittade mått.
Du får minst en PDF och en PNG. I Codex, Copilot och Cursor ska de finnas i leverans/testgrind/ på uppdragets gren eller i agentens pull request.

Hämta resultatet

Öppna länken till grenen eller pull requesten som agenten lämnar.
Öppna mappen leverans/testgrind/.
Öppna PDF- respektive PNG-filen och välj Download eller nedladdningsikonen på GitHub.

Nätet och domäner som behöver tillåtas

Välj i första hand agentens vanliga paketlista, till exempel Package managers i Codex. Lägg därefter till de extra adresser som agenten rapporterar som blockerade. För den nuvarande installationen och materialkontrollen kan följande domäner behövas:

github.com
codeload.github.com
release-assets.githubusercontent.com
objects.githubusercontent.com
raw.githubusercontent.com
conda.anaconda.org
pypi.org
files.pythonhosted.org
archive.ubuntu.com
security.ubuntu.com
deb.debian.org
micro.mamba.pm
cdn.jsdelivr.net
data.jsdelivr.com
eurocodeapplied.com

Tillåt bara de domäner som behövs. Leverantörers webbplatser behöver läggas till separat om agenten ska verifiera beslag, lås, glas eller andra inköpta komponenter.

Om det stannar

Repot syns inte: kontrollera att tjänstens GitHub-anslutning har åtkomst till den privata kopian.
FreeCAD saknas: kör bash .claude/skills/freecad-styrning/scripts/installera_linux.sh, vänta tills kommandot är klart och publicera eller bygg om miljön innan du startar en ny uppgift.
En nedladdning blockeras: lägg till den domän som står i felmeddelandet i agentens internetinställningar och kör installationen igen.
Codex-miljön syns inte på mobilen: skapa och publicera den först på webben eller i ChatGPT-datorappen.

Så räcker abonnemanget längre

En ny session per jobb. Långa sessioner använder mer historik och kan därför förbruka mer av abonnemanget.
Samla ändringarna i ett meddelande: ”1200 bred, handledare i rör 42, lägg till ett snitt”.
Färre och mindre bilder. Två–tre foton som visar det viktiga räcker.
Ge måtten du har direkt; det sparar frågor och omtag.
Kontrollera förbrukningen i den aktuella tjänstens konto- eller användningsinställningar. Menynamn och gränser ändras över tid.

Val av modell

Modellnamn, priser och användningsgränser ändras ofta. Börja med tjänstens rekommenderade standardmodell. Välj en starkare modell för nya konstruktioner, foton och scannade ritningar, och en snabbare modell för små ändringar i en redan fungerande ritning. Kontrollera alltid den aktuella modellinformationen hos Claude, OpenAI, GitHub eller Cursor.

← Tillbaka till Verkstadsritningar för smide