sandbox-quantum/switch

What it does

Switch turns each chat channel into a shared room where people and AI agents work from the same conversation, decisions and documents. It connects to Slack, Microsoft Teams, Discord, Telegram and Mattermost, so nobody has to move to a new tool.

Switch does not ship agents or models. It is an orchestration layer: your Claude Code, Codex, OpenCode or LangChain agents join the rooms, each with its own role, instructions and tools (Google Workspace, Jira, GitHub). Context stays with the rooms an agent belongs to.

The target user is a team that already runs coding or operations agents and wants them to collaborate with colleagues inside existing chat apps, rather than through a separate bot interface. The README frames adoption in levels, from moving everyday agents into a channel up to cross-channel workflows.

Get started

The documented path uses the desktop app, Switch Console:

1. Download the installer for your platform from the latest release — Apple Silicon or Intel macOS DMG, Windows installer, or Linux x64/ARM64 AppImage or DEB.
2. Open the app and talk to switch-buddy. Tell it what you want; it creates your first agents and channels, helps you connect your team's chat app, and answers questions about Switch.

For deeper setup, the getting started guide walks from the first agent to the first channel, and the remote hosting guide covers deploying Switch for a team. The docs are also exposed as an MCP server at https://docs.switchagents.ai/mcp, which you can register with Claude Code (claude mcp add switch-docs --transport http https://docs.switchagents.ai/mcp), Codex CLI or OpenCode, then ask the agent to walk you through setup.

Usage constraints

• Switch is self-hosted; running it for a team requires a server you operate. The README distinguishes Switch Console (the desktop app) from Switch Core (the server).
• Console telemetry is opt-out: anonymous event names, versions, OS, agent provider and fixed-value counts are sent to a relay, with free text excluded. Switch Core telemetry is off by default and only sends when TELEMETRY_ENABLED=true. See docs/TELEMETRY.md for the field list.
• Governance and cost features are described under Switch Trust and Switch ROI, which are linked from the project site rather than documented in the repository.
• The license is Apache 2.0 plus Commons Clause; review it before commercial redistribution.
• Entry is primarily through prebuilt desktop installers, so users should confirm they trust the release artifacts before running them.

HotRepo's take

On 2026-11-05 the project appeared on the Python daily trending list at position 11 with 215 stars gained that day, reaching 3,892 stars and 270 forks. That is a single daily snapshot rather than a sustained trend, but it places Switch among projects attracting attention for chat-integrated agent orchestration. The repository's value depends on how well the room model and agent-join protocol work in practice, which the README illustrates with demo recordings rather than a source-level walkthrough.