How kamalllx/mosaic works
mOSaic is an on-premises runtime for organizational AI, with browser, phone, and Linux-shell entry points. A user submits work through the gateway; the kernel schedules a task, creates bounded agent processes, and mediates privileged tool actions through policy, human approval, sandboxing, and audit. Agents use organizational knowledge and local models to produce sourced results. The README documents broader knowledge, identity, connector, memory, and surface capabilities; some are represented at subsystem-directory level because their implementation was not sampled. Edges cite the README or source excerpts that support them; unsampled relationships are not inferred.
Main entry points: gateway.py Syscall mediation · library Role agents · app.py API gateway · App.tsx Mobile app
Components 20
User surfaces
- Browser desktop
apps/web/app/page.tsx - Mobile app
apps/mobile/App.tsx - Linux shell
sdk/python/src/mosaic_os/cli.py
Kernel runtime
- API gateway
kernel/mosaic_kernel/gateway/app.py - Kernel
kernel/mosaic_kernel/kernel.py - Task manager
kernel/mosaic_kernel/tasks/manager.py - Agent lifecycle
kernel/mosaic_kernel/lifecycle/manager.py - Shared contracts
shared/python/mosaic_contracts/schema/common.py
Governance
- Policy engine
kernel/mosaic_kernel/policy/engine.py - Human approvals
kernel/mosaic_kernel/approvals/queue.py - Syscall mediation
kernel/mosaic_kernel/syscalls/gateway.py - Audit journal
kernel/mosaic_kernel/audit/log.py
Agents and knowledge
- Role agents
agents/mosaic_agents/library - Knowledge and memory
knowledge/mosaic_knowledge - Local models
models/mosaic_models/router/router.py
Tools and state
- Execution tools
execution/mosaic_execution/tools - Connected apps
execution/mosaic_execution/connectors - Kernel state store
kernel/mosaic_kernel/persistence/store.py - Mounted org files
knowledge/mosaic_knowledge/okf
Other components
- Team member
Connections 23
- Team member → Browser desktop: uses
README.md - Team member → Mobile app: uses
README.md - Team member → Linux shell: uses
README.md - Browser desktop → API gateway: requests
README.md - Mobile app → API gateway: calls API
- Linux shell → API gateway: calls API
README.md - API gateway → Kernel: routes work
kernel/mosaic_kernel/gateway/app.py - Kernel → Task manager: manages tasks
kernel/mosaic_kernel/kernel.py - Kernel → Kernel state store: restores state
kernel/mosaic_kernel/kernel.py - Task manager → Agent lifecycle: drops agents
kernel/mosaic_kernel/tasks/manager.py - Agent lifecycle → Role agents: spawns role
kernel/mosaic_kernel/lifecycle/manager.py - Role agents → Knowledge and memory: retrieves evidence
agents/mosaic_agents/library/engineering.py - Role agents → Local models: requests inference
- Role agents → Syscall mediation: requests actions
README.md - Syscall mediation → Policy engine: checks policy
- Syscall mediation → Human approvals: waits approval
- Syscall mediation → Execution tools: dispatches tools
- Execution tools → Connected apps: uses integrations
- Syscall mediation → Audit journal: journals actions
- Knowledge and memory → Mounted org files: mounts knowledge
README.md - Agent lifecycle → Shared contracts: uses schemas
kernel/mosaic_kernel/lifecycle/manager.py - Policy engine → Shared contracts: evaluates requests
kernel/mosaic_kernel/policy/engine.py - Mobile app → Browser desktop: shares platform