How simstudioai/sim works
Sim is a workspace for building, deploying, and managing AI agents and workflows, with browser and desktop surfaces. The main user journey is to author an agent or workflow, connect it to integrations and workspace data, execute it, then inspect runs and activity. The README also identifies tables, files, knowledge bases, chat, and desktop as first-class capabilities. The graph combines these documented capabilities with sampled runtime modules; unsampled feature links use README evidence rather than inferred source calls.
Main entry points: workspace Workspace UI · engine.ts Execution engine · editing Workflow editing · member-sync-engine.ts Knowledge sync
Components 20
Build and interact
- Workspace UI
apps/sim/app/workspace - Agent chat
apps/sim/app/(interfaces)/chat - Resume execution
apps/sim/app/(interfaces)/resume/[workflowId]/[executionId]/resume-page-client.tsx - Workflow editing
apps/sim/lib/workflows/editing
Execution and integrations
- Execution engine
apps/sim/executor/execution/engine.ts - Integration actions
apps/sim/blocks/blocks - Notion query tool
apps/sim/tools/notion/query_database.ts - Run monitoring
apps/sim/lib/workflows
Workspace data
- Structured tables
apps/realtime/src/handlers/tables.ts - Workspace files
apps/sim/lib/uploads/core/storage-service.ts - File preview
apps/sim/app/workspace/[workspaceId]/home/hooks/preview/use-file-preview-controller.ts - Knowledge sync
apps/sim/lib/knowledge/connectors/member-sync-engine.ts
Platform services
- Realtime collaboration
apps/realtime/src/rooms/redis-manager.ts - PostgreSQL database
packages/db - Sim deployment
Client tools
- Sim Desktop
apps/desktop/src/main - Sim CLI
packages/sim-cli/src/program.ts - CLI commands
packages/sim-cli/src/commands/protocol/index.ts - CLI API client
packages/sim-cli/src/http/client.ts
Other components
- Workspace user
Connections 20
- Workspace user → Workspace UI: authors in
README.md - Workspace user → Agent chat: uses chat
README.md - Workspace UI → Workflow editing: builds workflows
README.md - Workflow editing → Execution engine: defines runs
README.md - Execution engine → Integration actions: uses integrations
README.md - Execution engine → Notion query tool: invokes tools
apps/sim/tools/notion/query_database.ts - Execution engine → Run monitoring: records activity
README.md - Workspace user → Resume execution: resumes run
README.md - Workspace UI → Structured tables: manages tables
README.md - Workspace UI → Workspace files: manages files
README.md - Workspace UI → Knowledge sync: syncs knowledge
README.md - File preview → Workspace files: previews files
apps/sim/app/workspace/[workspaceId]/home/hooks/preview/use-file-preview-controller.ts - Realtime collaboration → Sim deployment: broadcasts updates
apps/realtime/src/rooms/redis-manager.ts - Workspace user → Sim Desktop: uses desktop
README.md - Sim Desktop → Sim deployment: connects to
README.md - Workspace user → Sim CLI: runs commands
packages/sim-cli/src/program.ts - Sim CLI → CLI commands: registers commands
packages/sim-cli/src/program.ts - CLI commands → CLI API client: sends requests
- CLI API client → Sim deployment: calls API
packages/sim-cli/src/http/client.ts - Knowledge sync → PostgreSQL database: reads and writes
apps/sim/lib/knowledge/connectors/member-sync-engine.ts