How receptron/mulmoclaude works
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: agent/index.ts Agent runtime · App.vue Chat canvas · server/index.ts Server host · client.ts Client transport
Components 19
Chat interaction
- Chat canvas
src/App.vue - Session lifecycle
src/composables/useSessionLifecycle.ts - Client transport
packages/client/src/client.ts - Server host
server/index.ts
Agent and plugins
- Agent runtime
server/agent/index.ts - Assistant roles
src/config/roles.ts - Tool registry
src/tools/index.ts - Plugin views
src/App.vue
Workspace capabilities
- Collections
packages/core/src/collection - Personal wiki
packages/core/src/wiki/server/engine.ts - Data feeds
packages/core/src/feeds/server/engine.ts - Workspace files
packages/core/src/files
Automation and notifications
- Recurring tasks
server/workspace/skills/user-tasks.ts - Notifications
server/notifier/engine.ts
Remote access
- Messaging bridges
packages/bridges - Chat relay
packages/chat-service/src/index.ts - Messaging apps
Other components
- User
- Claude Code
Connections 21
- User → Chat canvas: chats with
README.md - Chat canvas → Session lifecycle: manages sessions
src/composables/useSessionLifecycle.ts - Chat canvas → Plugin views: renders plugin
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
server/agent/index.ts - Agent runtime → Tool registry: composes capabilities
README.md - Tool registry → Plugin views: selects view
src/App.vue - Agent runtime → Personal wiki: builds memory
README.md - Agent runtime → Collections: uses data apps
README.md - Agent runtime → Data feeds: uses feed tools
README.md - Data feeds → Collections: upserts records
packages/core/src/feeds/server/engine.ts - User → Recurring tasks: requests recurring task
README.md - Recurring tasks → Agent runtime: starts scheduled chat
server/workspace/skills/user-tasks.ts - Server host → Notifications: binds notifier
server/notifier/engine.ts - User → Messaging apps: messages through
README.md - Messaging apps → Messaging bridges: sends messages
README.md - Messaging bridges → Chat relay: relays messages
- Chat relay → Server host: connects by socket
README.md