How iv-litovchenko/agentcms works
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 CMS server · main.js CMS editor · content-script.js Browser toolbar · shell-service.js Voice shell
Components 21
User interfaces
- CMS editor
public/main.js - Browser toolbar
browser-extension/content-script.js - CMS desktop
desktop/agent-cms/main.js - Voice shell
agent-shell/shell-service.js - iPhone voice
mobile/iphone-shell/AgentShell/Services/ShellAPIClient.swift
Agent access
- MCP tools
mcp-server/index.js
Workspace services
- CMS server
server.js - Workspace settings
lib/config/settings-store.js - Workspace files
lib/config/manifest-paths.js - Content catalog
lib/catalog/type-catalog-loader.js - Platform services
lib/platform/platform-mcp-service.js - Agent runtime
agent-shell/shell-service.js - QwenPaw client
agent-shell/qwenpaw-client.js
Search and media
- Word search
lib/indexes/fulltext-index/service.js - Semantic search
lib/indexes/semantic-search/service.js - Link index
lib/indexes/link-index/service.js - OCR index
lib/indexes/ocr-index/service.js - Web search
lib/services/web-search-service.js - Media import
lib/media/media-import.js
Other components
- Person
- AI agent
Connections 20
- Person → CMS editor: uses
README.md - Person → Browser toolbar: captures with
README.md - Person → Voice shell: speaks to
README.md - Person → iPhone voice: speaks to
README.md - CMS editor → CMS server: accesses
README.md - Browser toolbar → CMS server: shares workspace
README.md - CMS desktop → CMS server: starts
desktop/agent-cms/main.js - Voice shell → QwenPaw client: calls runtime
agent-shell/shell-service.js - AI agent → MCP tools: invokes tools
README.md - MCP tools → CMS server: calls API
mcp-server/index.js - CMS server → Workspace files: reads and writes
- CMS server → Workspace settings: uses
- Workspace settings → Content catalog: loads types
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
lib/services/web-search-service.js