# sabeurmohamedamin/chat-on-steroids architecture

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

- Interactive diagram: https://gitdiagram.com/sabeurmohamedamin/chat-on-steroids
- Repository: https://github.com/sabeurmohamedamin/chat-on-steroids

## Overview

Chat On Steroids is an Electron coding workspace that uses a user’s ChatGPT conversation to operate on local projects. The principal workflow is: the user configures a workspace and sends a task in the renderer; the preload and main-process bridge handle the request; the companion extension connects the conversation to the local MCP server; and enabled tools provide project, terminal, browser, desktop, and plugin capabilities. Session recording, worker delegation, and long-running Goal/Loop work are distinct supporting stages. The README documents these capabilities; some internal links below rely on the SOURCE INDEX because implementation excerpts were incomplete.

Main entry points: [`src/main/mcp/tools.ts`](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/mcp/tools.ts) (MCP tools), [`src/renderer/chat.ts`](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/renderer/chat.ts) (Workspace renderer), [`src/main/mcp/server.ts`](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/mcp/server.ts) (MCP server), [`src/main/bridge.ts`](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/bridge.ts) (Request bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Workspace UI"]
  node_renderer["Workspace renderer<br/>[chat.ts]"]
  node_settings["Settings UI<br/>[main.ts]"]
  node_preload["Preload API<br/>[index.ts]"]
end

subgraph group_conversation["Conversation bridge"]
  node_main["Electron main<br/>[index.ts]"]
  node_bridge["Request bridge<br/>[bridge.ts]"]
  node_extension["Companion extension<br/>[background.js]"]
  node_recorder["Session recorder<br/>[recorder.ts]"]
  node_session[("Session state<br/>[store.ts]")]
end

subgraph group_tools["Local tools"]
  node_mcp["MCP server<br/>[server.ts]"]
  node_toolset["MCP tools<br/>[tools.ts]"]
  node_workspace["Project workspace<br/>[projects.ts]"]
  node_exec["Terminal execution<br/>[unified-exec.ts]"]
  node_computer["Desktop control<br/>[index.ts]"]
  node_browser["Browser control<br/>[browser-control.ts]"]
  node_plugins["Plugin integrations<br/>[manager.ts]"]
end

subgraph group_support["Work management"]
  node_agents["Worker agents<br/>[agents.ts]"]
  node_goal["Goal and Loop<br/>[goal.ts]"]
  node_config["Workspace settings<br/>[config.ts]"]
  node_activity["Activity log<br/>[logger.ts]"]
end

node_user(("User"))
node_chatgpt(("ChatGPT conversation"))

node_user -->|"submits task"| node_renderer
node_user -->|"configures workspace"| node_settings
node_renderer -->|"invokes API"| node_preload
node_settings -->|"saves settings"| node_preload
node_preload -->|"IPC requests"| node_bridge
node_main -->|"initializes"| node_bridge
node_bridge -->|"uses session state"| node_session
node_bridge -->|"records activity"| node_recorder
node_extension -->|"observes conversation"| node_chatgpt
node_chatgpt -->|"sends tool requests"| node_mcp
node_mcp -->|"dispatches tools"| node_toolset
node_mcp -->|"loads configuration"| node_config
node_toolset -->|"offers project tools"| node_workspace
node_toolset -->|"offers terminal tools"| node_exec
node_toolset -->|"offers desktop tools"| node_computer
node_toolset -->|"offers browser tools"| node_browser
node_toolset -->|"exposes integrations"| node_plugins
node_renderer -->|"presents workers"| node_agents
node_renderer -->|"presents long tasks"| node_goal
node_main -->|"loads settings"| node_config
node_main -->|"initializes plugins"| node_plugins
node_mcp -->|"logs operations"| node_activity

click node_renderer "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/renderer/chat.ts"
click node_settings "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/renderer/main.ts"
click node_preload "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/preload/index.ts"
click node_main "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/index.ts"
click node_bridge "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/bridge.ts"
click node_extension "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/extension/background.js"
click node_recorder "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/session/recorder.ts"
click node_session "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/session/store.ts"
click node_mcp "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/mcp/server.ts"
click node_toolset "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/mcp/tools.ts"
click node_workspace "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/projects.ts"
click node_exec "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/codex/unified-exec.ts"
click node_computer "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/computer/index.ts"
click node_browser "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/browser-control.ts"
click node_plugins "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/plugins/manager.ts"
click node_agents "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/agents.ts"
click node_goal "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/goal.ts"
click node_config "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/config.ts"
click node_activity "https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/logger.ts"

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_renderer,node_settings,node_preload,node_user toneBlue
class node_main,node_bridge,node_extension,node_recorder,node_session toneAmber
class node_mcp,node_toolset,node_workspace,node_exec,node_computer,node_browser,node_plugins toneMint
class node_agents,node_goal,node_config,node_activity toneRose
class node_chatgpt toneIndigo
```

## Components

### Workspace UI

- [Workspace renderer](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/renderer/chat.ts): `src/renderer/chat.ts`
- [Settings UI](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/renderer/main.ts): `src/renderer/main.ts`
- [Preload API](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/preload/index.ts): `src/preload/index.ts`

### Conversation bridge

- [Electron main](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/index.ts): `src/main/index.ts`
- [Request bridge](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/bridge.ts): `src/main/bridge.ts`
- [Companion extension](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/extension/background.js): `extension/background.js`
- [Session recorder](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/session/recorder.ts): `src/main/session/recorder.ts`
- [Session state](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/session/store.ts): `src/main/session/store.ts`

### Local tools

- [MCP server](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/mcp/server.ts): `src/main/mcp/server.ts`
- [MCP tools](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/mcp/tools.ts): `src/main/mcp/tools.ts`
- [Project workspace](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/projects.ts): `src/main/projects.ts`
- [Terminal execution](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/codex/unified-exec.ts): `src/main/codex/unified-exec.ts`
- [Desktop control](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/computer/index.ts): `src/main/computer/index.ts`
- [Browser control](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/browser-control.ts): `src/main/browser-control.ts`
- [Plugin integrations](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/plugins/manager.ts): `src/main/plugins/manager.ts`

### Work management

- [Worker agents](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/agents.ts): `src/main/agents.ts`
- [Goal and Loop](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/goal.ts): `src/main/goal.ts`
- [Workspace settings](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/config.ts): `src/main/config.ts`
- [Activity log](https://github.com/sabeurmohamedamin/chat-on-steroids/blob/main/src/main/logger.ts): `src/main/logger.ts`

### Other components

- **User**
- **ChatGPT conversation**

## Connections

- User → Workspace renderer: submits task (evidence: `README.md`)
- User → Settings UI: configures workspace (evidence: `README.md`)
- Workspace renderer → Preload API: invokes API (evidence: `src/renderer/main.ts`)
- Settings UI → Preload API: saves settings (evidence: `src/renderer/main.ts`)
- Preload API → Request bridge: IPC requests (evidence: `src/preload/index.ts`)
- Electron main → Request bridge: initializes (evidence: `src/main/index.ts`)
- Request bridge → Session state: uses session state (evidence: `src/main/bridge.ts`)
- Request bridge → Session recorder: records activity (evidence: `src/main/bridge.ts`)
- Companion extension → ChatGPT conversation: observes conversation (evidence: `README.md`)
- ChatGPT conversation → MCP server: sends tool requests (evidence: `README.md`)
- MCP server → MCP tools: dispatches tools (evidence: `src/main/mcp/server.ts`)
- MCP server → Workspace settings: loads configuration (evidence: `src/main/mcp/server.ts`)
- MCP tools → Project workspace: offers project tools (evidence: `README.md`)
- MCP tools → Terminal execution: offers terminal tools (evidence: `README.md`)
- MCP tools → Desktop control: offers desktop tools (evidence: `README.md`)
- MCP tools → Browser control: offers browser tools (evidence: `README.md`)
- MCP tools → Plugin integrations: exposes integrations (evidence: `README.md`)
- Workspace renderer → Worker agents: presents workers (evidence: `src/renderer/chat.ts`)
- Workspace renderer → Goal and Loop: presents long tasks (evidence: `README.md`)
- Electron main → Workspace settings: loads settings (evidence: `src/main/index.ts`)
- Electron main → Plugin integrations: initializes plugins (evidence: `src/main/index.ts`)
- MCP server → Activity log: logs operations (evidence: `src/main/mcp/server.ts`)
