UML desktop deployment

How the DrawMode desktop app works on one computer: the default data folder versus a project kept in a Git repository, what talks to the outside, and how agents collaborate live while the file store persists.

UML desktop deployment
Figure 5. UML desktop deployment
Diagram source
Diagram JSON
{
  "shapes": [
    {
      "shapes": [],
      "id": "md-43kvby~e1794206251796",
      "category": "Always available",
      "type": "markdown",
      "props": {
        "markdown": "# Explanation\n\nThe prompt:\n\n> Create me a UML deployment diagram showing how the app is installed on the machine, and what folders and systems it interfaces with.",
        "fill": "#ffffff",
        "outline": "#d0d7de",
        "magnification": 1
      },
      "smZ": null,
      "smTab": null,
      "fileLink": null,
      "fileLinkDesc": null,
      "smGroup": null,
      "deleted": false,
      "x": 587,
      "y": 987,
      "w": 481,
      "h": 183
    },
    {
      "shapes": [],
      "id": "ext_app~e1791779110742",
      "category": "Topology",
      "type": "infrastructure",
      "props": {
        "name": "app.drawmode.ai",
        "description": "ModeBit's server hears from the app once a day — a random install id, the version, OS and arch; no IP is stored; off with the setup switch or DRAWMODE_NO_TELEMETRY — and when you ask: the daily plan check once you connect your web account (your desktop key + a salted hash of the machine id), pairing, searching the web's document shelf (your search text), publishing a Showcase site (the site as a zip). Never your diagrams, your code or your AI keys.",
        "subtitle": "once a day: install id · version · OS\nplan · pairing · documents · publish",
        "stereotype": "API",
        "form": "icon",
        "color": 2
      },
      "smZ": null,
      "smTab": null,
      "fileLink": "docs/desktop-telemetry.md",
      "fileLinkDesc": "What the app sends, and how to stop it.",
      "smGroup": null,
      "deleted": false,
      "x": 915,
      "y": 20,
      "w": 208,
      "h": 123
    },
    {
      "shapes": [],
      "id": "ext_openai~e1791779110743",
      "category": "Topology",
      "type": "infrastructure",
      "props": {
        "name": "OpenAI · Serper",
        "description": "Only when you use an AI feature, and straight from your machine. Chat: your messages and the diagram text the assistant is given. Vision: pictures you ask about, captions for a document's figures. Embeddings: the text of documents you add to the index. Serper (optional): the web-search query. Nothing routes through ModeBit; the keys sit in settings.json in the data folder.",
        "subtitle": "chat · vision · embeddings · search\nwith your own keys",
        "stereotype": "API",
        "form": "icon",
        "color": 2
      },
      "smZ": null,
      "smTab": null,
      "fileLink": null,
      "fileLinkDesc": null,
      "smGroup": null,
      "deleted": false,
      "x": 1101,
      "y": 20,
      "w": 207,
      "h": 123
    },
    {
      "shapes": [],
      "id": "ext_github~e1791779110744",
      "category": "Topology",
      "type": "infrastructure",
      "props": {
        "name": "GitHub releases",
        "description": "drawmode-ai/drawmode-releases. macOS updates in place after you agree; Windows and Linux get a notice and the installer. The daily check itself goes to app.drawmode.ai, which passes the latest release through.",
        "subtitle": "downloads the update\nlearns nothing about you",
        "stereotype": "API",
        "form": "icon",
        "color": 2
      },
      "smZ": null,
      "smTab": null,
      "fileLink": null,
      "fileLinkDesc": null,
      "smGroup": null,
      "deleted": false,
      "x": 1351,
      "y": 20,
      "w": 156,
      "h": 123
    },
    {
      "shapes": [
        {
          "shapes": [
            {
              "shapes": [],
              "id": "live~e1791779110753",
              "category": "Class diagram",
              "type": "class",
              "props": {
                "name": "Live model",
                "kind": "component",
                "attributes": [],
                "operations": [],
                "color": 3,
                "abstract": false,
                "stereotype": "in-memory · one process",
                "iface": false,
                "hideAttrs": true,
                "hideOps": true,
                "hideArgs": false,
                "hideReturn": false,
                "sort": false,
                "width": 0,
                "description": "The canonical copy of every open diagram, in the server's memory. Edits from your windows, from Orville and from agents at the MCP door relay between windows through it (InMemoryTeamUpdates — the desktop has no Redis; on the web the same seam is Redis). Every change is recorded in the modification register — who, what, why — with an agent's title and reasoning beside it, and sealed at your next Git commit."
              },
              "smZ": null,
              "smTab": null,
              "fileLink": "packages/drawcore/src/modebit/drawcore/team/in_memory_team_updates.py",
              "fileLinkDesc": "InMemoryTeamUpdates — the desktop's team provider: relays edits between windows in one process; make_provider() picks it when there is no Redis.",
              "smGroup": null,
              "deleted": false,
              "x": 846,
              "y": 477,
              "w": 150,
              "h": 80
            },
            {
              "shapes": [],
              "id": "mcp~e1791779110754",
              "category": "Class diagram",
              "type": "class",
              "props": {
                "name": "MCP door",
                "kind": "component",
                "attributes": [],
                "operations": [],
                "color": 3,
                "abstract": false,
                "stereotype": "/mcp · Streamable HTTP",
                "iface": false,
                "hideAttrs": true,
                "hideOps": true,
                "hideArgs": false,
                "hideReturn": false,
                "sort": false,
                "width": 0,
                "description": "http://127.0.0.1:<port>/mcp?project=<id> — a coding agent reads and writes diagrams through the same seams your windows use. Off by default (MCP ▸ MCP server on), Trial/Professional only, unkeyed on the desktop; ?project= scopes every call and picks the window an edit lands in. An edit lands through your open canvas as one undoable step; with no window on the project it goes straight to the file store."
              },
              "smZ": null,
              "smTab": null,
              "fileLink": "docs/mcp-server.md",
              "fileLinkDesc": "The MCP door: the tools, who a session is, where an edit lands.",
              "smGroup": null,
              "deleted": false,
              "x": 1151,
              "y": 477,
              "w": 150,
              "h": 80
            },
            {
              "shapes": [],
              "id": "store~e1791779110755",
              "category": "Class diagram",
              "type": "class",
              "props": {
                "name": "File store",
                "kind": "component",
                "attributes": [],
                "operations": [],
                "color": 3,
                "abstract": false,
                "stereotype": "FilePersistenceStore",
                "iface": false,
                "hideAttrs": true,
                "hideOps": true,
                "hideArgs": false,
                "hideReturn": false,
                "sort": false,
                "width": 0,
                "description": "The one writer of every file DrawMode keeps (IPersistence — the web swaps in Postgres behind the same seam). Saves 0.8 s after the last edit. A project in the data folder: one JSON file per diagram. A project in a Git repository: a baseline plus an append-only delta log per diagram, replayed on load; it watches the files every 2 s so a checkout or pull converges your open canvases, and reads .git itself to know what is committed — it never runs git."
              },
              "smZ": null,
              "smTab": null,
              "fileLink": "packages/drawcore/src/modebit/drawcore/persistence/file_persistence_store.py",
              "fileLinkDesc": "FilePersistenceStore(IPersistence) — its header documents the on-disk layout.",
              "smGroup": null,
              "deleted": false,
              "x": 846,
              "y": 617,
              "w": 150,
              "h": 80
            },
            {
              "shapes": [],
              "id": "orville~e1791780021784",
              "category": "Class diagram",
              "type": "class",
              "props": {
                "name": "Orville",
                "kind": "component",
                "attributes": [],
                "operations": [],
                "color": 3,
                "abstract": false,
                "stereotype": "the assistant · up to 4 owls",
                "iface": false,
                "hideAttrs": true,
                "hideOps": true,
                "hideArgs": false,
                "hideReturn": false,
                "sort": false,
                "width": 0,
                "description": "The in-app assistant, a second editor rather than your hand: he works in the project, knows the diagram in front and your selection, and his edits land through a canvas in his window as field patches with his own undo/redo history — your Cmd-Z never reaches his work (a field you both changed: last writer wins, and he says so). Up to four owls per window, one per chat tab — Orville, Wilbur, Katharine, Violeta — each a separate editor with his own history and his own row in the register (assistant#<owl>); the first tab is always Orville. He talks to OpenAI with your key, searches the documents you added, and on the desktop can list, read, search and edit the code at the project's root — only when you ask."
              },
              "smZ": null,
              "smTab": null,
              "fileLink": "docs/agent-undo.md",
              "fileLinkDesc": "The assistant is a second editor, with its own undo.",
              "smGroup": null,
              "deleted": false,
              "x": 1123,
              "y": 617,
              "w": 178,
              "h": 80
            },
            {
              "id": "link-ai-3~e1791779110743",
              "category": "Topology",
              "type": "communication",
              "props": {
                "line": "solid",
                "sourceMarker": "none",
                "targetMarker": "arrow",
                "thickness": 1.6,
                "color": "#475569",
                "label": "each edit / undo / redo"
              },
              "smZ": null,
              "smTab": null,
              "fileLink": null,
              "fileLinkDesc": null,
              "smGroup": null,
              "deleted": false,
              "source": "mcp~e1791779110754",
              "target": "live~e1791779110753",
              "vertices": [],
              "straight": false,
              "bezier": false,
              "noAvoid": null,
              "vrel": false,
              "labMove": false,
              "labOff": {},
              "subtitle": "via your open canvas",
              "description": "Each MCP call — a batch of ops, or a whole write — lands on your open canvas as a single undo step: one Cmd-Z reverts the agent's whole batch, your own edits undo as usual. With no window open on the project the edit is persisted headless, straight to the file store, and is not undoable from a canvas.",
              "animation": null
            },
            {
              "id": "link-ai-4~e1791779110743",
              "category": "Topology",
              "type": "communication",
              "props": {
                "line": "solid",
                "sourceMarker": "none",
                "targetMarker": "arrow",
                "thickness": 1.6,
                "color": "#475569",
                "label": "saves 0.8 s after the last edit"
              },
              "smZ": null,
              "smTab": null,
              "fileLink": null,
              "fileLinkDesc": null,
              "smGroup": null,
              "deleted": false,
              "source": "live~e1791779110753",
              "target": "store~e1791779110755",
              "vertices": [],
              "straight": false,
              "bezier": false,
              "noAvoid": null,
              "vrel": false,
              "labMove": false,
              "labOff": {},
              "subtitle": "records who did what, and why",
              "description": null,
              "animation": null
            },
            {
              "id": "link-ai-1~e1791780021784",
              "category": "Topology",
              "type": "communication",
              "props": {
                "line": "solid",
                "sourceMarker": "none",
                "targetMarker": "arrow",
                "thickness": 1.6,
                "color": "#475569",
                "label": "a collaborator"
              },
              "smZ": null,
              "smTab": null,
              "fileLink": null,
              "fileLinkDesc": null,
              "smGroup": null,
              "deleted": false,
              "source": "orville~e1791780021784",
              "target": "live~e1791779110753",
              "vertices": [],
              "straight": false,
              "bezier": false,
              "noAvoid": null,
              "vrel": false,
              "labMove": true,
              "labOff": {
                "m0": {
                  "x": 56,
                  "y": 1
                }
              },
              "subtitle": "orville's own undo stack",
              "description": "His changes and undos go through the same delta plumbing as yours and a coding agent's, but into his own history: he undoes and redoes only his work, and yours stays yours. Undo is field by field and never blocks; what overlapped is said in his reply or your toast.",
              "animation": null
            }
          ],
          "id": "node-ai-1~e1791781289697",
          "category": "Class diagram",
          "type": "class",
          "props": {
            "name": "DrawMode.app",
            "kind": "component",
            "attributes": [],
            "operations": [],
            "color": 12,
            "abstract": false,
            "stereotype": "application",
            "iface": false,
            "hideAttrs": false,
            "hideOps": false,
            "hideArgs": false,
            "hideReturn": false,
            "sort": false,
            "width": 0,
            "description": "One app bundle, two processes: the Electron shell (windows, menus, the daily update check, updates in place on macOS) spawns and supervises a frozen Python server that does everything else — pages and canvas, the assistant, the MCP door, document indexing, Graphviz layout. Every window is a session on this one server. Worth knowing: the server binds all interfaces, not only loopback; only /mcp checks Host/Origin."
          },
          "smZ": null,
          "smTab": null,
          "fileLink": "desktop/main.js",
          "fileLinkDesc": "The shell: spawns and supervises the server, learns its port from stdout, opens the windows, checks for updates.",
          "smGroup": null,
          "deleted": false,
          "x": 816,
          "y": 372,
          "w": 521,
          "h": 357
        },
        {
          "shapes": [
            {
              "shapes": [],
              "id": "projects~e1791779110747",
              "category": "Topology",
              "type": "artifact",
              "props": {
                "name": "projects/<Name>/",
                "description": "A project kept the default way: a readable tree named by the project's and diagrams' names (the ids inside the JSON keep references valid across renames). Images are inline. snapshots/ holds Save snapshot… and the automatic restore points; the register is who changed what and why.",
                "subtitle": "project.json · diagrams/<Diagram>.json — one file each\nsnapshots · modification register · chat",
                "stereotype": "folder",
                "color": 0
              },
              "smZ": null,
              "smTab": null,
              "fileLink": null,
              "fileLinkDesc": null,
              "smGroup": null,
              "deleted": false,
              "x": 196,
              "y": 372,
              "w": 424,
              "h": 86
            },
            {
              "shapes": [],
              "id": "machine~e1791779110748",
              "category": "Topology",
              "type": "artifact",
              "props": {
                "name": "this machine's own",
                "description": "What never goes in a repository: settings.json (your OpenAI/Serper keys, the desktop key, the signed plan answer), locations.json (which Git repository each moved project lives in), linked/<project id>/ (the snapshots, register and chat of a project kept in Git — this machine's history), views/ (your pan and zoom per diagram), vector_docs/ (documents you added, chunked and embedded; search runs locally), last-port, .session-secret.",
                "subtitle": "settings.json (AI keys, plan) · locations.json\nlinked/<project id>/ · views/ · vector_docs/",
                "stereotype": "file",
                "color": 0
              },
              "smZ": null,
              "smTab": null,
              "fileLink": null,
              "fileLinkDesc": null,
              "smGroup": null,
              "deleted": false,
              "x": 196,
              "y": 471,
              "w": 424,
              "h": 85
            }
          ],
          "id": "data~e1791779110746",
          "category": "Topology",
          "type": "infrastructure",
          "props": {
            "name": "DrawMode data folder",
            "description": "DRAWCORE_DATA_DIR, chosen in the Setup window (avatar ▸ Name & folder… moves it; View DrawMode local files… opens it in Finder / Explorer). Windows: %USERPROFILE%\\Documents\\DrawMode; Linux: ~/Documents/DrawMode. The app's own config.json and logs are separate, in ~/Library/Application Support/DrawMode (%APPDATA%\\DrawMode, ~/.config/DrawMode).",
            "subtitle": "~/Documents/DrawMode — chosen at setup\nwhere a project lives by default",
            "stereotype": "Folder",
            "color": 0
          },
          "smZ": null,
          "smTab": null,
          "fileLink": "docs/project-locations.md",
          "fileLinkDesc": "What goes in your folder, and what stays on the machine.",
          "smGroup": null,
          "deleted": false,
          "x": 176,
          "y": 279,
          "w": 473,
          "h": 289
        },
        {
          "shapes": [
            {
              "shapes": [],
              "id": "src~e1791779110750",
              "category": "Topology",
              "type": "artifact",
              "props": {
                "name": "src/",
                "description": "A shape's file link is a path from the repository root plus a line; a click opens it in your editor or the code tab. DrawMode never indexes or sends your source by itself: Orville lists, reads, searches or edits it only when you ask him to, and what he reads goes to OpenAI with your key. A coding agent over MCP reads it with its own tools and its own model — by your choice.",
                "subtitle": "your code — Orville reads or edits it only when you ask; file links open it",
                "stereotype": "folder",
                "color": 4
              },
              "smZ": null,
              "smTab": null,
              "fileLink": null,
              "fileLinkDesc": null,
              "smGroup": null,
              "deleted": false,
              "x": 196,
              "y": 691,
              "w": 439,
              "h": 71
            },
            {
              "shapes": [],
              "id": "dd~e1791779110751",
              "category": "Topology",
              "type": "artifact",
              "props": {
                "name": "drawmode-diagrams/",
                "description": "One folder at the repository root — commit it. A diagram is a baseline plus an append-only log of changes; a load replays the log, and two branches merge by Git's union rule + a field-by-field replay (last change wins). Undo truncates the log, never past what Git already has. Content only: no pan/zoom, no owner, no history. drawmode-cli baseline folds a log into its baseline.",
                "subtitle": "per diagram: <Name>_<hash>.json baseline + _deltas.jsonl log\ndrawmode-project.json · .gitattributes *.jsonl merge=union",
                "stereotype": "folder",
                "color": 4
              },
              "smZ": null,
              "smTab": null,
              "fileLink": "packages/drawcore/src/modebit/drawcore/diagram_log.py",
              "fileLinkDesc": "The baseline + log format and its replay.",
              "smGroup": null,
              "deleted": false,
              "x": 196,
              "y": 773,
              "w": 439,
              "h": 85
            }
          ],
          "id": "repo~e1791779110749",
          "category": "Topology",
          "type": "infrastructure",
          "props": {
            "name": "Your Git repository",
            "description": "Once a project is moved here it is files beside your code and travels with it: clone the repository on another machine and Git ▸ Link to existing project in repo… picks it up. DrawMode reads .git directly (HEAD, refs, the index, objects) to know what is committed — it performs no Git operation; you commit, branch and merge with your own git.",
            "subtitle": "any folder with .git — yours to branch, commit, push\nGit ▸ Move current project to repo…",
            "stereotype": "Folder",
            "color": 4
          },
          "smZ": null,
          "smTab": null,
          "fileLink": "docs/desktop-git-branching.md",
          "fileLinkDesc": "One folder at the Git root, baseline + log, union merge + replay, the undo cut.",
          "smGroup": null,
          "deleted": false,
          "x": 176,
          "y": 598,
          "w": 473,
          "h": 280
        },
        {
          "shapes": [],
          "id": "you~e1791779110756",
          "category": "Topology",
          "type": "client",
          "props": {
            "name": "You",
            "description": "Every window — a project, a second window on it, a torn-off diagram — is an ordinary session on the one local server; edits relay between them through the live model, and presence shows each window as you.",
            "subtitle": "in DrawMode's windows\none session each",
            "stereotype": "Browser",
            "color": 6
          },
          "smZ": null,
          "smTab": null,
          "fileLink": null,
          "fileLinkDesc": null,
          "smGroup": null,
          "deleted": false,
          "x": 1351,
          "y": 264,
          "w": 142,
          "h": 118
        },
        {
          "shapes": [],
          "id": "agent~e1791779110757",
          "category": "Topology",
          "type": "client",
          "props": {
            "name": "Coding agent",
            "description": "Connects to the MCP door with the line MCP ▸ Connection keys… gives. It reads and writes your diagrams like a collaborator, under its own name in the register; whatever it sends to its own model is the agent's business — DrawMode is not in that path.",
            "subtitle": "Claude Code · Codex\nover MCP, by your choice",
            "stereotype": "Rich Client",
            "color": 6
          },
          "smZ": null,
          "smTab": null,
          "fileLink": null,
          "fileLinkDesc": null,
          "smGroup": null,
          "deleted": false,
          "x": 1351,
          "y": 598,
          "w": 148,
          "h": 118
        },
        {
          "shapes": [],
          "id": "cli~e1791779110758",
          "category": "Topology",
          "type": "client",
          "props": {
            "name": "Terminal",
            "description": "Avatar ▸ Install command line tool… puts drawmode-cli on PATH; it finds the project from the cwd's repository and works on the files directly — no running app needed, so CI can baseline, check and print the pure model. export-png/svg spawn a hidden window of the app.",
            "subtitle": "drawmode-cli\nbaseline · extract-pure · export · check",
            "stereotype": "Rich Client",
            "color": 6
          },
          "smZ": null,
          "smTab": null,
          "fileLink": "docs/desktop-cli-install.md",
          "fileLinkDesc": "The command line: its verbs, and what Install command line tool… writes on each platform.",
          "smGroup": null,
          "deleted": false,
          "x": 781,
          "y": 789,
          "w": 216,
          "h": 118
        },
        {
          "id": "link-ai-2~e1791779110743",
          "category": "Topology",
          "type": "communication",
          "props": {
            "line": "solid",
            "sourceMarker": "none",
            "targetMarker": "arrow",
            "thickness": 1.6,
            "color": "#475569",
            "label": "reads + edits diagrams"
          },
          "smZ": null,
          "smTab": null,
          "fileLink": null,
          "fileLinkDesc": null,
          "smGroup": null,
          "deleted": false,
          "source": "agent~e1791779110757",
          "target": "mcp~e1791779110754",
          "vertices": [
            [
              -3,
              -140
            ]
          ],
          "straight": false,
          "bezier": false,
          "noAvoid": null,
          "vrel": true,
          "labMove": false,
          "labOff": {},
          "subtitle": "localhost · off by default",
          "description": null,
          "animation": null
        },
        {
          "id": "link-ai-5~e1791779110743",
          "category": "Topology",
          "type": "communication",
          "props": {
            "line": "solid",
            "sourceMarker": "none",
            "targetMarker": "arrow",
            "thickness": 1.6,
            "color": "#475569",
            "label": "a project by default"
          },
          "smZ": null,
          "smTab": null,
          "fileLink": null,
          "fileLinkDesc": null,
          "smGroup": null,
          "deleted": false,
          "source": "store~e1791779110755",
          "target": "data~e1791779110746",
          "vertices": [],
          "straight": false,
          "bezier": false,
          "noAvoid": null,
          "vrel": false,
          "labMove": false,
          "labOff": {},
          "subtitle": "one JSON file per diagram",
          "description": null,
          "animation": null
        },
        {
          "id": "link-ai-6~e1791779110743",
          "category": "Topology",
          "type": "communication",
          "props": {
            "line": "solid",
            "sourceMarker": "none",
            "targetMarker": "arrow",
            "thickness": 1.6,
            "color": "#475569",
            "label": "a project moved to Git"
          },
          "smZ": null,
          "smTab": null,
          "fileLink": null,
          "fileLinkDesc": null,
          "smGroup": null,
          "deleted": false,
          "source": "store~e1791779110755",
          "target": "dd~e1791779110751",
          "vertices": [],
          "straight": false,
          "bezier": false,
          "noAvoid": null,
          "vrel": false,
          "labMove": false,
          "labOff": {},
          "subtitle": "baseline + log · watches 2 s · reads .git",
          "description": null,
          "animation": null
        },
        {
          "id": "link-ai-10~e1791779110743",
          "category": "Topology",
          "type": "communication",
          "props": {
            "line": "solid",
            "sourceMarker": "none",
            "targetMarker": "arrow",
            "thickness": 1.6,
            "color": "#475569",
            "label": "works on the files directly"
          },
          "smZ": null,
          "smTab": null,
          "fileLink": null,
          "fileLinkDesc": null,
          "smGroup": null,
          "deleted": false,
          "source": "cli~e1791779110758",
          "target": "dd~e1791779110751",
          "vertices": [],
          "straight": false,
          "bezier": false,
          "noAvoid": null,
          "vrel": false,
          "labMove": false,
          "labOff": {},
          "subtitle": "no running app needed",
          "description": null,
          "animation": null
        },
        {
          "id": "link-ai-2~e1791781319146",
          "category": "Topology",
          "type": "communication",
          "props": {
            "line": "solid",
            "sourceMarker": "none",
            "targetMarker": "arrow",
            "thickness": 1.6,
            "color": "#475569",
            "label": "draws · chats · commits"
          },
          "smZ": null,
          "smTab": null,
          "fileLink": null,
          "fileLinkDesc": null,
          "smGroup": null,
          "deleted": false,
          "source": "you~e1791779110756",
          "target": "node-ai-1~e1791781289697",
          "vertices": [
            [
              0,
              122
            ]
          ],
          "straight": false,
          "bezier": false,
          "noAvoid": null,
          "vrel": true,
          "labMove": false,
          "labOff": {},
          "subtitle": "a session per window",
          "description": null,
          "animation": null
        }
      ],
      "id": "pc~e1791779110745",
      "category": "Topology",
      "type": "node",
      "props": {
        "name": "Your computer",
        "description": "Single user, no login, works offline. Everything DrawMode keeps is a plain file here. A project lives in DrawMode's data folder by default, or in a Git repository of yours once you move it there (Git ▸ Move current project to repo…). Nothing leaves this box except what the arrows out of it say: no crash reporter, no analytics.",
        "subtitle": "macOS · Windows · Linux",
        "stereotype": "machine",
        "namePos": "left",
        "color": 1
      },
      "smZ": null,
      "smTab": null,
      "fileLink": null,
      "fileLinkDesc": null,
      "smGroup": null,
      "deleted": false,
      "x": 160,
      "y": 151,
      "w": 1371,
      "h": 772
    },
    {
      "shapes": [],
      "id": "remote~e1791779110759",
      "category": "Topology",
      "type": "infrastructure",
      "props": {
        "name": "Your Git remote",
        "description": "The diagram files travel with your code. A teammate's clone merges branches with the union rule in .gitattributes, and the app replays both sides' logs.",
        "subtitle": "GitHub · GitLab · … — you push and pull\nDrawMode never runs git",
        "stereotype": "Document Store",
        "form": "icon",
        "color": 2
      },
      "smZ": null,
      "smTab": null,
      "fileLink": null,
      "fileLinkDesc": null,
      "smGroup": null,
      "deleted": false,
      "x": 224,
      "y": 972,
      "w": 233,
      "h": 123
    },
    {
      "id": "link-ai-11~e1791779110743",
      "category": "Topology",
      "type": "communication",
      "props": {
        "line": "solid",
        "sourceMarker": "none",
        "targetMarker": "arrow",
        "thickness": 1.6,
        "color": "#475569",
        "label": "you push + pull"
      },
      "smZ": null,
      "smTab": null,
      "fileLink": null,
      "fileLinkDesc": null,
      "smGroup": null,
      "deleted": false,
      "source": "repo~e1791779110749",
      "target": "remote~e1791779110759",
      "vertices": [],
      "straight": false,
      "bezier": false,
      "noAvoid": null,
      "vrel": false,
      "labMove": false,
      "labOff": {},
      "subtitle": "diagrams travel with your code",
      "description": null,
      "animation": null
    },
    {
      "id": "link-ai-3~e1791781319146",
      "category": "Topology",
      "type": "communication",
      "props": {
        "line": "solid",
        "sourceMarker": "none",
        "targetMarker": "arrow",
        "thickness": 1.6,
        "color": "#475569",
        "label": "once a day, and when you ask"
      },
      "smZ": null,
      "smTab": null,
      "fileLink": null,
      "fileLinkDesc": null,
      "smGroup": null,
      "deleted": false,
      "source": "node-ai-1~e1791781289697",
      "target": "ext_app~e1791779110742",
      "vertices": [],
      "straight": false,
      "bezier": false,
      "noAvoid": null,
      "vrel": false,
      "labMove": false,
      "labOff": {},
      "subtitle": "never your diagrams or keys",
      "description": null,
      "animation": null
    },
    {
      "id": "link-ai-4~e1791781319146",
      "category": "Topology",
      "type": "communication",
      "props": {
        "line": "solid",
        "sourceMarker": "none",
        "targetMarker": "arrow",
        "thickness": 1.6,
        "color": "#475569",
        "label": "only when you use AI"
      },
      "smZ": null,
      "smTab": null,
      "fileLink": null,
      "fileLinkDesc": null,
      "smGroup": null,
      "deleted": false,
      "source": "node-ai-1~e1791781289697",
      "target": "ext_openai~e1791779110743",
      "vertices": [],
      "straight": false,
      "bezier": false,
      "noAvoid": null,
      "vrel": false,
      "labMove": false,
      "labOff": {},
      "subtitle": "your own key",
      "description": null,
      "animation": null
    },
    {
      "id": "link-ai-5~e1791781319146",
      "category": "Topology",
      "type": "communication",
      "props": {
        "line": "dotted",
        "sourceMarker": "none",
        "targetMarker": "arrow",
        "thickness": 1.6,
        "color": "#475569",
        "label": "downloads updates"
      },
      "smZ": null,
      "smTab": null,
      "fileLink": null,
      "fileLinkDesc": null,
      "smGroup": null,
      "deleted": false,
      "source": "node-ai-1~e1791781289697",
      "target": "ext_github~e1791779110744",
      "vertices": [],
      "straight": false,
      "bezier": false,
      "noAvoid": null,
      "vrel": false,
      "labMove": false,
      "labOff": {},
      "subtitle": null,
      "description": null,
      "animation": null
    }
  ],
  "id": "d22877f2b",
  "name": "UML desktop deployment",
  "category": "topology",
  "description": "How the DrawMode desktop app works on one computer: the default data folder versus a project kept in a Git repository, what talks to the outside, and how agents collaborate live while the file store persists.",
  "tags": [],
  "order": null,
  "publish_ignore": false,
  "ai_guidance": "",
  "deleted": false,
  "open": false,
  "view": {},
  "stamp": {
    "epoch": 0.0,
    "user": "",
    "nonce": 0
  },
  "touched_ms": 0.0,
  "last_editor": "",
  "schema_version": 1,
  "variables": [],
  "projection": ""
}
Pure model
{
  "elements": [
    {
      "id": "md-43kvby~e1794206251796",
      "category": "Notes",
      "kind": "markdown",
      "text": "# Explanation\n\nThe prompt:\n\n> Create me a UML deployment diagram showing how the app is installed on the machine, and what folders and systems it interfaces with."
    },
    {
      "id": "ext_app~e1791779110742",
      "category": "Deployment",
      "kind": "infrastructure",
      "name": "app.drawmode.ai",
      "stereotype": "API",
      "subtitle": "once a day: install id · version · OS\nplan · pairing · documents · publish",
      "description": "ModeBit's server hears from the app once a day — a random install id, the version, OS and arch; no IP is stored; off with the setup switch or DRAWMODE_NO_TELEMETRY — and when you ask: the daily plan check once you connect your web account (your desktop key + a salted hash of the machine id), pairing, searching the web's document shelf (your search text), publishing a Showcase site (the site as a zip). Never your diagrams, your code or your AI keys."
    },
    {
      "id": "ext_openai~e1791779110743",
      "category": "Deployment",
      "kind": "infrastructure",
      "name": "OpenAI · Serper",
      "stereotype": "API",
      "subtitle": "chat · vision · embeddings · search\nwith your own keys",
      "description": "Only when you use an AI feature, and straight from your machine. Chat: your messages and the diagram text the assistant is given. Vision: pictures you ask about, captions for a document's figures. Embeddings: the text of documents you add to the index. Serper (optional): the web-search query. Nothing routes through ModeBit; the keys sit in settings.json in the data folder."
    },
    {
      "id": "ext_github~e1791779110744",
      "category": "Deployment",
      "kind": "infrastructure",
      "name": "GitHub releases",
      "stereotype": "API",
      "subtitle": "downloads the update\nlearns nothing about you",
      "description": "drawmode-ai/drawmode-releases. macOS updates in place after you agree; Windows and Linux get a notice and the installer. The daily check itself goes to app.drawmode.ai, which passes the latest release through."
    },
    {
      "id": "pc~e1791779110745",
      "category": "Deployment",
      "kind": "node",
      "name": "Your computer",
      "stereotype": "machine",
      "subtitle": "macOS · Windows · Linux",
      "description": "Single user, no login, works offline. Everything DrawMode keeps is a plain file here. A project lives in DrawMode's data folder by default, or in a Git repository of yours once you move it there (Git ▸ Move current project to repo…). Nothing leaves this box except what the arrows out of it say: no crash reporter, no analytics.",
      "elements": [
        {
          "id": "node-ai-1~e1791781289697",
          "category": "Class",
          "kind": "component",
          "name": "DrawMode.app",
          "stereotype": "application",
          "description": "One app bundle, two processes: the Electron shell (windows, menus, the daily update check, updates in place on macOS) spawns and supervises a frozen Python server that does everything else — pages and canvas, the assistant, the MCP door, document indexing, Graphviz layout. Every window is a session on this one server. Worth knowing: the server binds all interfaces, not only loopback; only /mcp checks Host/Origin.",
          "elements": [
            {
              "id": "live~e1791779110753",
              "category": "Class",
              "kind": "component",
              "name": "Live model",
              "stereotype": "in-memory · one process",
              "description": "The canonical copy of every open diagram, in the server's memory. Edits from your windows, from Orville and from agents at the MCP door relay between windows through it (InMemoryTeamUpdates — the desktop has no Redis; on the web the same seam is Redis). Every change is recorded in the modification register — who, what, why — with an agent's title and reasoning beside it, and sealed at your next Git commit."
            },
            {
              "id": "mcp~e1791779110754",
              "category": "Class",
              "kind": "component",
              "name": "MCP door",
              "stereotype": "/mcp · Streamable HTTP",
              "description": "http://127.0.0.1:<port>/mcp?project=<id> — a coding agent reads and writes diagrams through the same seams your windows use. Off by default (MCP ▸ MCP server on), Trial/Professional only, unkeyed on the desktop; ?project= scopes every call and picks the window an edit lands in. An edit lands through your open canvas as one undoable step; with no window on the project it goes straight to the file store."
            },
            {
              "id": "store~e1791779110755",
              "category": "Class",
              "kind": "component",
              "name": "File store",
              "stereotype": "FilePersistenceStore",
              "description": "The one writer of every file DrawMode keeps (IPersistence — the web swaps in Postgres behind the same seam). Saves 0.8 s after the last edit. A project in the data folder: one JSON file per diagram. A project in a Git repository: a baseline plus an append-only delta log per diagram, replayed on load; it watches the files every 2 s so a checkout or pull converges your open canvases, and reads .git itself to know what is committed — it never runs git."
            },
            {
              "id": "orville~e1791780021784",
              "category": "Class",
              "kind": "component",
              "name": "Orville",
              "stereotype": "the assistant · up to 4 owls",
              "description": "The in-app assistant, a second editor rather than your hand: he works in the project, knows the diagram in front and your selection, and his edits land through a canvas in his window as field patches with his own undo/redo history — your Cmd-Z never reaches his work (a field you both changed: last writer wins, and he says so). Up to four owls per window, one per chat tab — Orville, Wilbur, Katharine, Violeta — each a separate editor with his own history and his own row in the register (assistant#<owl>); the first tab is always Orville. He talks to OpenAI with your key, searches the documents you added, and on the desktop can list, read, search and edit the code at the project's root — only when you ask."
            }
          ]
        },
        {
          "id": "data~e1791779110746",
          "category": "Deployment",
          "kind": "infrastructure",
          "name": "DrawMode data folder",
          "stereotype": "Folder",
          "subtitle": "~/Documents/DrawMode — chosen at setup\nwhere a project lives by default",
          "description": "DRAWCORE_DATA_DIR, chosen in the Setup window (avatar ▸ Name & folder… moves it; View DrawMode local files… opens it in Finder / Explorer). Windows: %USERPROFILE%\\Documents\\DrawMode; Linux: ~/Documents/DrawMode. The app's own config.json and logs are separate, in ~/Library/Application Support/DrawMode (%APPDATA%\\DrawMode, ~/.config/DrawMode).",
          "elements": [
            {
              "id": "projects~e1791779110747",
              "category": "Deployment",
              "kind": "artifact",
              "name": "projects/<Name>/",
              "stereotype": "folder",
              "subtitle": "project.json · diagrams/<Diagram>.json — one file each\nsnapshots · modification register · chat",
              "description": "A project kept the default way: a readable tree named by the project's and diagrams' names (the ids inside the JSON keep references valid across renames). Images are inline. snapshots/ holds Save snapshot… and the automatic restore points; the register is who changed what and why."
            },
            {
              "id": "machine~e1791779110748",
              "category": "Deployment",
              "kind": "artifact",
              "name": "this machine's own",
              "stereotype": "file",
              "subtitle": "settings.json (AI keys, plan) · locations.json\nlinked/<project id>/ · views/ · vector_docs/",
              "description": "What never goes in a repository: settings.json (your OpenAI/Serper keys, the desktop key, the signed plan answer), locations.json (which Git repository each moved project lives in), linked/<project id>/ (the snapshots, register and chat of a project kept in Git — this machine's history), views/ (your pan and zoom per diagram), vector_docs/ (documents you added, chunked and embedded; search runs locally), last-port, .session-secret."
            }
          ]
        },
        {
          "id": "repo~e1791779110749",
          "category": "Deployment",
          "kind": "infrastructure",
          "name": "Your Git repository",
          "stereotype": "Folder",
          "subtitle": "any folder with .git — yours to branch, commit, push\nGit ▸ Move current project to repo…",
          "description": "Once a project is moved here it is files beside your code and travels with it: clone the repository on another machine and Git ▸ Link to existing project in repo… picks it up. DrawMode reads .git directly (HEAD, refs, the index, objects) to know what is committed — it performs no Git operation; you commit, branch and merge with your own git.",
          "elements": [
            {
              "id": "src~e1791779110750",
              "category": "Deployment",
              "kind": "artifact",
              "name": "src/",
              "stereotype": "folder",
              "subtitle": "your code — Orville reads or edits it only when you ask; file links open it",
              "description": "A shape's file link is a path from the repository root plus a line; a click opens it in your editor or the code tab. DrawMode never indexes or sends your source by itself: Orville lists, reads, searches or edits it only when you ask him to, and what he reads goes to OpenAI with your key. A coding agent over MCP reads it with its own tools and its own model — by your choice."
            },
            {
              "id": "dd~e1791779110751",
              "category": "Deployment",
              "kind": "artifact",
              "name": "drawmode-diagrams/",
              "stereotype": "folder",
              "subtitle": "per diagram: <Name>_<hash>.json baseline + _deltas.jsonl log\ndrawmode-project.json · .gitattributes *.jsonl merge=union",
              "description": "One folder at the repository root — commit it. A diagram is a baseline plus an append-only log of changes; a load replays the log, and two branches merge by Git's union rule + a field-by-field replay (last change wins). Undo truncates the log, never past what Git already has. Content only: no pan/zoom, no owner, no history. drawmode-cli baseline folds a log into its baseline."
            }
          ]
        },
        {
          "id": "you~e1791779110756",
          "category": "Deployment",
          "kind": "client",
          "name": "You",
          "stereotype": "Browser",
          "subtitle": "in DrawMode's windows\none session each",
          "description": "Every window — a project, a second window on it, a torn-off diagram — is an ordinary session on the one local server; edits relay between them through the live model, and presence shows each window as you."
        },
        {
          "id": "agent~e1791779110757",
          "category": "Deployment",
          "kind": "client",
          "name": "Coding agent",
          "stereotype": "Rich Client",
          "subtitle": "Claude Code · Codex\nover MCP, by your choice",
          "description": "Connects to the MCP door with the line MCP ▸ Connection keys… gives. It reads and writes your diagrams like a collaborator, under its own name in the register; whatever it sends to its own model is the agent's business — DrawMode is not in that path."
        },
        {
          "id": "cli~e1791779110758",
          "category": "Deployment",
          "kind": "client",
          "name": "Terminal",
          "stereotype": "Rich Client",
          "subtitle": "drawmode-cli\nbaseline · extract-pure · export · check",
          "description": "Avatar ▸ Install command line tool… puts drawmode-cli on PATH; it finds the project from the cwd's repository and works on the files directly — no running app needed, so CI can baseline, check and print the pure model. export-png/svg spawn a hidden window of the app."
        }
      ]
    },
    {
      "id": "remote~e1791779110759",
      "category": "Deployment",
      "kind": "infrastructure",
      "name": "Your Git remote",
      "stereotype": "Document Store",
      "subtitle": "GitHub · GitLab · … — you push and pull\nDrawMode never runs git",
      "description": "The diagram files travel with your code. A teammate's clone merges branches with the union rule in .gitattributes, and the app replays both sides' logs."
    }
  ],
  "links": [
    {
      "id": "link-ai-2~e1791779110743",
      "category": "Deployment",
      "kind": "communication",
      "source": "agent~e1791779110757",
      "target": "mcp~e1791779110754",
      "label": "reads + edits diagrams",
      "subtitle": "localhost · off by default"
    },
    {
      "id": "link-ai-5~e1791779110743",
      "category": "Deployment",
      "kind": "communication",
      "source": "store~e1791779110755",
      "target": "data~e1791779110746",
      "label": "a project by default",
      "subtitle": "one JSON file per diagram"
    },
    {
      "id": "link-ai-6~e1791779110743",
      "category": "Deployment",
      "kind": "communication",
      "source": "store~e1791779110755",
      "target": "dd~e1791779110751",
      "label": "a project moved to Git",
      "subtitle": "baseline + log · watches 2 s · reads .git"
    },
    {
      "id": "link-ai-10~e1791779110743",
      "category": "Deployment",
      "kind": "communication",
      "source": "cli~e1791779110758",
      "target": "dd~e1791779110751",
      "label": "works on the files directly",
      "subtitle": "no running app needed"
    },
    {
      "id": "link-ai-3~e1791779110743",
      "category": "Deployment",
      "kind": "communication",
      "source": "mcp~e1791779110754",
      "target": "live~e1791779110753",
      "label": "each edit / undo / redo",
      "subtitle": "via your open canvas",
      "description": "Each MCP call — a batch of ops, or a whole write — lands on your open canvas as a single undo step: one Cmd-Z reverts the agent's whole batch, your own edits undo as usual. With no window open on the project the edit is persisted headless, straight to the file store, and is not undoable from a canvas."
    },
    {
      "id": "link-ai-4~e1791779110743",
      "category": "Deployment",
      "kind": "communication",
      "source": "live~e1791779110753",
      "target": "store~e1791779110755",
      "label": "saves 0.8 s after the last edit",
      "subtitle": "records who did what, and why"
    },
    {
      "id": "link-ai-1~e1791780021784",
      "category": "Deployment",
      "kind": "communication",
      "source": "orville~e1791780021784",
      "target": "live~e1791779110753",
      "label": "a collaborator",
      "subtitle": "orville's own undo stack",
      "description": "His changes and undos go through the same delta plumbing as yours and a coding agent's, but into his own history: he undoes and redoes only his work, and yours stays yours. Undo is field by field and never blocks; what overlapped is said in his reply or your toast."
    },
    {
      "id": "link-ai-2~e1791781319146",
      "category": "Deployment",
      "kind": "communication",
      "source": "you~e1791779110756",
      "target": "node-ai-1~e1791781289697",
      "label": "draws · chats · commits",
      "subtitle": "a session per window"
    },
    {
      "id": "link-ai-11~e1791779110743",
      "category": "Deployment",
      "kind": "communication",
      "source": "repo~e1791779110749",
      "target": "remote~e1791779110759",
      "label": "you push + pull",
      "subtitle": "diagrams travel with your code"
    },
    {
      "id": "link-ai-3~e1791781319146",
      "category": "Deployment",
      "kind": "communication",
      "source": "node-ai-1~e1791781289697",
      "target": "ext_app~e1791779110742",
      "label": "once a day, and when you ask",
      "subtitle": "never your diagrams or keys"
    },
    {
      "id": "link-ai-4~e1791781319146",
      "category": "Deployment",
      "kind": "communication",
      "source": "node-ai-1~e1791781289697",
      "target": "ext_openai~e1791779110743",
      "label": "only when you use AI",
      "subtitle": "your own key"
    },
    {
      "id": "link-ai-5~e1791781319146",
      "category": "Deployment",
      "kind": "communication",
      "source": "node-ai-1~e1791781289697",
      "target": "ext_github~e1791779110744",
      "label": "downloads updates"
    }
  ]
}

Figure code: drawmode:p7bc9c303/d22877f2b

Explanation

The prompt:

Create me a UML deployment diagram showing how the app is installed on the machine, and what folders and systems it interfaces with.