# kortix-ai/companyos architecture

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

- Interactive diagram: https://gitdiagram.com/kortix-ai/companyos
- Repository: https://github.com/kortix-ai/companyos

## Overview

Kortix CompanyOS is a cloud-native, event-driven agent platform. People reach shared projects and sessions through its apps and messaging integrations; schedules, webhooks, and other events can also start work. My Kortix hands tasks to persistent agent sessions, which can use computers, connectors, shared state, and hosted apps; teams review changes before they land. The README documents these product relationships, while the sampled source gives only a partial view of their implementation. The graph therefore emphasizes documented capabilities and avoids inferring unsampled call paths.

Main entry points: [`apps/api/src/channels/core/sessions.ts`](https://github.com/kortix-ai/companyos/blob/dev/apps/api/src/channels/core/sessions.ts) (Agent sessions), [`apps/web`](https://github.com/kortix-ai/companyos/tree/dev/apps/web) (Web and mobile), [`apps/api/src/channels`](https://github.com/kortix-ai/companyos/tree/dev/apps/api/src/channels) (Team messaging), [`apps/api/src`](https://github.com/kortix-ai/companyos/tree/dev/apps/api/src) (Triggers and loops)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_reach["Reach and control"]
  node_web_mobile["Web and mobile"]
  node_messaging["Team messaging"]
  node_api["Product API<br/>[app.ts]"]
end

subgraph group_orchestration["Work orchestration"]
  node_triggers["Triggers and loops"]
  node_my_kortix["My Kortix"]
  node_agent_sessions["Agent sessions<br/>[sessions.ts]"]
  node_swarms["Swarms and workflows"]
  node_outcomes["Outcomes"]
end

subgraph group_execution["Agent execution"]
  node_computers["Cloud computers<br/>[machines.ts]"]
  node_agent_config["Agents and skills"]
  node_connectors["Connectors and tools"]
end

subgraph group_resources["Shared resources"]
  node_drive[("Drive and memory")]
  node_workspace[("Session workspace<br/>[volume-store.ts]")]
  node_session_record[("Session record")]
  node_hosted_apps["Hosted apps<br/>[hosting.ts]"]
  node_capture["Capture"]
  node_artifacts["Artifacts and collaboration"]
end

subgraph group_governance["Governance and operations"]
  node_change_review["Change review"]
  node_account_iam["Accounts and IAM<br/>[app.ts]"]
  node_billing["Billing and usage<br/>[storage-charges.ts]"]
end

node_people(("People"))
node_event_sources(("Event sources"))

node_people -->|"work through"| node_web_mobile
node_people -->|"message through"| node_messaging
node_web_mobile -->|"use shared projects"| node_api
node_messaging -->|"start or continue"| node_agent_sessions
node_event_sources -->|"start work"| node_triggers
node_triggers -->|"start or wake"| node_agent_sessions
node_people -->|"ask for work"| node_my_kortix
node_my_kortix -->|"hand off"| node_agent_sessions
node_agent_sessions -->|"delegate work"| node_swarms
node_agent_sessions -->|"work toward"| node_outcomes
node_agent_sessions -->|"run on"| node_computers
node_agent_sessions -->|"use configured"| node_agent_config
node_agent_sessions -->|"use tools"| node_connectors
node_agent_sessions -->|"read and share"| node_drive
node_agent_sessions -->|"persist files"| node_workspace
node_agent_sessions -->|"retain history"| node_session_record
node_agent_sessions -->|"build and host"| node_hosted_apps
node_agent_sessions -->|"propose changes"| node_change_review
node_people -->|"approve changes"| node_change_review
node_people -->|"share access"| node_account_iam
node_computers -.->|"meter storage"| node_billing
node_people -.->|"manage capture"| node_capture
node_agent_sessions -.->|"collaborate on"| node_artifacts

click node_web_mobile "https://github.com/kortix-ai/companyos/tree/dev/apps/web"
click node_messaging "https://github.com/kortix-ai/companyos/tree/dev/apps/api/src/channels"
click node_api "https://github.com/kortix-ai/companyos/blob/dev/apps/api/src/app.ts"
click node_triggers "https://github.com/kortix-ai/companyos/tree/dev/apps/api/src"
click node_my_kortix "https://github.com/kortix-ai/companyos/tree/dev/apps/api/src/channels"
click node_agent_sessions "https://github.com/kortix-ai/companyos/blob/dev/apps/api/src/channels/core/sessions.ts"
click node_swarms "https://github.com/kortix-ai/companyos/tree/dev/apps/api/src"
click node_outcomes "https://github.com/kortix-ai/companyos/tree/dev/apps/api/src"
click node_computers "https://github.com/kortix-ai/companyos/blob/dev/apps/api/src/apps/machines.ts"
click node_agent_config "https://github.com/kortix-ai/companyos/tree/dev/apps/api/src/config-releases"
click node_connectors "https://github.com/kortix-ai/companyos/tree/dev/apps/api/src/connectors"
click node_drive "https://github.com/kortix-ai/companyos/tree/dev/apps/api/src/projects"
click node_workspace "https://github.com/kortix-ai/companyos/blob/dev/apps/api/src/apps/volume-store.ts"
click node_session_record "https://github.com/kortix-ai/companyos/tree/dev/apps/api/src"
click node_hosted_apps "https://github.com/kortix-ai/companyos/blob/dev/apps/api/src/apps/hosting.ts"
click node_change_review "https://github.com/kortix-ai/companyos/tree/dev/apps/api/src"
click node_account_iam "https://github.com/kortix-ai/companyos/blob/dev/apps/api/src/accounts/core/app.ts"
click node_billing "https://github.com/kortix-ai/companyos/blob/dev/apps/api/src/billing/services/storage-charges.ts"
click node_capture "https://github.com/kortix-ai/companyos/tree/dev/apps/api/src/capture"
click node_artifacts "https://github.com/kortix-ai/companyos/tree/dev/apps/api/src/artifacts"

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_web_mobile,node_messaging,node_api toneBlue
class node_triggers,node_my_kortix,node_agent_sessions,node_swarms,node_outcomes toneAmber
class node_computers,node_agent_config,node_connectors toneMint
class node_drive,node_workspace,node_session_record,node_hosted_apps,node_capture,node_artifacts toneRose
class node_change_review,node_account_iam,node_billing,node_people,node_event_sources toneIndigo
```

## Components

### Reach and control

- [Web and mobile](https://github.com/kortix-ai/companyos/tree/dev/apps/web): `apps/web`
- [Team messaging](https://github.com/kortix-ai/companyos/tree/dev/apps/api/src/channels): `apps/api/src/channels`
- [Product API](https://github.com/kortix-ai/companyos/blob/dev/apps/api/src/app.ts): `apps/api/src/app.ts`

### Work orchestration

- [Triggers and loops](https://github.com/kortix-ai/companyos/tree/dev/apps/api/src): `apps/api/src`
- [My Kortix](https://github.com/kortix-ai/companyos/tree/dev/apps/api/src/channels): `apps/api/src/channels`
- [Agent sessions](https://github.com/kortix-ai/companyos/blob/dev/apps/api/src/channels/core/sessions.ts): `apps/api/src/channels/core/sessions.ts`
- [Swarms and workflows](https://github.com/kortix-ai/companyos/tree/dev/apps/api/src): `apps/api/src`
- [Outcomes](https://github.com/kortix-ai/companyos/tree/dev/apps/api/src): `apps/api/src`

### Agent execution

- [Cloud computers](https://github.com/kortix-ai/companyos/blob/dev/apps/api/src/apps/machines.ts): `apps/api/src/apps/machines.ts`
- [Agents and skills](https://github.com/kortix-ai/companyos/tree/dev/apps/api/src/config-releases): `apps/api/src/config-releases`
- [Connectors and tools](https://github.com/kortix-ai/companyos/tree/dev/apps/api/src/connectors): `apps/api/src/connectors`

### Shared resources

- [Drive and memory](https://github.com/kortix-ai/companyos/tree/dev/apps/api/src/projects): `apps/api/src/projects`
- [Session workspace](https://github.com/kortix-ai/companyos/blob/dev/apps/api/src/apps/volume-store.ts): `apps/api/src/apps/volume-store.ts`
- [Session record](https://github.com/kortix-ai/companyos/tree/dev/apps/api/src): `apps/api/src`
- [Hosted apps](https://github.com/kortix-ai/companyos/blob/dev/apps/api/src/apps/hosting.ts): `apps/api/src/apps/hosting.ts`
- [Capture](https://github.com/kortix-ai/companyos/tree/dev/apps/api/src/capture): `apps/api/src/capture`
- [Artifacts and collaboration](https://github.com/kortix-ai/companyos/tree/dev/apps/api/src/artifacts): `apps/api/src/artifacts`

### Governance and operations

- [Change review](https://github.com/kortix-ai/companyos/tree/dev/apps/api/src): `apps/api/src`
- [Accounts and IAM](https://github.com/kortix-ai/companyos/blob/dev/apps/api/src/accounts/core/app.ts): `apps/api/src/accounts/core/app.ts`
- [Billing and usage](https://github.com/kortix-ai/companyos/blob/dev/apps/api/src/billing/services/storage-charges.ts): `apps/api/src/billing/services/storage-charges.ts`

### Other components

- **People**
- **Event sources**

## Connections

- People → Web and mobile: work through (evidence: `README.md`)
- People → Team messaging: message through (evidence: `README.md`)
- Web and mobile → Product API: use shared projects (evidence: `README.md`)
- Team messaging → Agent sessions: start or continue (evidence: `README.md`)
- Event sources → Triggers and loops: start work (evidence: `README.md`)
- Triggers and loops → Agent sessions: start or wake (evidence: `README.md`)
- People → My Kortix: ask for work (evidence: `README.md`)
- My Kortix → Agent sessions: hand off (evidence: `README.md`)
- Agent sessions → Swarms and workflows: delegate work (evidence: `README.md`)
- Agent sessions → Outcomes: work toward (evidence: `README.md`)
- Agent sessions → Cloud computers: run on (evidence: `README.md`)
- Agent sessions → Agents and skills: use configured (evidence: `README.md`)
- Agent sessions → Connectors and tools: use tools (evidence: `README.md`)
- Agent sessions → Drive and memory: read and share (evidence: `README.md`)
- Agent sessions → Session workspace: persist files (evidence: `README.md`)
- Agent sessions → Session record: retain history (evidence: `README.md`)
- Agent sessions → Hosted apps: build and host (evidence: `README.md`)
- Agent sessions → Change review: propose changes (evidence: `README.md`)
- People → Change review: approve changes (evidence: `README.md`)
- People → Accounts and IAM: share access (evidence: `README.md`)
- Cloud computers → Billing and usage: meter storage (evidence: `apps/api/src/billing/services/storage-charges.ts`)
- People → Capture: manage capture (evidence: `apps/api/src/capture/enrollment-routes.ts`)
- Agent sessions → Artifacts and collaboration: collaborate on (evidence: `README.md`)