Open-source AI teammates in Slack, Teams, Discord, Telegram and Mattermost. Self-host it, with any agent harness and any model.
Python agent-orchestrationaiai-agentschatopsdiscordlangchainmcpmicrosoft-teamsmulti-agentopen-sourceopenaiself-hostedslack
Shared Modules
Main Shared Areas
- Agent provider registry (ids, display metadata, and a descriptive argv mirror; behavior
lives in
packages/plugins/src/agents/impl/<id>/index.ts):src/shared/core/providers/agent-provider-registry.ts
- IPC primitives:
src/shared/lib/ipc/rpc.ts— typed RPC router, controller, and clientsrc/shared/lib/ipc/events.ts— typed event emitter
- Typed event definitions:
src/shared/events/—appEvents.ts,browserEvents.ts,resourceEvents.ts,updateEvents.ts,sidecarEvents.ts,switchSetupEvents.ts,localSwitchServerEvents.ts,remoteSwitchServerEvents.ts- additional domain events colocated under
src/shared/core/— e.g.core/providers/agentEvents.ts,core/fs/fsEvents.ts,core/locations/locationEvents.ts,core/sessions/sessionEvents.ts,core/switch-rooms/switchRoomEvents.ts,core/ssh/sshEvents.ts,
- Domain type modules (under
src/shared/core/):agents/,fs/,location-settings/,locations/,managed-switch-server/,mcp/,providers/,remote-hosts/,sessions/,skills/,ssh/,switch-rooms/,switch-servers/,switch-setup/,terminals/
- App settings types:
src/shared/core/app-settings.ts
Note the agents/ vs providers/ split here, which mirrors src/main/core/:
core/agents/ is the Switch-agent concept, core/providers/ is the CLI-provider
registry and payload types.
Path Aliases
All aliases are defined in a single tsconfig.json and mirrored in electron.vite.config.ts:
| Alias | Resolves to |
|---|---|
@/* |
src/* |
@renderer/* |
src/renderer/* |
@main/* |
src/main/* |
@shared/* |
src/shared/* |
@root/* |
./* |
Aliases are resolved at build time by electron-vite. No runtime monkey-patching is needed.
Provider Registry Rules
When adding a provider:
Follow Add an agent provider. In short:
- add the plugin under
packages/plugins/src/agents/impl/<id>/and register it inpackages/plugins/src/agents/plugin-registry.ts - add the runtime to
PROVIDER_RUNTIMESinpackages/agent-providers/src/providers/registry.ts(for an ACP CLI,acpProviderRuntime(<hooks>)), including any env passthrough in itsinheritEnv - add the provider to core's provider table
- add the conformance suite and tests for non-standard spawn or detection behavior
src/shared/core/providers/agent-provider-registry.ts is a catalogue built at startup from
the plugins and runtimes; do not add ids or per-provider data to it.