# emersonschulze/ia_coder architecture

> Architecture diagram of the GitHub repository emersonschulze/ia_coder, 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/emersonschulze/ia_coder
- Repository: https://github.com/emersonschulze/ia_coder

## Overview

IA_Coder is a visual AI-agent orchestrator: users submit text, voice, or image requests through Talking, review a proposed plan, and confirm before the server runs a workflow. Results are narrated in the conversation and can be saved for reuse in Tree. The map also includes documented catalog, account-usage, MCP, settings, and voice capabilities. Several UI panels and server subsystems are represented by their exact tree paths but were not sampled; their links are included only where the README or shown references support them.

Main entry points: [`apps/server/src/index.ts`](https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/index.ts) (WebSocket Server), [`apps/web/src/App.tsx`](https://github.com/emersonschulze/ia_coder/blob/main/apps/web/src/App.tsx) (Application Shell), [`apps/server/src/orchestrator.ts`](https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/orchestrator.ts) (Workflow Orchestrator), [`apps/server/src/knowledge.ts`](https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/knowledge.ts) (Tree Knowledge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Desktop Interface"]
  node_app["Application Shell<br/>[App.tsx]"]
  node_talking["Talking Panel"]
  node_panels["Agent Status Panels<br/>[AgentsPanel.tsx]"]
  node_treeui["Tree Panel<br/>[TreePanel.tsx]"]
  node_socket["WebSocket Client<br/>[ws.ts]"]
  node_session["Session Store<br/>[useSession.ts]"]
end

subgraph group_workflow["Workflow Runtime"]
  node_server["WebSocket Server<br/>[index.ts]"]
  node_conversation["Plan Conversation<br/>[conversation.ts]"]
  node_orchestrator["Workflow Orchestrator<br/>[orchestrator.ts]"]
  node_claude["Claude Session<br/>[claude.ts]"]
  node_catalog["Agent Skill Catalog<br/>[catalog.ts]"]
  node_discovery["Installed Discovery<br/>[discovery.ts]"]
end

subgraph group_memory["Project Memory"]
  node_tree["Tree Knowledge<br/>[knowledge.ts]"]
  node_embeddings["Text Embeddings<br/>[embeddings.ts]"]
  node_postgres[("Postgres Store<br/>[db.ts]")]
end

subgraph group_services["Integrations"]
  node_auth["Claude Authentication<br/>[auth.ts]"]
  node_mcp["MCP Servers<br/>[mcp.ts]"]
  node_usage["Account Usage<br/>[usage.ts]"]
  node_settings["Runtime Settings<br/>[settings.ts]"]
  node_voice["Voice Services<br/>[voice.ts]"]
  node_piper["Piper Speech<br/>[server.py]"]
end

node_user(("User"))

node_user -->|"submits request"| node_talking
node_app -->|"renders"| node_talking
node_app -->|"renders"| node_panels
node_app -->|"creates client"| node_socket
node_app -->|"applies events"| node_session
node_app -->|"requests subjects"| node_treeui
node_talking -->|"sends messages"| node_socket
node_socket -->|"exchanges events"| node_server
node_server -->|"routes requests"| node_conversation
node_server -->|"starts workflow"| node_orchestrator
node_conversation -->|"uses session"| node_claude
node_orchestrator -->|"drives agents"| node_claude
node_orchestrator -->|"uses catalog"| node_catalog
node_orchestrator -->|"uses discoveries"| node_discovery
node_orchestrator -->|"publishes usage"| node_usage
node_server -->|"recalls context"| node_tree
node_server -->|"saves subjects"| node_tree
node_tree -->|"reads and writes"| node_postgres
node_tree -->|"embeds text"| node_embeddings
node_server -->|"checks login"| node_auth
node_server -->|"lists servers"| node_mcp
node_server -->|"handles settings"| node_settings
node_server -->|"handles voice"| node_voice
node_user -.->|"uses voice output"| node_piper

click node_app "https://github.com/emersonschulze/ia_coder/blob/main/apps/web/src/App.tsx"
click node_talking "https://github.com/emersonschulze/ia_coder/blob/main/apps/web/src/components/ConversationPanel.tsx"
click node_panels "https://github.com/emersonschulze/ia_coder/blob/main/apps/web/src/components/AgentsPanel.tsx"
click node_treeui "https://github.com/emersonschulze/ia_coder/blob/main/apps/web/src/components/TreePanel.tsx"
click node_socket "https://github.com/emersonschulze/ia_coder/blob/main/apps/web/src/lib/ws.ts"
click node_session "https://github.com/emersonschulze/ia_coder/blob/main/apps/web/src/store/useSession.ts"
click node_server "https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/index.ts"
click node_conversation "https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/conversation.ts"
click node_orchestrator "https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/orchestrator.ts"
click node_claude "https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/claude.ts"
click node_catalog "https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/catalog.ts"
click node_discovery "https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/discovery.ts"
click node_tree "https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/knowledge.ts"
click node_embeddings "https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/embeddings.ts"
click node_postgres "https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/db.ts"
click node_auth "https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/auth.ts"
click node_mcp "https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/mcp.ts"
click node_usage "https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/usage.ts"
click node_settings "https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/settings.ts"
click node_voice "https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/voice.ts"
click node_piper "https://github.com/emersonschulze/ia_coder/blob/main/docker/piper/server.py"

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_app,node_talking,node_panels,node_treeui,node_socket,node_session,node_user toneBlue
class node_server,node_conversation,node_orchestrator,node_claude,node_catalog,node_discovery toneAmber
class node_tree,node_embeddings,node_postgres toneMint
class node_auth,node_mcp,node_usage,node_settings,node_voice,node_piper toneRose
```

## Components

### Desktop Interface

- [Application Shell](https://github.com/emersonschulze/ia_coder/blob/main/apps/web/src/App.tsx): `apps/web/src/App.tsx`
- [Talking Panel](https://github.com/emersonschulze/ia_coder/blob/main/apps/web/src/components/ConversationPanel.tsx): `apps/web/src/components/ConversationPanel.tsx`
- [Agent Status Panels](https://github.com/emersonschulze/ia_coder/blob/main/apps/web/src/components/AgentsPanel.tsx): `apps/web/src/components/AgentsPanel.tsx`
- [Tree Panel](https://github.com/emersonschulze/ia_coder/blob/main/apps/web/src/components/TreePanel.tsx): `apps/web/src/components/TreePanel.tsx`
- [WebSocket Client](https://github.com/emersonschulze/ia_coder/blob/main/apps/web/src/lib/ws.ts): `apps/web/src/lib/ws.ts`
- [Session Store](https://github.com/emersonschulze/ia_coder/blob/main/apps/web/src/store/useSession.ts): `apps/web/src/store/useSession.ts`

### Workflow Runtime

- [WebSocket Server](https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/index.ts): `apps/server/src/index.ts`
- [Plan Conversation](https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/conversation.ts): `apps/server/src/conversation.ts`
- [Workflow Orchestrator](https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/orchestrator.ts): `apps/server/src/orchestrator.ts`
- [Claude Session](https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/claude.ts): `apps/server/src/claude.ts`
- [Agent Skill Catalog](https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/catalog.ts): `apps/server/src/catalog.ts`
- [Installed Discovery](https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/discovery.ts): `apps/server/src/discovery.ts`

### Project Memory

- [Tree Knowledge](https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/knowledge.ts): `apps/server/src/knowledge.ts`
- [Text Embeddings](https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/embeddings.ts): `apps/server/src/embeddings.ts`
- [Postgres Store](https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/db.ts): `apps/server/src/db.ts`

### Integrations

- [Claude Authentication](https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/auth.ts): `apps/server/src/auth.ts`
- [MCP Servers](https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/mcp.ts): `apps/server/src/mcp.ts`
- [Account Usage](https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/usage.ts): `apps/server/src/usage.ts`
- [Runtime Settings](https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/settings.ts): `apps/server/src/settings.ts`
- [Voice Services](https://github.com/emersonschulze/ia_coder/blob/main/apps/server/src/voice.ts): `apps/server/src/voice.ts`
- [Piper Speech](https://github.com/emersonschulze/ia_coder/blob/main/docker/piper/server.py): `docker/piper/server.py`

### Other components

- **User**

## Connections

- User → Talking Panel: submits request (evidence: `README.md`)
- Application Shell → Talking Panel: renders (evidence: `apps/web/src/App.tsx`)
- Application Shell → Agent Status Panels: renders (evidence: `apps/web/src/App.tsx`)
- Application Shell → WebSocket Client: creates client (evidence: `apps/web/src/App.tsx`)
- Application Shell → Session Store: applies events (evidence: `apps/web/src/App.tsx`)
- Application Shell → Tree Panel: requests subjects (evidence: `apps/web/src/App.tsx`)
- Talking Panel → WebSocket Client: sends messages (evidence: `README.md`)
- WebSocket Client → WebSocket Server: exchanges events (evidence: `README.md`)
- WebSocket Server → Plan Conversation: routes requests (evidence: `apps/server/src/index.ts`)
- WebSocket Server → Workflow Orchestrator: starts workflow (evidence: `apps/server/src/index.ts`)
- Plan Conversation → Claude Session: uses session (evidence: `apps/server/src/conversation.ts`)
- Workflow Orchestrator → Claude Session: drives agents (evidence: `apps/server/src/orchestrator.ts`)
- Workflow Orchestrator → Agent Skill Catalog: uses catalog (evidence: `apps/server/src/orchestrator.ts`)
- Workflow Orchestrator → Installed Discovery: uses discoveries (evidence: `apps/server/src/orchestrator.ts`)
- Workflow Orchestrator → Account Usage: publishes usage (evidence: `apps/server/src/orchestrator.ts`)
- WebSocket Server → Tree Knowledge: recalls context (evidence: `apps/server/src/index.ts`)
- WebSocket Server → Tree Knowledge: saves subjects (evidence: `apps/server/src/index.ts`)
- Tree Knowledge → Postgres Store: reads and writes (evidence: `apps/server/src/knowledge.ts`)
- Tree Knowledge → Text Embeddings: embeds text (evidence: `apps/server/src/knowledge.ts`)
- WebSocket Server → Claude Authentication: checks login (evidence: `apps/server/src/index.ts`)
- WebSocket Server → MCP Servers: lists servers (evidence: `apps/server/src/index.ts`)
- WebSocket Server → Runtime Settings: handles settings (evidence: `apps/server/src/index.ts`)
- WebSocket Server → Voice Services: handles voice (evidence: `apps/server/src/index.ts`)
- User → Piper Speech: uses voice output (evidence: `README.md`)
