Start designingOpen Moonomat

Case study

How I designed a house in 3D with an AI agent, step by step

I designed this house in Moonomat by typing what I wanted, looking at the result and saying what to change. This page shows how that went: what I typed, what the agent answered, and which tools in the app helped.

The house open in Moonomat Viewer in a browser window: three stories of concrete and timber under a wide roof, the walled garden, the gate and the covered parking in front
Walk through it.

Part 1

Getting to know Moonomat

1Panels on the left, the viewer on the right

Moonomat is a 3D modeling tool that runs in the browser. It has no buttons or toolbars for drawing and shaping. That is the agent's job. Your part is organizing the files, directing the agent and judging the result.

On the left is a bar with one button per panel, and next to it the panel that is open. The rest of the window is the viewer. It shows the active file. For a Moon file, that is what the file produces when it runs: a 3D model, an image or data.

Moonomat with the house open: the activity bar on the left, the Explorer panel with the bundle's folders, the 3D view of the house, and the top bar with the bundle, the open file, Run and the terminal Designlet the AI agent build Explorerbrowse and manage files Searchfind text in all files Editoredit the active file's text Parametersadjust the active file's parameters Transfersync with GitHub or Drive Publishshare a link, embed, download Librariesadd parts from other bundles Settingsset up the app Helpdocs and app version Accountsign in, your plan Bundleswitch bundles or create a new one Active filewhat the viewer shows Runbuild the active file Terminalfollow what runs, open the terminal Undo, redostep back or forward View cubeturn to a side Controls helpmouse and keys Panelthe tool picked on the left Viewershows the active file: 3D, drawings, data, text
  • Top bar: Bundle: switch bundles or create a new one. Active file: what the viewer shows. Run: build the active file. Terminal: follow what runs, open the terminal. Undo, redo: step back or forward.
  • Left bar, top to bottom: Design: let the AI agent build. Explorer: browse and manage files. Search: find text in all files. Editor: edit the active file's text. Parameters: adjust the active file's parameters. Transfer: sync with GitHub or Drive. Publish: share a link, embed, download. Libraries: add parts from other bundles. Settings: set up the app. Help: docs and app version. Account: sign in, your plan.
  • Next to it: the panel, the tool picked on the left. The rest: the viewer, which shows the active file: 3D, drawings, data, text. In 3D, the view cube turns the view to a side, and the controls help shows the mouse and keys.

2A bundle: a folder of Moon files

The agent works on one design at a time. Moonomat calls it a bundle: a folder of .moon files that import each other, plus the images and data they use. Every bundle starts at main.moon. To share a bundle or keep a copy, you pack it into one .moons text file or into a .moon.zip, which is the bundle's folder zipped.

A .moon file is a small text file in the Moon language. A house has many of them, one for each part. Each can be reused: you can copy it into another design later, as long as the files it imports come along.

Once a design grows, the agent usually splits it into files like this on its own. You can also ask for it directly: “Create a toaster in appliances/toaster.moon.”

The house bundle as folders, with a line for each import: main.moon on the left imports files in all folders, and they import each other across folders.building/furniture/lighting/vegetation/appliances/vehicles/courtyard/roof/shell/arrival/bathroom/bedroom/gallery/kitchen_living/office/outdoor/play/shared/materials/car/scooter/sofa/parts/parts/band_steel.mooncourtyard_geometry.mooncurved_stair.moonrailing_path.mooncourt_opening.moonframe.moongeometry.moonhip_roof.moonpanels.moonrainwater.moonsolar.moondecks.moonfronts.moongables.moonscreens.moonshutters.moonspine.moonstructure.moonwalls.moonaircon.moonarrival.moonbox.mooncanopy.moonentrance_canopy.mooninteriors.moonplan.moonplay_terrace.moonplunge_pool.moonroller_shutter.moonterrace_office.moonterrace_wc.moonshoe_bench.moonbathtub.moonshower.moonvanity.moonwc.moonbed.moondesk_niche.moonswivel_chair.moonwardrobe.moonbay_bench.moonshelving.moonutility_bay.mooncoffee_table.moondining.moondining_chair.moonkitchen.moonliving_lounge.moontv_console.moondesk.moonoffice_chair.moonround_table.moontub_chair.moonoutdoor_lounge.moonsun_lounger.moonbuilt_in_bench.mooncourt_banquette.moonpool_table.moontable_tennis.moongunnared.moonsofa.mooncabinet_run.moonbollard.moonceiling_light.moondownlight.moonfloor_lamp.moonlayout.moonled_profile.moonpendant.moonwall_light.moonfoliage.moonleaf_atlas.moonleaf_atlas_image.moongarden.moonplanting.moontree.moonaircon.moonfridge.moonmonitor.moontv.moonwashing_machine.moonantenna.moonbadge.moonbody.moonfront_end.moongreenhouse.mooninterior.moonmirror.moonrear_end.moonseats.moonspoiler.moontailgate_cut.moonunderside.moonwheel.mooncar.moonbody.moonfloor_rails.moonfork.moonheadset.moonlegshield.moonmaterials.moonrear.moonseat.moonstand.moontail_lamp.moonwheel.moonscooter.moonmain.moon
The house's folders, as in the Explorer, with a line for each import. The arrow points at the file that is imported.

