# iv-litovchenko/agentcms architecture

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

- Interactive diagram: https://gitdiagram.com/iv-litovchenko/agentcms
- Repository: https://github.com/iv-litovchenko/agentcms

## Overview

Agent CMS is a file-based workspace for human and AI-agent memory, with Markdown/YAML as the source of truth and no separate content database. The main workflow is to capture or organize material in the editor, expose the same workspace to agents through MCP, and retrieve it through word, semantic, or hybrid search. Voice and browser clients are additional entry points. The README documents the shared-workspace design; source excerpts show MCP tool registration and shell runtime calls, but do not expose most server routing, editor wiring, or index orchestration.

Main entry points: [`server.js`](https://github.com/iv-litovchenko/agentcms/blob/main/server.js) (CMS server), [`public/main.js`](https://github.com/iv-litovchenko/agentcms/blob/main/public/main.js) (CMS editor), [`browser-extension/content-script.js`](https://github.com/iv-litovchenko/agentcms/blob/main/browser-extension/content-script.js) (Browser toolbar), [`agent-shell/shell-service.js`](https://github.com/iv-litovchenko/agentcms/blob/main/agent-shell/shell-service.js) (Voice shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User interfaces"]
  node_editor["CMS editor<br/>[main.js]"]
  node_browser["Browser toolbar<br/>[content-script.js]"]
  node_desktop["CMS desktop<br/>[main.js]"]
  node_voice["Voice shell<br/>[shell-service.js]"]
  node_iphone["iPhone voice"]
end

subgraph group_agent["Agent access"]
  node_mcp["MCP tools<br/>[index.js]"]
end

subgraph group_workspace["Workspace services"]
  node_server["CMS server<br/>[server.js]"]
  node_settings["Workspace settings<br/>[settings-store.js]"]
  node_workspacefiles[("Workspace files<br/>[manifest-paths.js]")]
  node_catalog["Content catalog"]
  node_platform["Platform services"]
  node_shellruntime["Agent runtime<br/>[shell-service.js]"]
  node_qwenpaw["QwenPaw client<br/>[qwenpaw-client.js]"]
end

subgraph group_indexes["Search and media"]
  node_fulltext["Word search<br/>[service.js]"]
  node_semantic["Semantic search<br/>[service.js]"]
  node_links["Link index<br/>[service.js]"]
  node_ocr["OCR index<br/>[service.js]"]
  node_websearch["Web search"]
  node_media["Media import<br/>[media-import.js]"]
end

node_person(("Person"))
node_agentclient(("AI agent"))

node_person -->|"uses"| node_editor
node_person -->|"captures with"| node_browser
node_person -->|"speaks to"| node_voice
node_person -->|"speaks to"| node_iphone
node_editor -->|"accesses"| node_server
node_browser -->|"shares workspace"| node_server
node_desktop -->|"starts"| node_server
node_voice -->|"calls runtime"| node_qwenpaw
node_agentclient -->|"invokes tools"| node_mcp
node_mcp -->|"calls API"| node_server
node_server -.->|"reads and writes"| node_workspacefiles
node_server -.->|"uses"| node_settings
node_settings -->|"loads types"| node_catalog
node_server -.->|"serves platform"| node_platform
node_server -.->|"searches words"| node_fulltext
node_server -.->|"searches meaning"| node_semantic
node_server -.->|"queries links"| node_links
node_server -.->|"runs OCR"| node_ocr
node_server -.->|"offers web search"| node_websearch
node_websearch -->|"imports results"| node_media

click node_editor "https://github.com/iv-litovchenko/agentcms/blob/main/public/main.js"
click node_browser "https://github.com/iv-litovchenko/agentcms/blob/main/browser-extension/content-script.js"
click node_desktop "https://github.com/iv-litovchenko/agentcms/blob/main/desktop/agent-cms/main.js"
click node_voice "https://github.com/iv-litovchenko/agentcms/blob/main/agent-shell/shell-service.js"
click node_iphone "https://github.com/iv-litovchenko/agentcms/blob/main/mobile/iphone-shell/AgentShell/Services/ShellAPIClient.swift"
click node_mcp "https://github.com/iv-litovchenko/agentcms/blob/main/mcp-server/index.js"
click node_server "https://github.com/iv-litovchenko/agentcms/blob/main/server.js"
click node_settings "https://github.com/iv-litovchenko/agentcms/blob/main/lib/config/settings-store.js"
click node_workspacefiles "https://github.com/iv-litovchenko/agentcms/blob/main/lib/config/manifest-paths.js"
click node_catalog "https://github.com/iv-litovchenko/agentcms/blob/main/lib/catalog/type-catalog-loader.js"
click node_platform "https://github.com/iv-litovchenko/agentcms/blob/main/lib/platform/platform-mcp-service.js"
click node_shellruntime "https://github.com/iv-litovchenko/agentcms/blob/main/agent-shell/shell-service.js"
click node_qwenpaw "https://github.com/iv-litovchenko/agentcms/blob/main/agent-shell/qwenpaw-client.js"
click node_fulltext "https://github.com/iv-litovchenko/agentcms/blob/main/lib/indexes/fulltext-index/service.js"
click node_semantic "https://github.com/iv-litovchenko/agentcms/blob/main/lib/indexes/semantic-search/service.js"
click node_links "https://github.com/iv-litovchenko/agentcms/blob/main/lib/indexes/link-index/service.js"
click node_ocr "https://github.com/iv-litovchenko/agentcms/blob/main/lib/indexes/ocr-index/service.js"
click node_websearch "https://github.com/iv-litovchenko/agentcms/blob/main/lib/services/web-search-service.js"
click node_media "https://github.com/iv-litovchenko/agentcms/blob/main/lib/media/media-import.js"

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_editor,node_browser,node_desktop,node_voice,node_iphone toneBlue
class node_mcp toneAmber
class node_server,node_settings,node_workspacefiles,node_catalog,node_platform,node_shellruntime,node_qwenpaw toneMint
class node_fulltext,node_semantic,node_links,node_ocr,node_websearch,node_media toneRose
class node_person,node_agentclient toneIndigo
```

## Components

### User interfaces

- [CMS editor](https://github.com/iv-litovchenko/agentcms/blob/main/public/main.js): `public/main.js`
- [Browser toolbar](https://github.com/iv-litovchenko/agentcms/blob/main/browser-extension/content-script.js): `browser-extension/content-script.js`
- [CMS desktop](https://github.com/iv-litovchenko/agentcms/blob/main/desktop/agent-cms/main.js): `desktop/agent-cms/main.js`
- [Voice shell](https://github.com/iv-litovchenko/agentcms/blob/main/agent-shell/shell-service.js): `agent-shell/shell-service.js`
- [iPhone voice](https://github.com/iv-litovchenko/agentcms/blob/main/mobile/iphone-shell/AgentShell/Services/ShellAPIClient.swift): `mobile/iphone-shell/AgentShell/Services/ShellAPIClient.swift`

### Agent access

- [MCP tools](https://github.com/iv-litovchenko/agentcms/blob/main/mcp-server/index.js): `mcp-server/index.js`

### Workspace services

- [CMS server](https://github.com/iv-litovchenko/agentcms/blob/main/server.js): `server.js`
- [Workspace settings](https://github.com/iv-litovchenko/agentcms/blob/main/lib/config/settings-store.js): `lib/config/settings-store.js`
- [Workspace files](https://github.com/iv-litovchenko/agentcms/blob/main/lib/config/manifest-paths.js): `lib/config/manifest-paths.js`
- [Content catalog](https://github.com/iv-litovchenko/agentcms/blob/main/lib/catalog/type-catalog-loader.js): `lib/catalog/type-catalog-loader.js`
- [Platform services](https://github.com/iv-litovchenko/agentcms/blob/main/lib/platform/platform-mcp-service.js): `lib/platform/platform-mcp-service.js`
- [Agent runtime](https://github.com/iv-litovchenko/agentcms/blob/main/agent-shell/shell-service.js): `agent-shell/shell-service.js`
- [QwenPaw client](https://github.com/iv-litovchenko/agentcms/blob/main/agent-shell/qwenpaw-client.js): `agent-shell/qwenpaw-client.js`

### Search and media

- [Word search](https://github.com/iv-litovchenko/agentcms/blob/main/lib/indexes/fulltext-index/service.js): `lib/indexes/fulltext-index/service.js`
- [Semantic search](https://github.com/iv-litovchenko/agentcms/blob/main/lib/indexes/semantic-search/service.js): `lib/indexes/semantic-search/service.js`
- [Link index](https://github.com/iv-litovchenko/agentcms/blob/main/lib/indexes/link-index/service.js): `lib/indexes/link-index/service.js`
- [OCR index](https://github.com/iv-litovchenko/agentcms/blob/main/lib/indexes/ocr-index/service.js): `lib/indexes/ocr-index/service.js`
- [Web search](https://github.com/iv-litovchenko/agentcms/blob/main/lib/services/web-search-service.js): `lib/services/web-search-service.js`
- [Media import](https://github.com/iv-litovchenko/agentcms/blob/main/lib/media/media-import.js): `lib/media/media-import.js`

### Other components

- **Person**
- **AI agent**

## Connections

- Person → CMS editor: uses (evidence: `README.md`)
- Person → Browser toolbar: captures with (evidence: `README.md`)
- Person → Voice shell: speaks to (evidence: `README.md`)
- Person → iPhone voice: speaks to (evidence: `README.md`)
- CMS editor → CMS server: accesses (evidence: `README.md`)
- Browser toolbar → CMS server: shares workspace (evidence: `README.md`)
- CMS desktop → CMS server: starts (evidence: `desktop/agent-cms/main.js`)
- Voice shell → QwenPaw client: calls runtime (evidence: `agent-shell/shell-service.js`)
- AI agent → MCP tools: invokes tools (evidence: `README.md`)
- MCP tools → CMS server: calls API (evidence: `mcp-server/index.js`)
- CMS server → Workspace files: reads and writes
- CMS server → Workspace settings: uses
- Workspace settings → Content catalog: loads types (evidence: `lib/config/settings-store.js`)
- CMS server → Platform services: serves platform
- CMS server → Word search: searches words
- CMS server → Semantic search: searches meaning
- CMS server → Link index: queries links
- CMS server → OCR index: runs OCR
- CMS server → Web search: offers web search
- Web search → Media import: imports results (evidence: `lib/services/web-search-service.js`)
