# cjl26rg2/void-script architecture

> Architecture diagram of the GitHub repository cjl26rg2/void-script, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cjl26rg2/void-script
- Repository: https://github.com/cjl26rg2/void-script

## Overview

VoidScript turns an AI chat in a browser into a Roblox Studio agent: the extension detects a provider’s reply, parses commands, and sends them through a local bridge to Studio’s MCP server, returning results to the chat. The bridge also exposes embedded animation/VFX tools. The repository includes a separate Tauri desktop client with its own bridge connection and AI chat. README claims cover script/tree operations, Luau execution, asset generation, Creator Store access, play-testing, and persistent project memory; source excerpts do not expose every implementation path, so those capabilities are represented at the documented feature level.

Main entry points: [`desktop/ui/app.js`](https://github.com/cjl26rg2/void-script/blob/master/desktop/ui/app.js) (Desktop interface), [`bridge.py`](https://github.com/cjl26rg2/void-script/blob/master/bridge.py) (Bridge and MCP manager), [`voidscript-extension/core/main.js`](https://github.com/cjl26rg2/void-script/blob/master/voidscript-extension/core/main.js) (Agent loop), [`voidscript-extension/providers`](https://github.com/cjl26rg2/void-script/tree/master/voidscript-extension/providers) (Chat providers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_extension["Browser agent"]
  node_provider["Chat providers"]
  node_agent["Agent loop<br/>[main.js]"]
  node_parser["Command parser<br/>[parser.js]"]
  node_worker["Extension worker<br/>[background.js]"]
  node_popup["Status and settings<br/>[popup.js]"]
end

subgraph group_bridge["Local bridge"]
  node_bridgecore["Bridge and MCP manager<br/>[bridge.py]"]
  node_launcher["Studio MCP launcher"]
end

subgraph group_studio["Studio tools"]
  node_creative["Animation and VFX tools<br/>[creatives.py]"]
  node_roblox["Roblox Studio MCP"]
  node_capabilities["Studio agent capabilities"]
end

subgraph group_desktop["Desktop client"]
  node_desktopui["Desktop interface<br/>[app.js]"]
  node_desktopbackend["Desktop backend<br/>[main.rs]"]
  node_kit["Desktop generation kit<br/>[toolkit.js]"]
  node_modelkit["Desktop model kit<br/>[modelkit.js]"]
  node_modelview["Desktop model viewer<br/>[modelview.js]"]
  node_uikit["Desktop UI kit<br/>[uikit.js]"]
end

node_user(("User"))
node_chat(("AI chat site"))

node_user -->|"requests work"| node_chat
node_chat -->|"hosts extension"| node_provider
node_provider -->|"supplies chat interface"| node_agent
node_agent -->|"parses commands"| node_parser
node_agent -->|"requests execution"| node_worker
node_worker -->|"sends commands"| node_bridgecore
node_bridgecore -->|"forwards MCP calls"| node_roblox
node_bridgecore -->|"imports launcher"| node_launcher
node_bridgecore -->|"dispatches tools"| node_creative
node_creative -->|"runs generated Luau"| node_roblox
node_roblox -->|"provides agent operations"| node_capabilities
node_agent -->|"returns tool results"| node_chat
node_user -->|"manages session"| node_popup
node_user -->|"uses desktop client"| node_desktopui
node_desktopui -->|"invokes commands"| node_desktopbackend
node_desktopbackend -->|"connects to bridge"| node_bridgecore
node_desktopui -->|"uses generation kit"| node_kit
node_desktopui -.-> node_modelkit
node_desktopui -.-> node_modelview
node_desktopui -.-> node_uikit

click node_provider "https://github.com/cjl26rg2/void-script/tree/master/voidscript-extension/providers"
click node_agent "https://github.com/cjl26rg2/void-script/blob/master/voidscript-extension/core/main.js"
click node_parser "https://github.com/cjl26rg2/void-script/blob/master/voidscript-extension/core/parser.js"
click node_worker "https://github.com/cjl26rg2/void-script/blob/master/voidscript-extension/background.js"
click node_popup "https://github.com/cjl26rg2/void-script/blob/master/voidscript-extension/popup.js"
click node_bridgecore "https://github.com/cjl26rg2/void-script/blob/master/bridge.py"
click node_launcher "https://github.com/cjl26rg2/void-script/blob/master/launch_studio_mcp.py"
click node_creative "https://github.com/cjl26rg2/void-script/blob/master/creatives.py"
click node_desktopui "https://github.com/cjl26rg2/void-script/blob/master/desktop/ui/app.js"
click node_desktopbackend "https://github.com/cjl26rg2/void-script/blob/master/desktop/src-tauri/src/main.rs"
click node_kit "https://github.com/cjl26rg2/void-script/blob/master/desktop/ui/toolkit.js"
click node_modelkit "https://github.com/cjl26rg2/void-script/blob/master/desktop/ui/modelkit.js"
click node_modelview "https://github.com/cjl26rg2/void-script/blob/master/desktop/ui/modelview.js"
click node_uikit "https://github.com/cjl26rg2/void-script/blob/master/desktop/ui/uikit.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_provider,node_agent,node_parser,node_worker,node_popup,node_user toneBlue
class node_bridgecore,node_launcher toneAmber
class node_creative,node_roblox,node_capabilities toneMint
class node_desktopui,node_desktopbackend,node_kit,node_modelkit,node_modelview,node_uikit toneRose
class node_chat toneIndigo
```

## Components

### Browser agent

- [Chat providers](https://github.com/cjl26rg2/void-script/tree/master/voidscript-extension/providers): `voidscript-extension/providers`
- [Agent loop](https://github.com/cjl26rg2/void-script/blob/master/voidscript-extension/core/main.js): `voidscript-extension/core/main.js`
- [Command parser](https://github.com/cjl26rg2/void-script/blob/master/voidscript-extension/core/parser.js): `voidscript-extension/core/parser.js`
- [Extension worker](https://github.com/cjl26rg2/void-script/blob/master/voidscript-extension/background.js): `voidscript-extension/background.js`
- [Status and settings](https://github.com/cjl26rg2/void-script/blob/master/voidscript-extension/popup.js): `voidscript-extension/popup.js`

### Local bridge

- [Bridge and MCP manager](https://github.com/cjl26rg2/void-script/blob/master/bridge.py): `bridge.py`
- [Studio MCP launcher](https://github.com/cjl26rg2/void-script/blob/master/launch_studio_mcp.py): `launch_studio_mcp.py`

### Studio tools

- [Animation and VFX tools](https://github.com/cjl26rg2/void-script/blob/master/creatives.py): `creatives.py`
- **Roblox Studio MCP**
- **Studio agent capabilities**

### Desktop client

- [Desktop interface](https://github.com/cjl26rg2/void-script/blob/master/desktop/ui/app.js): `desktop/ui/app.js`
- [Desktop backend](https://github.com/cjl26rg2/void-script/blob/master/desktop/src-tauri/src/main.rs): `desktop/src-tauri/src/main.rs`
- [Desktop generation kit](https://github.com/cjl26rg2/void-script/blob/master/desktop/ui/toolkit.js): `desktop/ui/toolkit.js`
- [Desktop model kit](https://github.com/cjl26rg2/void-script/blob/master/desktop/ui/modelkit.js): `desktop/ui/modelkit.js`
- [Desktop model viewer](https://github.com/cjl26rg2/void-script/blob/master/desktop/ui/modelview.js): `desktop/ui/modelview.js`
- [Desktop UI kit](https://github.com/cjl26rg2/void-script/blob/master/desktop/ui/uikit.js): `desktop/ui/uikit.js`

### Other components

- **User**
- **AI chat site**

## Connections

- User → AI chat site: requests work
- AI chat site → Chat providers: hosts extension
- Chat providers → Agent loop: supplies chat interface (evidence: `voidscript-extension/core/main.js`)
- Agent loop → Command parser: parses commands (evidence: `voidscript-extension/core/main.js`)
- Agent loop → Extension worker: requests execution (evidence: `voidscript-extension/core/main.js`)
- Extension worker → Bridge and MCP manager: sends commands
- Bridge and MCP manager → Roblox Studio MCP: forwards MCP calls
- Bridge and MCP manager → Studio MCP launcher: imports launcher (evidence: `bridge.py`)
- Bridge and MCP manager → Animation and VFX tools: dispatches tools (evidence: `bridge.py`)
- Animation and VFX tools → Roblox Studio MCP: runs generated Luau (evidence: `creatives.py`)
- Roblox Studio MCP → Studio agent capabilities: provides agent operations
- Agent loop → AI chat site: returns tool results
- User → Status and settings: manages session (evidence: `voidscript-extension/popup.js`)
- User → Desktop interface: uses desktop client
- Desktop interface → Desktop backend: invokes commands (evidence: `desktop/ui/app.js`)
- Desktop backend → Bridge and MCP manager: connects to bridge (evidence: `desktop/src-tauri/src/main.rs`)
- Desktop interface → Desktop generation kit: uses generation kit (evidence: `desktop/ui/app.js`)
- Desktop interface → Desktop model kit
- Desktop interface → Desktop model viewer
- Desktop interface → Desktop UI kit