3The Design panel

The Design panel is a chat with Moonomat's Design agent. You bring the AI model behind it: with an API key, for example from OpenRouter, or with your Claude or ChatGPT subscription through a small bridge program on your computer. I use my Claude subscription and built this house mainly with Claude Opus.

If Opus gets stuck, Fable might help. Or start a new session with New, and keep each session to one task. With a ChatGPT subscription, Sol and Astra give similar results.

The Design panel: the connected provider and the model at the top, my message about a round side table, then the agent's first steps: thinking, listing the files, reading main.moon, writing main.moon, and the message box at the bottom Modelwhich model it uses Your messagewhat you asked A stepwhat it did, open for details Attachadd a picture or a file Provideryour subscription or API key Settingsof the provider Newstart a new session
  • At the top: the provider you connected and its settings, the model, and New to start a new session.
  • The session: your message, then what the agent does, step by step. Open a step for the details.
  • At the bottom: the paperclip, to attach a picture or a file to your message.

4What the agent does after you send

Once you send a message, the agent decides on its own what to do. It has a few tools. It can read and search the files, write or change them, run a Moon file and see its errors, render pictures of the result from views it picks itself, and check the model. It uses them in any order, as often as it needs, and then answers. After that it is your turn again.

The more there is in the bundle, the better the agent knows what you want. It reads what is already there and works out from that how to make the change you ask for.

You can also put supporting material in the bundle: a brief or a specification (usually as Markdown .md files), or photos and drawings of what you want modeled.

You write a message. The agent then works on its own. It decides what to do next and uses its tools in any order, as often as it needs: read and search files, write or change files, run a Moon file, render pictures, check the model. Then it answers, and it is your turn again.The agent, on its ownread and search fileswrite or change filesrun a Moon filerender picturescheck the modeldecides what to do nextuses its tools in any order, as often as it needsYouwrite a messageIt answersand stopsyour turn again

Part 2

Deciding before building

Plan first, then build: the shape of the courtyard, where the office goes, how to carry a pool, and how to make the house narrower after it was furnished.

Part 3

Adding things

Furniture, appliances, trees, a car. The pattern is usually the same: build the thing in its own .moon file, look at it on its own, then place it in the house. Four examples, from easy to hard.

Part 4

Tips

Things worth knowing as the model grows.

17Let the agent tidy up the files

Over time the bundle had grown: thirty-odd furniture files in one folder, old studies, drawings of ideas I had dropped, and a main file of more than two thousand lines.

now our furniture/ has a lot of files. I am thinking of grouping by room / area (have subfolders). is that possible? do we have shared furniture?

i don't like the plural 'buildings', it's just one building. site doesn't need an extra folder and lib/ maybe rather removed, and move files to their actual use have a suggestion

now i am wondering about main.moon, it's super long. are there assets in there that should actually be in their own .moon files?

13 runs · 11 scripts · 3 new files · 1 render

The refactoring is finished. main.moon went from 2358 to 1569 lines, and the house is identical: same size, 9173 meshes, 670 438 triangles. I checked after every step, and the render looks the same.

building/plan.moon holds all shared measurements as one record […] Every part reads its numbers from here, so a change in floor height or court size reaches all parts.

After a few more rounds:

before                           after
main.moon   2,651 lines          main.moon    623 lines
buildings/  lib/  site/          building/    shell/ courtyard/ roof/
furniture/  36 files, one folder furniture/   bedroom/ play/ office/ …
studies/    5 files              appliances/  materials/
plans/      27 files             plans/       12 files
scripts/    11 files             scripts/     4 files

One thing to know: the agent is not allowed to delete files that were there before the session started. That is a safeguard against unwanted changes. Instead, it tells me which ones to delete, or writes a small script that I run myself in the app's terminal. Still, it makes sense to back up your work often, especially before a big change like this one.

Part 5

Backup and sharing

Keep a copy of the bundle, and show the model to others.

20Back up a bundle, and bring files in

A bundle lives in the browser, on your device. Nothing goes to Moonomat's servers. That keeps it private, but clearing the browser's site data deletes it. So keep a copy somewhere else:

  • Download it. The Publish panel downloads the bundle as one .moons file, or as a .moon.zip when it holds large binary data such as textures.
  • GitHub. The Transfer panel pushes the bundle to a repository of yours and pulls it back, on any device. Use a private repository for confidential work. With a public one, anyone can see your work, and the Publish panel shows a link that opens the bundle in Moonomat Viewer.
  • Google Drive. The same, into your own Drive. Nobody else can see the files unless you share them there.

Nothing syncs on its own. Push and Pull are buttons, and Diff shows what differs before you decide. An orange dot on the Transfer button means the open bundle exists only in this browser.

To bring a bundle back in, Import Moon bundle… in the bundle menu at the top opens a .moons file. Single files, like a downloaded model, a photo or a PDF, go into the bundle by dragging them onto the Explorer, or with Upload… in its right-click menu.