Skip to main content
Everything in a MagicOS is a file. Agents can read and change the same files you see.

Add a file

Use Insert, the + in the top left, or right-click an empty spot.
  • Canvas: a board for laying out explorations side by side. Explorations stay on the canvas and aren’t separate files.
  • Prototype: an interactive app.
  • Frame: a single screen.
  • Document: a written doc, like a PRD.
  • Image: a screenshot or reference. Drag it in or paste it. You can also drop in a PDF for the agent to read.
  • Resources: shared sources, like a GitHub repo or design system.

Import your work

Open the File menu to bring in work you already have.
  • Import Existing Design: paste a Magic Patterns design link or pick one of your designs.
  • Import Design System: pick one of your design systems so agents use your components and styles.
  • Import from Claude Design: in Claude Design, go to Share → Project HTML to get a zip file, then upload it here. It comes in as a prototype and frames.
  • Copy and paste from website: copy any page with the Magic Patterns Chrome extension, then press ⌘V in your project. It comes in as a frame.

Open a prototype or frame

Double-click a prototype or frame to open it. There are three modes:
  • Interact: use it like a real app. This is the default.
  • Inspect: select an element, then ask for a change or add it to your prompt.
  • Edit: make visual edits. This is only available on frames.
To rename a file, use the sidebar. To go to a prototype an agent is working in, use Now in.

Move around

Use Pointer and Hand to move around the canvas. Files snap to each other as you drag and resize them. Press / to jump to the chat. See Navigating for zoom shortcuts.

Show the agent what you mean

Select files on the canvas and add them to the chat. You can also mention a file by name in your prompt, or paste a link to a design you can access and ask the agent to bring it in.