# receptron/mulmoclaude architecture

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

- Interactive diagram: https://gitdiagram.com/receptron/mulmoclaude
- Repository: https://github.com/receptron/mulmoclaude

## Overview

MulmoClaude is a local-first AI assistant and personal application platform. The main workflow is a user chatting with Claude, which can compose registered plugin capabilities and present results in the canvas. Users also build persistent workspace knowledge and data through the wiki, collections, and feeds, and can automate recurring work or reach the same assistant through messaging bridges. The graph preserves these documented branches; source excerpts show selected engine behavior, but do not establish every server route or runtime connection.

Main entry points: [`server/agent/index.ts`](https://github.com/receptron/mulmoclaude/blob/main/server/agent/index.ts) (Agent runtime), [`src/App.vue`](https://github.com/receptron/mulmoclaude/blob/main/src/App.vue) (Chat canvas), [`server/index.ts`](https://github.com/receptron/mulmoclaude/blob/main/server/index.ts) (Server host), [`packages/client/src/client.ts`](https://github.com/receptron/mulmoclaude/blob/main/packages/client/src/client.ts) (Client transport)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Chat interaction"]
  node_app["Chat canvas<br/>[App.vue]"]
  node_sessions["Session lifecycle"]
  node_client["Client transport<br/>[client.ts]"]
  node_server["Server host<br/>[index.ts]"]
end

subgraph group_agent["Agent and plugins"]
  node_agent_runtime["Agent runtime<br/>[index.ts]"]
  node_roles["Assistant roles<br/>[roles.ts]"]
  node_tools["Tool registry<br/>[index.ts]"]
  node_plugin_views["Plugin views<br/>[App.vue]"]
end

subgraph group_workspace["Workspace capabilities"]
  node_collections[("Collections")]
  node_wiki["Personal wiki<br/>[engine.ts]"]
  node_feeds["Data feeds<br/>[engine.ts]"]
  node_workspace_files[("Workspace files")]
end

subgraph group_automation["Automation and notifications"]
  node_scheduler["Recurring tasks<br/>[user-tasks.ts]"]
  node_notifier["Notifications<br/>[engine.ts]"]
end

subgraph group_connectivity["Remote access"]
  node_bridges["Messaging bridges"]
  node_chat_service["Chat relay<br/>[index.ts]"]
  node_messaging_apps(("Messaging apps"))
end

node_user(("User"))
node_claude["Claude Code"]

node_user -->|"chats with"| node_app
node_app -->|"manages sessions"| node_sessions
node_app -->|"renders plugin"| node_plugin_views
node_app -.->|"uses client"| node_client
node_client -.->|"connects to"| node_server
node_server -.->|"dispatches turns"| node_agent_runtime
node_agent_runtime -.->|"invokes"| node_claude
node_agent_runtime -->|"uses role config"| node_roles
node_agent_runtime -.->|"composes capabilities"| node_tools
node_tools -->|"selects view"| node_plugin_views
node_agent_runtime -.->|"builds memory"| node_wiki
node_agent_runtime -.->|"uses data apps"| node_collections
node_agent_runtime -.->|"uses feed tools"| node_feeds
node_feeds -->|"upserts records"| node_collections
node_user -->|"requests recurring task"| node_scheduler
node_scheduler -->|"starts scheduled chat"| node_agent_runtime
node_server -->|"binds notifier"| node_notifier
node_user -->|"messages through"| node_messaging_apps
node_messaging_apps -->|"sends messages"| node_bridges
node_bridges -.->|"relays messages"| node_chat_service
node_chat_service -->|"connects by socket"| node_server

click node_app "https://github.com/receptron/mulmoclaude/blob/main/src/App.vue"
click node_sessions "https://github.com/receptron/mulmoclaude/blob/main/src/composables/useSessionLifecycle.ts"
click node_client "https://github.com/receptron/mulmoclaude/blob/main/packages/client/src/client.ts"
click node_server "https://github.com/receptron/mulmoclaude/blob/main/server/index.ts"
click node_agent_runtime "https://github.com/receptron/mulmoclaude/blob/main/server/agent/index.ts"
click node_roles "https://github.com/receptron/mulmoclaude/blob/main/src/config/roles.ts"
click node_tools "https://github.com/receptron/mulmoclaude/blob/main/src/tools/index.ts"
click node_plugin_views "https://github.com/receptron/mulmoclaude/blob/main/src/App.vue"
click node_collections "https://github.com/receptron/mulmoclaude/tree/main/packages/core/src/collection"
click node_wiki "https://github.com/receptron/mulmoclaude/blob/main/packages/core/src/wiki/server/engine.ts"
click node_feeds "https://github.com/receptron/mulmoclaude/blob/main/packages/core/src/feeds/server/engine.ts"
click node_workspace_files "https://github.com/receptron/mulmoclaude/tree/main/packages/core/src/files"
click node_scheduler "https://github.com/receptron/mulmoclaude/blob/main/server/workspace/skills/user-tasks.ts"
click node_notifier "https://github.com/receptron/mulmoclaude/blob/main/server/notifier/engine.ts"
click node_bridges "https://github.com/receptron/mulmoclaude/tree/main/packages/bridges"
click node_chat_service "https://github.com/receptron/mulmoclaude/blob/main/packages/chat-service/src/index.ts"

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_sessions,node_client,node_server,node_user toneBlue
class node_agent_runtime,node_roles,node_tools,node_plugin_views toneAmber
class node_collections,node_wiki,node_feeds,node_workspace_files toneMint
class node_scheduler,node_notifier toneRose
class node_bridges,node_chat_service,node_messaging_apps,node_claude toneIndigo
```

## Components

### Chat interaction

- [Chat canvas](https://github.com/receptron/mulmoclaude/blob/main/src/App.vue): `src/App.vue`
- [Session lifecycle](https://github.com/receptron/mulmoclaude/blob/main/src/composables/useSessionLifecycle.ts): `src/composables/useSessionLifecycle.ts`
- [Client transport](https://github.com/receptron/mulmoclaude/blob/main/packages/client/src/client.ts): `packages/client/src/client.ts`
- [Server host](https://github.com/receptron/mulmoclaude/blob/main/server/index.ts): `server/index.ts`

### Agent and plugins

- [Agent runtime](https://github.com/receptron/mulmoclaude/blob/main/server/agent/index.ts): `server/agent/index.ts`
- [Assistant roles](https://github.com/receptron/mulmoclaude/blob/main/src/config/roles.ts): `src/config/roles.ts`
- [Tool registry](https://github.com/receptron/mulmoclaude/blob/main/src/tools/index.ts): `src/tools/index.ts`
- [Plugin views](https://github.com/receptron/mulmoclaude/blob/main/src/App.vue): `src/App.vue`

### Workspace capabilities

- [Collections](https://github.com/receptron/mulmoclaude/tree/main/packages/core/src/collection): `packages/core/src/collection`
- [Personal wiki](https://github.com/receptron/mulmoclaude/blob/main/packages/core/src/wiki/server/engine.ts): `packages/core/src/wiki/server/engine.ts`
- [Data feeds](https://github.com/receptron/mulmoclaude/blob/main/packages/core/src/feeds/server/engine.ts): `packages/core/src/feeds/server/engine.ts`
- [Workspace files](https://github.com/receptron/mulmoclaude/tree/main/packages/core/src/files): `packages/core/src/files`

### Automation and notifications

- [Recurring tasks](https://github.com/receptron/mulmoclaude/blob/main/server/workspace/skills/user-tasks.ts): `server/workspace/skills/user-tasks.ts`
- [Notifications](https://github.com/receptron/mulmoclaude/blob/main/server/notifier/engine.ts): `server/notifier/engine.ts`

### Remote access

- [Messaging bridges](https://github.com/receptron/mulmoclaude/tree/main/packages/bridges): `packages/bridges`
- [Chat relay](https://github.com/receptron/mulmoclaude/blob/main/packages/chat-service/src/index.ts): `packages/chat-service/src/index.ts`
- **Messaging apps**

### Other components

- **User**
- **Claude Code**

## Connections

- User → Chat canvas: chats with (evidence: `README.md`)
- Chat canvas → Session lifecycle: manages sessions (evidence: `src/composables/useSessionLifecycle.ts`)
- Chat canvas → Plugin views: renders plugin (evidence: `src/App.vue`)
- Chat canvas → Client transport: uses client
- Client transport → Server host: connects to
- Server host → Agent runtime: dispatches turns
- Agent runtime → Claude Code: invokes
- Agent runtime → Assistant roles: uses role config (evidence: `server/agent/index.ts`)
- Agent runtime → Tool registry: composes capabilities (evidence: `README.md`)
- Tool registry → Plugin views: selects view (evidence: `src/App.vue`)
- Agent runtime → Personal wiki: builds memory (evidence: `README.md`)
- Agent runtime → Collections: uses data apps (evidence: `README.md`)
- Agent runtime → Data feeds: uses feed tools (evidence: `README.md`)
- Data feeds → Collections: upserts records (evidence: `packages/core/src/feeds/server/engine.ts`)
- User → Recurring tasks: requests recurring task (evidence: `README.md`)
- Recurring tasks → Agent runtime: starts scheduled chat (evidence: `server/workspace/skills/user-tasks.ts`)
- Server host → Notifications: binds notifier (evidence: `server/notifier/engine.ts`)
- User → Messaging apps: messages through (evidence: `README.md`)
- Messaging apps → Messaging bridges: sends messages (evidence: `README.md`)
- Messaging bridges → Chat relay: relays messages
- Chat relay → Server host: connects by socket (evidence: `README.md`)
