How crowded-space/crowdos works
CrowdOS is a workspace-oriented, provider-agnostic multi-agent orchestration environment. Its principal workflow is users entering a workspace and channel, sending a message, and having the server select a runtime, assemble agent context, execute work, and return a result to the client. The map includes documented capabilities such as private agent memory, local filesystem mounts, and delegated swarms. Some subsystem wiring is based on the README rather than sampled implementation, so uncertain links are omitted.
Main entry points: runtimes Runtime suite · create-app.ts Server API · App.tsx Client app · context-pipeline-manager.ts Context pipeline
Components 27
User experience
- Client app
packages/client/src/App.tsx - Client state
packages/client/stores/crowdOsStore.ts - Workspace portal
packages/client/components/portal/WorkspacePortal.tsx - Chat interface
packages/client/components/workspace/MainChatArea.tsx
Workspace domain
- Server API
packages/server/src/create-app.ts - Workspace services
packages/server/src/workspace/workspace-gate.ts - Channels and sessions
packages/server/src/channels/channel-service.ts - Messages
packages/server/src/messages/message-service.ts - Agent roster
packages/server/src/agents/agent-service.ts - Filesystem mounts
packages/server/src/channel-mounts/channel-mount-service.ts
Agent orchestration
- Runtime interpreter
packages/server/src/runtime/interpreter.ts - Runtime router
packages/server/src/runtime/runtime-router.ts - Context pipeline
packages/server/src/runtime/kernel/context-pipeline-manager.ts - Runtime suite
packages/server/src/runtime/runtimes - Swarm coordination
packages/server/src/swarm/swarm-dispatcher.ts - Model modules
packages/server/src/modules/module-service.ts
Execution and integrations
- Tools and safety
packages/server/src/tools/tool-executor.ts - Model providers
packages/server/src/runtime/providers - Web search
packages/server/src/search-providers/search-provider-service.ts - Coding engine
packages/pi-core/src/agent/agent-loop.ts
Persistence
- Local filesystem
packages/server/src/Filesystem/local-filesystem.ts - Workspace databases
packages/server/src/workspace/workspace-database.ts - Agent memory
packages/server/src/memories/memory-retrieval.ts - Channel history
packages/server/src/messages/message-local-store.ts
Other components
- User
- AI model services
- Search providers
Connections 29
- User → Client app: uses
- Client app → Client state: loads state
- Client app → Workspace portal: opens workspace
- Client app → Chat interface: shows chat
- Client state → Server API: requests data
- Chat interface → Server API: sends messages
- Server API → Workspace services: serves workspace
- Server API → Channels and sessions: handles channels
- Server API → Messages: handles messages
- Messages → Channel history: persists history
- Workspace services → Workspace databases: resolves workspace DB
- Channels and sessions → Workspace databases: reads and writes
- Agent roster → Workspace databases: reads and writes
- Filesystem mounts → Workspace services: resolves mount config
- Filesystem mounts → Local filesystem: validates paths
- Server API → Runtime interpreter: selects execution
- Runtime interpreter → Runtime router: routes runtime
- Runtime router → Runtime suite: selects runtime
- Context pipeline → Model modules: resolves model config
- Runtime suite → Context pipeline: assembles context
- Context pipeline → Agent memory: retrieves memories
- Runtime suite → Tools and safety: executes tools
- Runtime suite → Model providers: requests inference
- Model providers → AI model services: calls model
- Runtime suite → Swarm coordination: delegates tasks
- Runtime suite → Coding engine: uses coding engine
- Tools and safety → Local filesystem: accesses files
- Tools and safety → Web search: invokes search
- Web search → Search providers: queries