# jnathan34/c.o.d.y architecture

> Architecture diagram of the GitHub repository jnathan34/c.o.d.y, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jnathan34/c.o.d.y
- Repository: https://github.com/jnathan34/c.o.d.y

## Overview

C.O.D.Y. is a Windows desktop assistant combining an Electron UI with a native Windows engine. The user talks or types in the desktop island, selects an assistant, and receives responses or starts background work; permissioned control, browser actions, capture, annotations, and interactive visuals extend that workflow. The README documents the product-level connections, while sampled source confirms selected voice, engine, annotation, and visual implementation details. Other subsystem links are omitted where the supplied excerpts do not establish runtime wiring.

Main entry points: [`CODY-App/work/Cody.Core/Cody/Core/Voice/CompanionSession.cs`](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/work/Cody.Core/Cody/Core/Voice/CompanionSession.cs) (Voice session), [`CODY-App/work/Cody.Engine/Cody/App/App.cs`](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/work/Cody.Engine/Cody/App/App.cs) (Windows engine), [`CODY-App/frontend/original-cody/ui/app.js`](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/ui/app.js) (Chat interface), [`CODY-App/frontend/original-cody/src/control/tool-loop.js`](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/control/tool-loop.js) (Permissioned control)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop experience"]
  node_electron["Electron app<br/>[main.js]"]
  node_island["Desktop island<br/>[main.js]"]
  node_chat["Chat interface<br/>[app.js]"]
  node_islandtools["Island utilities"]
end

subgraph group_assistant["Assistant workflow"]
  node_voice["Voice session"]
  node_providers["Assistant providers"]
  node_tasks["Background tasks"]
  node_attachments["File attachments<br/>[attachments.js]"]
  node_memory["Local memory<br/>[service.js]"]
  node_agents["Agent runtime<br/>[AgentService.cs]"]
end

subgraph group_control["Computer interaction"]
  node_control["Permissioned control<br/>[tool-loop.js]"]
  node_browser["Browser connection"]
  node_capture["Screen capture"]
end

subgraph group_visuals["Visual tools"]
  node_annotations["Screen annotations<br/>[manager.js]"]
  node_scenes["Interactive 3D<br/>[manager.js]"]
  node_drawing["Drawing engine<br/>[NativeEngine.cs]"]
end

subgraph group_platform["Windows platform"]
  node_engine["Windows engine<br/>[App.cs]"]
  node_enginebridge["Engine bridge"]
end

node_user(("User"))
node_ai{{"AI services"}}
node_browserservice{{"Connected browser"}}

node_user -->|"speaks or types"| node_island
node_island -->|"opens chat"| node_chat
node_chat -.->|"submits requests"| node_voice
node_voice -->|"uses assistant"| node_providers
node_providers -->|"connects to"| node_ai
node_chat -->|"attaches files"| node_attachments
node_voice -->|"starts background work"| node_tasks
node_tasks -.->|"runs agent tasks"| node_agents
node_voice -->|"uses local memory"| node_memory
node_electron -->|"pairs with"| node_engine
node_engine -.->|"hosts bridge"| node_enginebridge
node_voice -->|"requests computer actions"| node_control
node_control -->|"controls Windows"| node_engine
node_control -->|"requests browser actions"| node_browser
node_browser -->|"requires connection"| node_browserservice
node_engine -->|"captures screen"| node_capture
node_voice -->|"creates annotations"| node_annotations
node_voice -->|"creates visual tools"| node_scenes
node_engine -.->|"supports drawing"| node_drawing
node_user -->|"uses daily tools"| node_islandtools

