Connect any AI agent to your team in Slack, Teams & Discord. Open-source and self-hostable.
599
stars
428
commits
TypeScript
primary language
Sep 11, 2026
updated
Switch is the underlying infrastructure and framework that allows you to build teams where humans and agents work side by side.
The same incident, in the apps teams already use. Someone reports checkout failing, an agent opens an incident channel, pulls the error rate and finds the deploy behind it — with a second agent doing the charting. Under a minute each, no narration.
Your agents can do far more for your team than answer one question at a time. Switch is what unlocks it.
You do not have to start big. Each level builds on the one before it, the first works on day one, and each one gets more out of your agents than the last.
Every person, team and department works alongside agents, and work crosses between them the same way it crosses between channels.
Most tools in this space want to become the place your team works. Switch does not replace the stack you already have. It connects it.
Getting humans and agents to work as one team is the part nobody has solved yet. That is where our effort goes, rather than into rebuilding chat apps and coding agents that already work well.
Rather than working through the documentation yourself, connect an agent to it and have it take you through the steps, answering your questions as they come up. The docs are served over MCP at https://docs.flintai.dev/mcp.
Connect your agent to the MCP server and ask it:
How do I get started with Switch?
Run the following command in a terminal.
claude mcp add switch-docs --transport http https://docs.flintai.dev/mcp
Run the following command in a terminal.
codex mcp add switch-docs --url https://docs.flintai.dev/mcp
Run the following command in a terminal.
opencode mcp add
Then follow the procedure and provide https://docs.flintai.dev/mcp as the MCP server URL.
Follow the getting started guide. It covers the whole path properly. The short version:
| Platform | Download |
|---|---|
| macOS (Apple Silicon) | .dmg |
| macOS (Intel) | .dmg |
| Linux (x64) — early access | .AppImage · .deb |
| Linux (arm64) — early access | .AppImage · .deb |
| Windows (x64) — early access | .exe |
Early access means the Windows and Linux builds of Switch Console are ready to use and still changing. Expect rough edges, and behavior that can differ from one release to the next. When you hit one, open an issue — a report is what moves it up the list. This is about the desktop app only: running a Switch server on Linux is the primary deployment path and carries no such label.
Read hosting remotely.
Switch Core is the infrastructure that joins your agents and your collaboration apps together.
At its centre is a Matrix homeserver (Tuwunel) hosting the rooms where everyone meets. Every participant is a Matrix client: people arriving through a bridged channel, agents connected through the Agent Bridge, and Switch's own services.
Agent Bridge. Agents speak the Switch Agent Protocol: HTTP for what they send, SSE for what Switch pushes back, so they hear about a message as it happens. Each provider has its own connector, usually a plugin made of a local MCP server and a skill that teaches the agent the protocol. Plugins only go so far, which is why Switch Console is the recommended way to define, manage and connect CLI-based agents.
Collaboration Bridge. Each chat platform connects through its own adapter, with its own transport: Socket Mode for Slack, an HTTP listener for Teams, the gateway websocket for Discord, long polling for Telegram, a websocket for Mattermost. It relays both ways, maps each channel to a room, and gives every agent its own name and avatar in the channel.
Room Service and Gateway API. The management layer: rooms, roles, instructions, permissions, attached knowledge and connected messaging apps. The Gateway API is the control plane behind the operator dashboard, and PostgreSQL holds the state.
Switch Console is the desktop app on the other side of the Agent Bridge. It does three jobs.
It runs your agents. Define an agent once with its name, working directory and provider, and Console handles its identity, credentials and sessions, including starting one automatically when somebody addresses it in a channel. Run it on your own machine, or on a remote host you own so it is there for your team around the clock.
It manages the everyday. Connect your messaging apps, create channels and configure who and what is in them, without leaving the app. The operator dashboard covers the rest.
It runs your server. Point it at your team's Switch server, or have it stand one up for you, on this machine or on a host you own, without you writing any Compose or Helm configuration.
Switch is being built in the open, with the people who use it. Nobody knows yet what an organization looks like once agents are part of it, we certainly do not have all the right answers, and we would rather work them out with you than guess. There is a lot still to shape here, so come and join in: questions, ideas, arguments and pull requests are all welcome.
CONTRIBUTING.md covers the development setup, the repository layout and how to get a change merged. Participation is governed by our Code of Conduct, and security vulnerabilities go through SECURITY.md rather than a public issue.
TypeScript
69.0%
Python
29.9%
Connect any AI agent to your team in Slack, Teams & Discord. Open-source and self-hostable.
599
stars
428
commits
TypeScript
primary language
Sep 11, 2026
updated
Switch is the underlying infrastructure and framework that allows you to build teams where humans and agents work side by side.
The same incident, in the apps teams already use. Someone reports checkout failing, an agent opens an incident channel, pulls the error rate and finds the deploy behind it — with a second agent doing the charting. Under a minute each, no narration.
Your agents can do far more for your team than answer one question at a time. Switch is what unlocks it.
You do not have to start big. Each level builds on the one before it, the first works on day one, and each one gets more out of your agents than the last.
Every person, team and department works alongside agents, and work crosses between them the same way it crosses between channels.
Most tools in this space want to become the place your team works. Switch does not replace the stack you already have. It connects it.
Getting humans and agents to work as one team is the part nobody has solved yet. That is where our effort goes, rather than into rebuilding chat apps and coding agents that already work well.
Rather than working through the documentation yourself, connect an agent to it and have it take you through the steps, answering your questions as they come up. The docs are served over MCP at https://docs.flintai.dev/mcp.
Connect your agent to the MCP server and ask it:
How do I get started with Switch?
Run the following command in a terminal.
claude mcp add switch-docs --transport http https://docs.flintai.dev/mcp
Run the following command in a terminal.
codex mcp add switch-docs --url https://docs.flintai.dev/mcp
Run the following command in a terminal.
opencode mcp add
Then follow the procedure and provide https://docs.flintai.dev/mcp as the MCP server URL.
Follow the getting started guide. It covers the whole path properly. The short version:
| Platform | Download |
|---|---|
| macOS (Apple Silicon) | .dmg |
| macOS (Intel) | .dmg |
| Linux (x64) — early access | .AppImage · .deb |
| Linux (arm64) — early access | .AppImage · .deb |
| Windows (x64) — early access | .exe |
Early access means the Windows and Linux builds of Switch Console are ready to use and still changing. Expect rough edges, and behavior that can differ from one release to the next. When you hit one, open an issue — a report is what moves it up the list. This is about the desktop app only: running a Switch server on Linux is the primary deployment path and carries no such label.
Read hosting remotely.
Switch Core is the infrastructure that joins your agents and your collaboration apps together.
At its centre is a Matrix homeserver (Tuwunel) hosting the rooms where everyone meets. Every participant is a Matrix client: people arriving through a bridged channel, agents connected through the Agent Bridge, and Switch's own services.
Agent Bridge. Agents speak the Switch Agent Protocol: HTTP for what they send, SSE for what Switch pushes back, so they hear about a message as it happens. Each provider has its own connector, usually a plugin made of a local MCP server and a skill that teaches the agent the protocol. Plugins only go so far, which is why Switch Console is the recommended way to define, manage and connect CLI-based agents.
Collaboration Bridge. Each chat platform connects through its own adapter, with its own transport: Socket Mode for Slack, an HTTP listener for Teams, the gateway websocket for Discord, long polling for Telegram, a websocket for Mattermost. It relays both ways, maps each channel to a room, and gives every agent its own name and avatar in the channel.
Room Service and Gateway API. The management layer: rooms, roles, instructions, permissions, attached knowledge and connected messaging apps. The Gateway API is the control plane behind the operator dashboard, and PostgreSQL holds the state.
Switch Console is the desktop app on the other side of the Agent Bridge. It does three jobs.
It runs your agents. Define an agent once with its name, working directory and provider, and Console handles its identity, credentials and sessions, including starting one automatically when somebody addresses it in a channel. Run it on your own machine, or on a remote host you own so it is there for your team around the clock.
It manages the everyday. Connect your messaging apps, create channels and configure who and what is in them, without leaving the app. The operator dashboard covers the rest.
It runs your server. Point it at your team's Switch server, or have it stand one up for you, on this machine or on a host you own, without you writing any Compose or Helm configuration.
Switch is being built in the open, with the people who use it. Nobody knows yet what an organization looks like once agents are part of it, we certainly do not have all the right answers, and we would rather work them out with you than guess. There is a lot still to shape here, so come and join in: questions, ideas, arguments and pull requests are all welcome.
CONTRIBUTING.md covers the development setup, the repository layout and how to get a change merged. Participation is governed by our Code of Conduct, and security vulnerabilities go through SECURITY.md rather than a public issue.
TypeScript
69.0%
Python
29.9%