# foreactlabs/openexecutive architecture

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

- Interactive diagram: https://gitdiagram.com/foreactlabs/openexecutive
- Repository: https://github.com/foreactlabs/openexecutive

## Overview

Open Executive is a configurable AI executive assistant: a person sends work through chat or a connected channel; the API/orchestrator routes it to specialist agents and tools, using company knowledge and memory, then returns a response or takes approval-governed action. It also supports proactive briefings, alerts, monitoring, scheduled workflows, browser use and MCP clients. The graph retains README capabilities even where their implementation was not sampled; those branches are linked only where README or excerpts establish the relationship.

Main entry points: [`packages/core/openexecutive/orchestrator`](https://github.com/foreactlabs/openexecutive/tree/main/packages/core/openexecutive/orchestrator) (Executive orchestrator), [`packages/core/openexecutive/alerts/pipeline.py`](https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/alerts/pipeline.py) (Approvals and alerts), [`packages/core/openexecutive/memory/episodic.py`](https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/memory/episodic.py) (Episodic memory), [`packages/core/openexecutive/api/main.py`](https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/api/main.py) (FastAPI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User surfaces"]
  node_channels["Connected channels"]
  node_web["Web application"]
  node_api["FastAPI<br/>[main.py]"]
  node_mcp["MCP server<br/>[server.py]"]
end

subgraph group_core["Executive runtime"]
  node_orchestrator["Executive orchestrator"]
  node_agents["Specialist council"]
  node_prompts["Prompt assembly<br/>[cache_manager.py]"]
end

subgraph group_context["Context and memory"]
  node_knowledge["Knowledge retrieval"]
  node_memory[("Episodic memory<br/>[episodic.py]")]
  node_honcho["Personal memory<br/>[honcho_client.py]"]
  node_people[("People registry<br/>[store.py]")]
end

subgraph group_actions["Delegation and governance"]
  node_delegation["Mail delegation"]
  node_approvals["Approvals and alerts<br/>[pipeline.py]"]
  node_browser["Browser actions"]
  node_workflows["Scheduled workflows"]
  node_workspace["Workspace services"]
end

subgraph group_proactive["Proactive operations"]
  node_briefing["Briefings and nudges<br/>[nudge_engine.py]"]
  node_monitoring["Watch monitoring<br/>[pipeline.py]"]
  node_audit[("Audit trail<br/>[context.py]")]
end

node_person(("Person"))

node_person -->|"uses"| node_web
node_person -->|"messages"| node_channels
node_web -->|"requests"| node_api
node_api -->|"routes turns"| node_orchestrator
node_mcp -->|"runs turns"| node_orchestrator
node_channels -.->|"delivers messages"| node_orchestrator
node_orchestrator -->|"consults"| node_agents
node_orchestrator -.->|"builds context"| node_prompts
node_orchestrator -->|"retrieves context"| node_knowledge
node_orchestrator -->|"records decisions"| node_memory
node_orchestrator -->|"recalls peers"| node_honcho
node_prompts -->|"reads initiatives"| node_memory
node_orchestrator -.->|"delegates tasks"| node_delegation
node_orchestrator -.->|"raises actions"| node_approvals
node_approvals -->|"routes by roster"| node_people
node_orchestrator -->|"uses browser"| node_browser
node_orchestrator -->|"runs workflows"| node_workflows
node_delegation -.->|"uses mail services"| node_workspace
node_briefing -->|"reads commitments"| node_memory
node_briefing -->|"creates cards"| node_approvals
node_monitoring -->|"promotes signals"| node_approvals
node_monitoring -->|"reads initiatives"| node_memory
node_api -->|"mounts service"| node_mcp
node_orchestrator -.->|"logs activity"| node_audit

click node_channels "https://github.com/foreactlabs/openexecutive/tree/main/packages/core/openexecutive/integrations"
click node_web "https://github.com/foreactlabs/openexecutive/tree/main/packages/ui/src/app"
click node_api "https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/api/main.py"
click node_mcp "https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/mcp_server/server.py"
click node_orchestrator "https://github.com/foreactlabs/openexecutive/tree/main/packages/core/openexecutive/orchestrator"
click node_agents "https://github.com/foreactlabs/openexecutive/tree/main/packages/core/openexecutive/agents"
click node_prompts "https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/prompts/cache_manager.py"
click node_knowledge "https://github.com/foreactlabs/openexecutive/tree/main/packages/core/openexecutive/knowledge"
click node_memory "https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/memory/episodic.py"
click node_honcho "https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/memory/honcho_client.py"
click node_people "https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/people/store.py"
click node_delegation "https://github.com/foreactlabs/openexecutive/tree/main/packages/core/openexecutive/delegation"
click node_approvals "https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/alerts/pipeline.py"
click node_browser "https://github.com/foreactlabs/openexecutive/tree/main/packages/core/openexecutive/browser"
click node_workflows "https://github.com/foreactlabs/openexecutive/tree/main/packages/core/openexecutive/workflows"
click node_briefing "https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/scheduler/nudge_engine.py"
click node_monitoring "https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/monitoring/pipeline.py"
click node_workspace "https://github.com/foreactlabs/openexecutive/tree/main/packages/core/openexecutive/integrations/workspace"
click node_audit "https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/audit/context.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_channels,node_web,node_api,node_mcp toneBlue
class node_orchestrator,node_agents,node_prompts toneAmber
class node_knowledge,node_memory,node_honcho,node_people toneMint
class node_delegation,node_approvals,node_browser,node_workflows,node_workspace toneRose
class node_briefing,node_monitoring,node_audit,node_person toneIndigo
```

## Components

### User surfaces

- [Connected channels](https://github.com/foreactlabs/openexecutive/tree/main/packages/core/openexecutive/integrations): `packages/core/openexecutive/integrations`
- [Web application](https://github.com/foreactlabs/openexecutive/tree/main/packages/ui/src/app): `packages/ui/src/app`
- [FastAPI](https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/api/main.py): `packages/core/openexecutive/api/main.py`
- [MCP server](https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/mcp_server/server.py): `packages/core/openexecutive/mcp_server/server.py`

### Executive runtime

- [Executive orchestrator](https://github.com/foreactlabs/openexecutive/tree/main/packages/core/openexecutive/orchestrator): `packages/core/openexecutive/orchestrator`
- [Specialist council](https://github.com/foreactlabs/openexecutive/tree/main/packages/core/openexecutive/agents): `packages/core/openexecutive/agents`
- [Prompt assembly](https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/prompts/cache_manager.py): `packages/core/openexecutive/prompts/cache_manager.py`

### Context and memory

- [Knowledge retrieval](https://github.com/foreactlabs/openexecutive/tree/main/packages/core/openexecutive/knowledge): `packages/core/openexecutive/knowledge`
- [Episodic memory](https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/memory/episodic.py): `packages/core/openexecutive/memory/episodic.py`
- [Personal memory](https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/memory/honcho_client.py): `packages/core/openexecutive/memory/honcho_client.py`
- [People registry](https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/people/store.py): `packages/core/openexecutive/people/store.py`

### Delegation and governance

- [Mail delegation](https://github.com/foreactlabs/openexecutive/tree/main/packages/core/openexecutive/delegation): `packages/core/openexecutive/delegation`
- [Approvals and alerts](https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/alerts/pipeline.py): `packages/core/openexecutive/alerts/pipeline.py`
- [Browser actions](https://github.com/foreactlabs/openexecutive/tree/main/packages/core/openexecutive/browser): `packages/core/openexecutive/browser`
- [Scheduled workflows](https://github.com/foreactlabs/openexecutive/tree/main/packages/core/openexecutive/workflows): `packages/core/openexecutive/workflows`
- [Workspace services](https://github.com/foreactlabs/openexecutive/tree/main/packages/core/openexecutive/integrations/workspace): `packages/core/openexecutive/integrations/workspace`

### Proactive operations

- [Briefings and nudges](https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/scheduler/nudge_engine.py): `packages/core/openexecutive/scheduler/nudge_engine.py`
- [Watch monitoring](https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/monitoring/pipeline.py): `packages/core/openexecutive/monitoring/pipeline.py`
- [Audit trail](https://github.com/foreactlabs/openexecutive/blob/main/packages/core/openexecutive/audit/context.py): `packages/core/openexecutive/audit/context.py`

### Other components

- **Person**

## Connections

- Person → Web application: uses
- Person → Connected channels: messages
- Web application → FastAPI: requests (evidence: `packages/ui/src/app/api/backend/[...path]/route.ts`)
- FastAPI → Executive orchestrator: routes turns (evidence: `packages/core/openexecutive/api/main.py`)
- MCP server → Executive orchestrator: runs turns (evidence: `packages/core/openexecutive/mcp_server/server.py`)
- Connected channels → Executive orchestrator: delivers messages
- Executive orchestrator → Specialist council: consults (evidence: `packages/core/openexecutive/orchestrator/router.py`)
- Executive orchestrator → Prompt assembly: builds context
- Executive orchestrator → Knowledge retrieval: retrieves context (evidence: `packages/core/openexecutive/orchestrator/router.py`)
- Executive orchestrator → Episodic memory: records decisions (evidence: `packages/core/openexecutive/memory/episodic.py`)
- Executive orchestrator → Personal memory: recalls peers (evidence: `packages/core/openexecutive/memory/honcho_client.py`)
- Prompt assembly → Episodic memory: reads initiatives (evidence: `packages/core/openexecutive/prompts/cache_manager.py`)
- Executive orchestrator → Mail delegation: delegates tasks
- Executive orchestrator → Approvals and alerts: raises actions
- Approvals and alerts → People registry: routes by roster (evidence: `packages/core/openexecutive/alerts/pipeline.py`)
- Executive orchestrator → Browser actions: uses browser
- Executive orchestrator → Scheduled workflows: runs workflows (evidence: `packages/core/openexecutive/mcp_server/server.py`)
- Mail delegation → Workspace services: uses mail services
- Briefings and nudges → Episodic memory: reads commitments (evidence: `packages/core/openexecutive/scheduler/nudge_engine.py`)
- Briefings and nudges → Approvals and alerts: creates cards (evidence: `packages/core/openexecutive/scheduler/nudge_engine.py`)
- Watch monitoring → Approvals and alerts: promotes signals (evidence: `packages/core/openexecutive/monitoring/pipeline.py`)
- Watch monitoring → Episodic memory: reads initiatives (evidence: `packages/core/openexecutive/monitoring/pipeline.py`)
- FastAPI → MCP server: mounts service (evidence: `packages/core/openexecutive/api/main.py`)
- Executive orchestrator → Audit trail: logs activity