click node_electron "https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/main.js"
click node_island "https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/island/main.js"
click node_chat "https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/ui/app.js"
click node_voice "https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/work/Cody.Core/Cody/Core/Voice/CompanionSession.cs"
click node_providers "https://github.com/jnathan34/c.o.d.y/tree/main/CODY-App/frontend/original-cody/src/providers"
click node_tasks "https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/background-tasks.js"
click node_attachments "https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/attachments.js"
click node_memory "https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/memory/service.js"
click node_agents "https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/work/Cody.Agents/Cody/Agents/AgentService.cs"
click node_engine "https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/work/Cody.Engine/Cody/App/App.cs"
click node_enginebridge "https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/work/Cody.Engine/Cody/App/Cody/CodyEngineBridge.cs"
click node_control "https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/control/tool-loop.js"
click node_browser "https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/control/browser-observation.js"
click node_capture "https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/work/Cody.Platform/Cody/Platform/Capture/ScreenCaptureService.cs"
click node_annotations "https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/annotations/manager.js"
click node_scenes "https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/visuals/manager.js"
click node_drawing "https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/work/Cody.Drawing/Cody/Drawing/Engine/NativeEngine.cs"
click node_islandtools "https://github.com/jnathan34/c.o.d.y/tree/main/CODY-App/frontend/original-cody/src/island/renderer"

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_electron,node_island,node_chat,node_islandtools,node_user,node_browserservice toneBlue
class node_voice,node_providers,node_tasks,node_attachments,node_memory,node_agents toneAmber
class node_control,node_browser,node_capture toneMint
class node_annotations,node_scenes,node_drawing toneRose
class node_engine,node_enginebridge,node_ai toneIndigo
```

## Components

### Desktop experience

- [Electron app](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/main.js): `CODY-App/frontend/original-cody/src/main.js`
- [Desktop island](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/island/main.js): `CODY-App/frontend/original-cody/src/island/main.js`
- [Chat interface](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/ui/app.js): `CODY-App/frontend/original-cody/ui/app.js`
- [Island utilities](https://github.com/jnathan34/c.o.d.y/tree/main/CODY-App/frontend/original-cody/src/island/renderer): `CODY-App/frontend/original-cody/src/island/renderer`

### Assistant workflow

- [Voice session](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/work/Cody.Core/Cody/Core/Voice/CompanionSession.cs): `CODY-App/work/Cody.Core/Cody/Core/Voice/CompanionSession.cs`
- [Assistant providers](https://github.com/jnathan34/c.o.d.y/tree/main/CODY-App/frontend/original-cody/src/providers): `CODY-App/frontend/original-cody/src/providers`
- [Background tasks](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/background-tasks.js): `CODY-App/frontend/original-cody/src/background-tasks.js`
- [File attachments](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/attachments.js): `CODY-App/frontend/original-cody/src/attachments.js`
- [Local memory](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/memory/service.js): `CODY-App/frontend/original-cody/src/memory/service.js`
- [Agent runtime](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/work/Cody.Agents/Cody/Agents/AgentService.cs): `CODY-App/work/Cody.Agents/Cody/Agents/AgentService.cs`

### Computer interaction

- [Permissioned control](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/control/tool-loop.js): `CODY-App/frontend/original-cody/src/control/tool-loop.js`
- [Browser connection](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/control/browser-observation.js): `CODY-App/frontend/original-cody/src/control/browser-observation.js`
- [Screen capture](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/work/Cody.Platform/Cody/Platform/Capture/ScreenCaptureService.cs): `CODY-App/work/Cody.Platform/Cody/Platform/Capture/ScreenCaptureService.cs`

### Visual tools

- [Screen annotations](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/annotations/manager.js): `CODY-App/frontend/original-cody/src/annotations/manager.js`
- [Interactive 3D](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/frontend/original-cody/src/visuals/manager.js): `CODY-App/frontend/original-cody/src/visuals/manager.js`
- [Drawing engine](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/work/Cody.Drawing/Cody/Drawing/Engine/NativeEngine.cs): `CODY-App/work/Cody.Drawing/Cody/Drawing/Engine/NativeEngine.cs`

### Windows platform

- [Windows engine](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/work/Cody.Engine/Cody/App/App.cs): `CODY-App/work/Cody.Engine/Cody/App/App.cs`
- [Engine bridge](https://github.com/jnathan34/c.o.d.y/blob/main/CODY-App/work/Cody.Engine/Cody/App/Cody/CodyEngineBridge.cs): `CODY-App/work/Cody.Engine/Cody/App/Cody/CodyEngineBridge.cs`

### Other components

- **User**
- **AI services**
- **Connected browser**

## Connections

- User → Desktop island: speaks or types (evidence: `README.md`)
- Desktop island → Chat interface: opens chat (evidence: `README.md`)
- Chat interface → Voice session: submits requests
- Voice session → Assistant providers: uses assistant (evidence: `README.md`)
- Assistant providers → AI services: connects to (evidence: `README.md`)
- Chat interface → File attachments: attaches files (evidence: `README.md`)
- Voice session → Background tasks: starts background work (evidence: `README.md`)
- Background tasks → Agent runtime: runs agent tasks
- Voice session → Local memory: uses local memory (evidence: `README.md`)
- Electron app → Windows engine: pairs with (evidence: `README.md`)
- Windows engine → Engine bridge: hosts bridge (evidence: `CODY-App/work/Cody.Engine/Cody/App/Cody/CodyEngineBridge.cs`)
- Voice session → Permissioned control: requests computer actions (evidence: `README.md`)
- Permissioned control → Windows engine: controls Windows (evidence: `README.md`)
- Permissioned control → Browser connection: requests browser actions (evidence: `README.md`)
- Browser connection → Connected browser: requires connection (evidence: `README.md`)
- Windows engine → Screen capture: captures screen (evidence: `README.md`)
- Voice session → Screen annotations: creates annotations (evidence: `README.md`)
- Voice session → Interactive 3D: creates visual tools (evidence: `README.md`)
- Windows engine → Drawing engine: supports drawing
- User → Island utilities: uses daily tools (evidence: `README.md`)
