How sabeurmohamedamin/chat-on-steroids works
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: tools.ts MCP tools · chat.ts Workspace renderer · server.ts MCP server · bridge.ts Request bridge
Components 21
Workspace UI
- Workspace renderer
src/renderer/chat.ts - Settings UI
src/renderer/main.ts - Preload API
src/preload/index.ts
Conversation bridge
- Electron main
src/main/index.ts - Request bridge
src/main/bridge.ts - Companion extension
extension/background.js - Session recorder
src/main/session/recorder.ts - Session state
src/main/session/store.ts
Local tools
- MCP server
src/main/mcp/server.ts - MCP tools
src/main/mcp/tools.ts - Project workspace
src/main/projects.ts - Terminal execution
src/main/codex/unified-exec.ts - Desktop control
src/main/computer/index.ts - Browser control
src/main/browser-control.ts - Plugin integrations
src/main/plugins/manager.ts
Work management
- Worker agents
src/main/agents.ts - Goal and Loop
src/main/goal.ts - Workspace settings
src/main/config.ts - Activity log
src/main/logger.ts
Other components
- User
- ChatGPT conversation
Connections 22
- User → Workspace renderer: submits task
README.md - User → Settings UI: configures workspace
README.md - Workspace renderer → Preload API: invokes API
src/renderer/main.ts - Settings UI → Preload API: saves settings
src/renderer/main.ts - Preload API → Request bridge: IPC requests
src/preload/index.ts - Electron main → Request bridge: initializes
src/main/index.ts - Request bridge → Session state: uses session state
src/main/bridge.ts - Request bridge → Session recorder: records activity
src/main/bridge.ts - Companion extension → ChatGPT conversation: observes conversation
README.md - ChatGPT conversation → MCP server: sends tool requests
README.md - MCP server → MCP tools: dispatches tools
src/main/mcp/server.ts - MCP server → Workspace settings: loads configuration
src/main/mcp/server.ts - MCP tools → Project workspace: offers project tools
README.md - MCP tools → Terminal execution: offers terminal tools
README.md - MCP tools → Desktop control: offers desktop tools
README.md - MCP tools → Browser control: offers browser tools
README.md - MCP tools → Plugin integrations: exposes integrations
README.md - Workspace renderer → Worker agents: presents workers
src/renderer/chat.ts - Workspace renderer → Goal and Loop: presents long tasks
README.md - Electron main → Workspace settings: loads settings
src/main/index.ts - Electron main → Plugin integrations: initializes plugins
src/main/index.ts - MCP server → Activity log: logs operations
src/main/mcp/server.ts