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
docs: point docs.flintai.dev links at docs.switchagents.ai
Jarod DeWeese48d1f6082b0d
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex fa773fe5e..602043897 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -99,6 +99,9 @@ version of their own to them without also giving them a release of their own.being retired. A deployment that sets the endpoint explicitly is unaffected;one relying on the default moves to the new host on upgrade. Nothing is sentunless `TELEMETRY_ENABLED=true`.+- **Documentation links point at `docs.switchagents.ai`.** Links in the docs+ and the synced `docs/official` pages used `docs.flintai.dev`, the older name+ for the same site. Old links still redirect.#### Security- **An agent icon URL must spell its host plainly.** A link with a backslash,diff --git a/CLAUDE.md b/CLAUDE.mdindex c411cc6fa..d27f3526f 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -187,7 +187,7 @@ Tests live in `core/tests/switch_core/` mirroring the module structure. Uses pyt## Reference Documentation- `docs/official/` — the published user-facing documentation- (docs.flintai.dev) synced into the repo. Generated — edit the source in the+ (docs.switchagents.ai) synced into the repo. Generated — edit the source in thedocs repository, never here. Start at `docs/README.md` for how the syncworks; `docs/official/internals/` covers architecture and the agentprotocol for readers of this repo.diff --git a/console/apps/switch-console-desktop/src/main/core/agent-templates/controller.test.ts b/console/apps/switch-console-desktop/src/main/core/agent-templates/controller.test.tsindex b02dc0f52..0b079ad72 100644--- a/console/apps/switch-console-desktop/src/main/core/agent-templates/controller.test.ts+++ b/console/apps/switch-console-desktop/src/main/core/agent-templates/controller.test.ts@@ -13,8 +13,8 @@ agent:repo: https://github.com/sandbox-quantum/switchsources:- label: Stand up a Switch expert- url: https://docs.flintai.dev/flintai/switch/getting-started/switch-expert- - https://docs.flintai.dev+ url: https://docs.switchagents.ai/flintai/switch/getting-started/switch-expert+ - https://docs.switchagents.airoom:name: "Ask {agent}"agents: ["{agent}"]@@ -33,9 +33,9 @@ describe('parseAgentTemplate', () => {expect(t.sources).toEqual([{label: 'Stand up a Switch expert',- url: 'https://docs.flintai.dev/flintai/switch/getting-started/switch-expert',+ url: 'https://docs.switchagents.ai/flintai/switch/getting-started/switch-expert',},- { label: null, url: 'https://docs.flintai.dev' },+ { label: null, url: 'https://docs.switchagents.ai' },]);expect(t.room).toEqual({ name: 'Ask {agent}', kickoff: '@{agent} hi.' });expect(t.warnings).toEqual([]);diff --git a/console/apps/switch-console-desktop/src/main/core/telemetry/config.ts b/console/apps/switch-console-desktop/src/main/core/telemetry/config.tsindex 0e2bad54e..aa5aea42b 100644--- a/console/apps/switch-console-desktop/src/main/core/telemetry/config.ts+++ b/console/apps/switch-console-desktop/src/main/core/telemetry/config.ts@@ -16,10 +16,9 @@ const viteEnv = (import.meta as ImportMetaWithEnv).env;* `./relay-client`. Public rather than internal — the same endpoint a public* GitHub Action posts to from a customer's CI.*- * It is another product's hostname, written down in an open-source repository:- * anyone reading this learns where the app reports to, which is a thing users- * are entitled to know but was not ours to decide unilaterally. Adopted with- * the collaborating dev's agreement, pending the product owner's.+ * The hostname is written down in an open-source repository on purpose: anyone+ * reading this learns where the app reports to, which users are entitled to+ * know. switch-core's usage telemetry defaults to the same relay.*/export const TELEMETRY_RELAY_ENDPOINT = 'https://telemetry.switchagents.ai/v1/logs';diff --git a/docs/README.md b/docs/README.mdindex 6a94e5fda..8b8f01a6a 100644--- a/docs/README.md+++ b/docs/README.md@@ -5,7 +5,7 @@ Two sets of documents, with different owners and different audiences.## `official/`The reader-facing Switch documentation, published at-[docs.flintai.dev](https://docs.flintai.dev). It is written in+[docs.switchagents.ai](https://docs.switchagents.ai). It is written in[`sandbox-quantum/docs`](https://github.com/sandbox-quantum/docs) as Mintlify MDXand converted to Markdown here so that agents working in this repository can readwhat users are told.diff --git a/docs/messaging-platforms/README.md b/docs/messaging-platforms/README.mdindex 0c970dc5d..228fc6ab1 100644--- a/docs/messaging-platforms/README.md+++ b/docs/messaging-platforms/README.md@@ -7,6 +7,6 @@ the platform: what to create on the platform side, the permissions it needs,what each connection field means and what the platform can't do.The platforms Switch shipped with are documented on the published docs site,-under [Deploy → Messaging apps](https://docs.flintai.dev/flintai/switch/deploy/messaging-apps).+under [Deploy → Messaging apps](https://docs.switchagents.ai/flintai/switch/deploy/messaging-apps).A page here moves there once it's published, and the adapter's `docs_slug` isthen set so Console links to it.diff --git a/docs/official/TOC.md b/docs/official/TOC.mdindex 776ffefab..0f8e0e563 100644--- a/docs/official/TOC.md+++ b/docs/official/TOC.md@@ -1,7 +1,7 @@# Switch documentationThe reader-facing Switch documentation, converted from the Mintlify source in-`sandbox-quantum/docs` and published at https://docs.flintai.dev.+`sandbox-quantum/docs` and published at https://docs.switchagents.ai.Generated by `just sync-docs`. Do not edit these files: change the source pagesin the docs repository and run the sync again.@@ -12,67 +12,67 @@ rather than to a path in this repository, which they cannot open.## Overview-- [index](index.md) — <https://docs.flintai.dev/flintai/switch>+- [index](index.md) — <https://docs.switchagents.ai/flintai/switch>## Get started-- [getting-started/index](getting-started/index.md) — <https://docs.flintai.dev/flintai/switch/getting-started>-- [getting-started/install-switch-console](getting-started/install-switch-console.md) — <https://docs.flintai.dev/flintai/switch/getting-started/install-switch-console>-- [getting-started/add-a-server](getting-started/add-a-server.md) — <https://docs.flintai.dev/flintai/switch/getting-started/add-a-server>-- [getting-started/set-up-agent-providers](getting-started/set-up-agent-providers.md) — <https://docs.flintai.dev/flintai/switch/getting-started/set-up-agent-providers>-- [getting-started/onboard-your-agents](getting-started/onboard-your-agents.md) — <https://docs.flintai.dev/flintai/switch/getting-started/onboard-your-agents>-- [getting-started/create-a-room](getting-started/create-a-room.md) — <https://docs.flintai.dev/flintai/switch/getting-started/create-a-room>-- [getting-started/smoke-test](getting-started/smoke-test.md) — <https://docs.flintai.dev/flintai/switch/getting-started/smoke-test>+- [getting-started/index](getting-started/index.md) — <https://docs.switchagents.ai/flintai/switch/getting-started>+- [getting-started/install-switch-console](getting-started/install-switch-console.md) — <https://docs.switchagents.ai/flintai/switch/getting-started/install-switch-console>+- [getting-started/add-a-server](getting-started/add-a-server.md) — <https://docs.switchagents.ai/flintai/switch/getting-started/add-a-server>+- [getting-started/set-up-agent-providers](getting-started/set-up-agent-providers.md) — <https://docs.switchagents.ai/flintai/switch/getting-started/set-up-agent-providers>+- [getting-started/onboard-your-agents](getting-started/onboard-your-agents.md) — <https://docs.switchagents.ai/flintai/switch/getting-started/onboard-your-agents>+- [getting-started/create-a-room](getting-started/create-a-room.md) — <https://docs.switchagents.ai/flintai/switch/getting-started/create-a-room>+- [getting-started/smoke-test](getting-started/smoke-test.md) — <https://docs.switchagents.ai/flintai/switch/getting-started/smoke-test>## Deploy and connect-- [deploy/index](deploy/index.md) — <https://docs.flintai.dev/flintai/switch/deploy>-- [deploy/host-remotely](deploy/host-remotely.md) — <https://docs.flintai.dev/flintai/switch/deploy/host-remotely>-- [deploy/self-host](deploy/self-host.md) — <https://docs.flintai.dev/flintai/switch/deploy/self-host>+- [deploy/index](deploy/index.md) — <https://docs.switchagents.ai/flintai/switch/deploy>+- [deploy/host-remotely](deploy/host-remotely.md) — <https://docs.switchagents.ai/flintai/switch/deploy/host-remotely>+- [deploy/self-host](deploy/self-host.md) — <https://docs.switchagents.ai/flintai/switch/deploy/self-host>## Deploy and connect › Connect your agents-- [deploy/connect-agents/switch-console](deploy/connect-agents/switch-console.md) — <https://docs.flintai.dev/flintai/switch/deploy/connect-agents/switch-console>+- [deploy/connect-agents/switch-console](deploy/connect-agents/switch-console.md) — <https://docs.switchagents.ai/flintai/switch/deploy/connect-agents/switch-console>## Deploy and connect › Connect messaging apps-- [deploy/messaging-apps/index](deploy/messaging-apps/index.md) — <https://docs.flintai.dev/flintai/switch/deploy/messaging-apps>-- [deploy/messaging-apps/slack](deploy/messaging-apps/slack.md) — <https://docs.flintai.dev/flintai/switch/deploy/messaging-apps/slack>-- [deploy/messaging-apps/microsoft-teams](deploy/messaging-apps/microsoft-teams.md) — <https://docs.flintai.dev/flintai/switch/deploy/messaging-apps/microsoft-teams>-- [deploy/messaging-apps/mattermost](deploy/messaging-apps/mattermost.md) — <https://docs.flintai.dev/flintai/switch/deploy/messaging-apps/mattermost>-- [deploy/messaging-apps/discord](deploy/messaging-apps/discord.md) — <https://docs.flintai.dev/flintai/switch/deploy/messaging-apps/discord>-- [deploy/messaging-apps/telegram](deploy/messaging-apps/telegram.md) — <https://docs.flintai.dev/flintai/switch/deploy/messaging-apps/telegram>-- [deploy/messaging-apps/how-connections-work](deploy/messaging-apps/how-connections-work.md) — <https://docs.flintai.dev/flintai/switch/deploy/messaging-apps/how-connections-work>+- [deploy/messaging-apps/index](deploy/messaging-apps/index.md) — <https://docs.switchagents.ai/flintai/switch/deploy/messaging-apps>+- [deploy/messaging-apps/slack](deploy/messaging-apps/slack.md) — <https://docs.switchagents.ai/flintai/switch/deploy/messaging-apps/slack>+- [deploy/messaging-apps/microsoft-teams](deploy/messaging-apps/microsoft-teams.md) — <https://docs.switchagents.ai/flintai/switch/deploy/messaging-apps/microsoft-teams>+- [deploy/messaging-apps/mattermost](deploy/messaging-apps/mattermost.md) — <https://docs.switchagents.ai/flintai/switch/deploy/messaging-apps/mattermost>+- [deploy/messaging-apps/discord](deploy/messaging-apps/discord.md) — <https://docs.switchagents.ai/flintai/switch/deploy/messaging-apps/discord>+- [deploy/messaging-apps/telegram](deploy/messaging-apps/telegram.md) — <https://docs.switchagents.ai/flintai/switch/deploy/messaging-apps/telegram>+- [deploy/messaging-apps/how-connections-work](deploy/messaging-apps/how-connections-work.md) — <https://docs.switchagents.ai/flintai/switch/deploy/messaging-apps/how-connections-work>## Working in Switch-- [using/index](using/index.md) — <https://docs.flintai.dev/flintai/switch/using>-- [using/mention-and-message](using/mention-and-message.md) — <https://docs.flintai.dev/flintai/switch/using/mention-and-message>-- [using/what-comes-back](using/what-comes-back.md) — <https://docs.flintai.dev/flintai/switch/using/what-comes-back>-- [using/rooms-and-agents](using/rooms-and-agents.md) — <https://docs.flintai.dev/flintai/switch/using/rooms-and-agents>-- [using/shared-context](using/shared-context.md) — <https://docs.flintai.dev/flintai/switch/using/shared-context>-- [using/hand-off-work](using/hand-off-work.md) — <https://docs.flintai.dev/flintai/switch/using/hand-off-work>-- [using/how-switch-works](using/how-switch-works.md) — <https://docs.flintai.dev/flintai/switch/using/how-switch-works>+- [using/index](using/index.md) — <https://docs.switchagents.ai/flintai/switch/using>+- [using/mention-and-message](using/mention-and-message.md) — <https://docs.switchagents.ai/flintai/switch/using/mention-and-message>+- [using/what-comes-back](using/what-comes-back.md) — <https://docs.switchagents.ai/flintai/switch/using/what-comes-back>+- [using/rooms-and-agents](using/rooms-and-agents.md) — <https://docs.switchagents.ai/flintai/switch/using/rooms-and-agents>+- [using/shared-context](using/shared-context.md) — <https://docs.switchagents.ai/flintai/switch/using/shared-context>+- [using/hand-off-work](using/hand-off-work.md) — <https://docs.switchagents.ai/flintai/switch/using/hand-off-work>+- [using/how-switch-works](using/how-switch-works.md) — <https://docs.switchagents.ai/flintai/switch/using/how-switch-works>## Build with Switch-- [building/index](building/index.md) — <https://docs.flintai.dev/flintai/switch/building>-- [building/payments-room](building/payments-room.md) — <https://docs.flintai.dev/flintai/switch/building/payments-room>-- [building/grow-into-an-organization](building/grow-into-an-organization.md) — <https://docs.flintai.dev/flintai/switch/building/grow-into-an-organization>+- [building/index](building/index.md) — <https://docs.switchagents.ai/flintai/switch/building>+- [building/payments-room](building/payments-room.md) — <https://docs.switchagents.ai/flintai/switch/building/payments-room>+- [building/grow-into-an-organization](building/grow-into-an-organization.md) — <https://docs.switchagents.ai/flintai/switch/building/grow-into-an-organization>## Under the hood-- [internals/index](internals/index.md) — <https://docs.flintai.dev/flintai/switch/internals>-- [internals/collaboration-bridge](internals/collaboration-bridge.md) — <https://docs.flintai.dev/flintai/switch/internals/collaboration-bridge>-- [internals/agent-protocol](internals/agent-protocol.md) — <https://docs.flintai.dev/flintai/switch/internals/agent-protocol>-- [internals/connectors-and-runtime](internals/connectors-and-runtime.md) — <https://docs.flintai.dev/flintai/switch/internals/connectors-and-runtime>-- [internals/life-of-a-message](internals/life-of-a-message.md) — <https://docs.flintai.dev/flintai/switch/internals/life-of-a-message>-- [internals/identity-and-access](internals/identity-and-access.md) — <https://docs.flintai.dev/flintai/switch/internals/identity-and-access>-- [internals/rooms-and-resources](internals/rooms-and-resources.md) — <https://docs.flintai.dev/flintai/switch/internals/rooms-and-resources>-- [internals/switch-console](internals/switch-console.md) — <https://docs.flintai.dev/flintai/switch/internals/switch-console>+- [internals/index](internals/index.md) — <https://docs.switchagents.ai/flintai/switch/internals>+- [internals/collaboration-bridge](internals/collaboration-bridge.md) — <https://docs.switchagents.ai/flintai/switch/internals/collaboration-bridge>+- [internals/agent-protocol](internals/agent-protocol.md) — <https://docs.switchagents.ai/flintai/switch/internals/agent-protocol>+- [internals/connectors-and-runtime](internals/connectors-and-runtime.md) — <https://docs.switchagents.ai/flintai/switch/internals/connectors-and-runtime>+- [internals/life-of-a-message](internals/life-of-a-message.md) — <https://docs.switchagents.ai/flintai/switch/internals/life-of-a-message>+- [internals/identity-and-access](internals/identity-and-access.md) — <https://docs.switchagents.ai/flintai/switch/internals/identity-and-access>+- [internals/rooms-and-resources](internals/rooms-and-resources.md) — <https://docs.switchagents.ai/flintai/switch/internals/rooms-and-resources>+- [internals/switch-console](internals/switch-console.md) — <https://docs.switchagents.ai/flintai/switch/internals/switch-console>## Resources-- [resources/room-commands](resources/room-commands.md) — <https://docs.flintai.dev/flintai/switch/resources/room-commands>-- [resources/troubleshooting](resources/troubleshooting.md) — <https://docs.flintai.dev/flintai/switch/resources/troubleshooting>-- [resources/glossary](resources/glossary.md) — <https://docs.flintai.dev/flintai/switch/resources/glossary>+- [resources/room-commands](resources/room-commands.md) — <https://docs.switchagents.ai/flintai/switch/resources/room-commands>+- [resources/troubleshooting](resources/troubleshooting.md) — <https://docs.switchagents.ai/flintai/switch/resources/troubleshooting>+- [resources/glossary](resources/glossary.md) — <https://docs.switchagents.ai/flintai/switch/resources/glossary>diff --git a/docs/official/building/grow-into-an-organization.md b/docs/official/building/grow-into-an-organization.mdindex eb3bb7de5..ac33c08cc 100644--- a/docs/official/building/grow-into-an-organization.md+++ b/docs/official/building/grow-into-an-organization.md@@ -2,7 +2,7 @@_What changes when one room isn't enough — more rooms, links between them, material you stop attaching by hand, and a shape the next team can reuse_-Published at <https://docs.flintai.dev/flintai/switch/building/grow-into-an-organization> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/building/grow-into-an-organization> — link readers there, not to this file.No team runs out of one channel. There's the one where the day-to-day happens, the one that lights up when something breaks, one for each project big enough to need its own, and people who move between them depending on what's going on. That isn't disorganization — it's how the work stays findable.diff --git a/docs/official/building/index.md b/docs/official/building/index.mdindex 52cfba102..0e422b9de 100644--- a/docs/official/building/index.md+++ b/docs/official/building/index.md@@ -2,7 +2,7 @@_The building blocks you assemble a team of people and agents from — rooms, agents, roles and the material a room carries_-Published at <https://docs.flintai.dev/flintai/switch/building> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/building> — link readers there, not to this file.Switch is a way to build a working team out of people and AI agents. You give the team rooms to work in, jobs that anyone qualified can pick up, and the material the work depends on — and then the team runs, whether or not you're watching.diff --git a/docs/official/building/payments-room.md b/docs/official/building/payments-room.mdindex c41fb9fcd..086485ca1 100644--- a/docs/official/building/payments-room.md+++ b/docs/official/building/payments-room.md@@ -2,7 +2,7 @@_Take one room from an empty channel to something a team can work in — instructions, material, jobs, and who's allowed to drive what_-Published at <https://docs.flintai.dev/flintai/switch/building/payments-room> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/building/payments-room> — link readers there, not to this file.## What we're buildingdiff --git a/docs/official/deploy/connect-agents/switch-console.md b/docs/official/deploy/connect-agents/switch-console.mdindex 87b1485f9..30c4e49a2 100644--- a/docs/official/deploy/connect-agents/switch-console.md+++ b/docs/official/deploy/connect-agents/switch-console.md@@ -2,7 +2,7 @@_The recommended way to put an agent in a room, and what Switch Console keeps doing for it afterwards_-Published at <https://docs.flintai.dev/flintai/switch/deploy/connect-agents/switch-console> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/deploy/connect-agents/switch-console> — link readers there, not to this file.Switch Console is how an agent connects to Switch. It installs the agent provider, registers the agent against your server, and then keeps working on the agent's behalf: it starts a session when someone addresses one that isn't running, gives every session it starts the Switch tools and the instructions for using them, and can run the agent on a machine that stays up when yours doesn't.diff --git a/docs/official/deploy/host-remotely.md b/docs/official/deploy/host-remotely.mdindex 74ab0fd39..2871b9ce8 100644--- a/docs/official/deploy/host-remotely.md+++ b/docs/official/deploy/host-remotely.md@@ -2,7 +2,7 @@_Run a Switch server or an agent on a machine other than your own_-Published at <https://docs.flintai.dev/flintai/switch/deploy/host-remotely> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/deploy/host-remotely> — link readers there, not to this file.Everything installed on a local Switch server runs on the machine in front of you. That server is reachable only from that machine, and it doesn't come back by itself after a reboot — your rooms and history survive, but you have to start it again.diff --git a/docs/official/deploy/index.md b/docs/official/deploy/index.mdindex 0b0b7ab11..e1f79bee4 100644--- a/docs/official/deploy/index.md+++ b/docs/official/deploy/index.md@@ -2,7 +2,7 @@_Compare the ways to run a Switch server, and pick the one that fits your team_-Published at <https://docs.flintai.dev/flintai/switch/deploy> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/deploy> — link readers there, not to this file.A Switch server hosts your rooms and the agents registered against it. Your agents themselves run wherever you point them — your own computer, or a machine you own — so what you are choosing here is where the server runs and who can reach it.diff --git a/docs/official/deploy/messaging-apps/discord.md b/docs/official/deploy/messaging-apps/discord.mdindex b2f814b45..2c2431f11 100644--- a/docs/official/deploy/messaging-apps/discord.md+++ b/docs/official/deploy/messaging-apps/discord.md@@ -2,7 +2,7 @@_Put your Switch agents in a Discord server, so a channel becomes a room_-Published at <https://docs.flintai.dev/flintai/switch/deploy/messaging-apps/discord> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/deploy/messaging-apps/discord> — link readers there, not to this file.Discord runs on one bot application for the whole Discord server. Agents post through per-channel webhooks, which lets each one appear under its own name and avatar, so a room reads like several participants rather than one relay bot.diff --git a/docs/official/deploy/messaging-apps/how-connections-work.md b/docs/official/deploy/messaging-apps/how-connections-work.mdindex 55fbb5c15..85a63d253 100644--- a/docs/official/deploy/messaging-apps/how-connections-work.md+++ b/docs/official/deploy/messaging-apps/how-connections-work.md@@ -2,7 +2,7 @@_What a Switch connection does on every platform, and the things that differ once you pick one_-Published at <https://docs.flintai.dev/flintai/switch/deploy/messaging-apps/how-connections-work> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/deploy/messaging-apps/how-connections-work> — link readers there, not to this file.A connection joins one Switch server to one messaging platform. The setup differs per platform, and each guide covers its own, but what a connection *is* and what it does afterwards are the same everywhere.diff --git a/docs/official/deploy/messaging-apps/index.md b/docs/official/deploy/messaging-apps/index.mdindex ad6fa89bb..ac6043131 100644--- a/docs/official/deploy/messaging-apps/index.md+++ b/docs/official/deploy/messaging-apps/index.md@@ -2,7 +2,7 @@_Learn how to connect a Switch-compatible messaging app_-Published at <https://docs.flintai.dev/flintai/switch/deploy/messaging-apps> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/deploy/messaging-apps> — link readers there, not to this file.Switch rooms are channels in a freshly launched messaging app or one your team already uses. Once a Switch server is connected to a compatible app, typically through Switch Console, a channel there can become a Switch room, and any agents registered on that server can work in it.diff --git a/docs/official/deploy/messaging-apps/mattermost.md b/docs/official/deploy/messaging-apps/mattermost.mdindex 127278fc5..fb975590a 100644--- a/docs/official/deploy/messaging-apps/mattermost.md+++ b/docs/official/deploy/messaging-apps/mattermost.md@@ -2,7 +2,7 @@_Put your Switch agents in a Mattermost server, where each one gets a bot account of its own_-Published at <https://docs.flintai.dev/flintai/switch/deploy/messaging-apps/mattermost> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/deploy/messaging-apps/mattermost> — link readers there, not to this file.Mattermost is the platform Switch treats most like a real workplace: each agent gets its own Mattermost bot account, named for the agent, and that bot joins channels as an ordinary member. Agents show up in the channel member list, which they don't on any other platform.diff --git a/docs/official/deploy/messaging-apps/microsoft-teams.md b/docs/official/deploy/messaging-apps/microsoft-teams.mdindex 6005ccf73..0e5f96c41 100644--- a/docs/official/deploy/messaging-apps/microsoft-teams.md+++ b/docs/official/deploy/messaging-apps/microsoft-teams.md@@ -2,7 +2,7 @@_Put your Switch agents in a Teams tenant — the one platform that needs Switch publicly reachable_-Published at <https://docs.flintai.dev/flintai/switch/deploy/messaging-apps/microsoft-teams> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/deploy/messaging-apps/microsoft-teams> — link readers there, not to this file.Microsoft Teams is the most involved platform to connect, and it's worth knowing why before you start. One Azure bot application backs every agent on your Switch server, and each agent's messages render as a card headed with its name.diff --git a/docs/official/deploy/messaging-apps/slack.md b/docs/official/deploy/messaging-apps/slack.mdindex 819b998c9..2a8166f1a 100644--- a/docs/official/deploy/messaging-apps/slack.md+++ b/docs/official/deploy/messaging-apps/slack.md@@ -2,7 +2,7 @@_Put your Switch agents in a Slack workspace, so a channel becomes a room_-Published at <https://docs.flintai.dev/flintai/switch/deploy/messaging-apps/slack> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/deploy/messaging-apps/slack> — link readers there, not to this file.Slack is the quickest platform to connect. One Slack app backs every agent on your Switch server, and Slack posts each agent under its own name and icon, so a room reads like a conversation with a team rather than with one relay bot.diff --git a/docs/official/deploy/messaging-apps/telegram.md b/docs/official/deploy/messaging-apps/telegram.mdindex 4301c63b8..74ab5ce37 100644--- a/docs/official/deploy/messaging-apps/telegram.md+++ b/docs/official/deploy/messaging-apps/telegram.md@@ -2,7 +2,7 @@_Put your Switch agents in Telegram groups and channels, using one bot and one setting_-Published at <https://docs.flintai.dev/flintai/switch/deploy/messaging-apps/telegram> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/deploy/messaging-apps/telegram> — link readers there, not to this file.Telegram is the least work to set up: one conversation with BotFather, one setting, and adding the bot to a chat. One bot backs every agent on your Switch server, and because Telegram has no way to change the sender of a message, each agent is identified by its name written at the head of what it posts.diff --git a/docs/official/deploy/self-host.md b/docs/official/deploy/self-host.mdindex a2e64d217..d88fe1a2d 100644--- a/docs/official/deploy/self-host.md+++ b/docs/official/deploy/self-host.md@@ -2,7 +2,7 @@_Deploy a Switch server yourself, then point Switch Console at it_-Published at <https://docs.flintai.dev/flintai/switch/deploy/self-host> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/deploy/self-host> — link readers there, not to this file.Switch Console can run a Switch [server](../resources/glossary.md#server) for you, on your own machine or on a host you onboard. Both belong to whoever set them up: they are reached through Switch Console, so the addresses aren't ones you can hand out.diff --git a/docs/official/getting-started/add-a-server.md b/docs/official/getting-started/add-a-server.mdindex 692b63ef3..0b9f9beae 100644--- a/docs/official/getting-started/add-a-server.md+++ b/docs/official/getting-started/add-a-server.md@@ -2,7 +2,7 @@_Let Switch Console run a server for you, or point it at one that already exists_-Published at <https://docs.flintai.dev/flintai/switch/getting-started/add-a-server> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/getting-started/add-a-server> — link readers there, not to this file.A Switch server is where your rooms live and your agents connect. Add one before you set up agent providers, onboard agents, or create a room.diff --git a/docs/official/getting-started/create-a-room.md b/docs/official/getting-started/create-a-room.mdindex 052c1b6e1..f6c05a1f7 100644--- a/docs/official/getting-started/create-a-room.md+++ b/docs/official/getting-started/create-a-room.md@@ -2,7 +2,7 @@_Make a room from scratch, or turn a channel your team already uses into one_-Published at <https://docs.flintai.dev/flintai/switch/getting-started/create-a-room> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/getting-started/create-a-room> — link readers there, not to this file.A Switch room is where people and agents work together on the same thing with the same context. It appears as a channel in your messaging app, so your team joins it the way they join any other channel — the room is the part that remembers.diff --git a/docs/official/getting-started/index.md b/docs/official/getting-started/index.mdindex 8aa944bd4..3c29313b8 100644--- a/docs/official/getting-started/index.md+++ b/docs/official/getting-started/index.md@@ -2,7 +2,7 @@_Prepare to install and configure Switch Console_-Published at <https://docs.flintai.dev/flintai/switch/getting-started> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/getting-started> — link readers there, not to this file.Setting up Switch involves installing Switch Console, then connecting a server, your agent providers, your agents, and a Switch room for people and agents to work together.diff --git a/docs/official/getting-started/install-switch-console.md b/docs/official/getting-started/install-switch-console.mdindex 0cd26a174..d0e36a4da 100644--- a/docs/official/getting-started/install-switch-console.md+++ b/docs/official/getting-started/install-switch-console.md@@ -2,7 +2,7 @@_Install the desktop app that will help you set up and manage Switch_-Published at <https://docs.flintai.dev/flintai/switch/getting-started/install-switch-console> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/getting-started/install-switch-console> — link readers there, not to this file.Switch Console is the desktop app that guides you through setting up Switch. If you haven't already, review [Setting up Switch](index.md) to decide where your server will run and prepare the connections you'll need.diff --git a/docs/official/getting-started/onboard-your-agents.md b/docs/official/getting-started/onboard-your-agents.mdindex f0e523888..a49419618 100644--- a/docs/official/getting-started/onboard-your-agents.md+++ b/docs/official/getting-started/onboard-your-agents.md@@ -2,7 +2,7 @@_Register an agent with your server so you can invite it into any room_-Published at <https://docs.flintai.dev/flintai/switch/getting-started/onboard-your-agents> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/getting-started/onboard-your-agents> — link readers there, not to this file.Onboarding an agent registers it against your server and gives it a name people can address. You do this once per agent, not once per room. You can then invite the same agent into any room on that server, in any messaging app connected to it.diff --git a/docs/official/getting-started/set-up-agent-providers.md b/docs/official/getting-started/set-up-agent-providers.mdindex d7c324eac..7415d3733 100644--- a/docs/official/getting-started/set-up-agent-providers.md+++ b/docs/official/getting-started/set-up-agent-providers.md@@ -2,7 +2,7 @@_Make sure the agent providers you use are installed and can reach Switch_-Published at <https://docs.flintai.dev/flintai/switch/getting-started/set-up-agent-providers> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/getting-started/set-up-agent-providers> — link readers there, not to this file.An agent provider is an agent application Switch can start on your behalf: Claude Code, Codex, or OpenCode. Switch doesn't ship an agent of its own — it starts the providers you already use on your machine, under your credentials.diff --git a/docs/official/getting-started/smoke-test.md b/docs/official/getting-started/smoke-test.mdindex 62bf474cc..bf763b930 100644--- a/docs/official/getting-started/smoke-test.md+++ b/docs/official/getting-started/smoke-test.md@@ -2,7 +2,7 @@_Prove the installation works with one human, one agent, and one task_-Published at <https://docs.flintai.dev/flintai/switch/getting-started/smoke-test> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/getting-started/smoke-test> — link readers there, not to this file.**Objective**: Send one task into one room, watch your agent do it, and check that the answer could only have come from your machine.diff --git a/docs/official/index.md b/docs/official/index.mdindex f7b19988e..16d27832c 100644--- a/docs/official/index.md+++ b/docs/official/index.md@@ -2,7 +2,7 @@_A governed workspace where people and agents share context, coordinate handoffs, and keep work moving over time_-Published at <https://docs.flintai.dev/flintai/switch> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch> — link readers there, not to this file.Your team already has agents. They write the code, answer the questions, and do work that used to be somebody's afternoon.diff --git a/docs/official/internals/agent-protocol.md b/docs/official/internals/agent-protocol.mdindex 9e9c9bc7c..d9c379e7e 100644--- a/docs/official/internals/agent-protocol.md+++ b/docs/official/internals/agent-protocol.md@@ -2,7 +2,7 @@_The wire protocol a Switch agent client implements — SSE down, HTTP up, every event frame and every operation_-Published at <https://docs.flintai.dev/flintai/switch/internals/agent-protocol> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/internals/agent-protocol> — link readers there, not to this file.The agent protocol is the wire contract between an agent client and Switch. One server-sent event stream carries what happens in the agent's rooms; HTTP calls carry everything the agent does. Switch Console and its sidecar speak it for every session they start — see [Sessions and the runtime](connectors-and-runtime.md). A client written from scratch implements what follows directly.diff --git a/docs/official/internals/collaboration-bridge.md b/docs/official/internals/collaboration-bridge.mdindex 03f06c936..c413de489 100644--- a/docs/official/internals/collaboration-bridge.md+++ b/docs/official/internals/collaboration-bridge.md@@ -2,7 +2,7 @@_How Switch relays a messaging app into a Switch room, and the contract you implement to add one it doesn't support_-Published at <https://docs.flintai.dev/flintai/switch/internals/collaboration-bridge> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/internals/collaboration-bridge> — link readers there, not to this file.The collaboration bridge relays an external chat platform into a Switch room, in both directions. One adapter per platform.diff --git a/docs/official/internals/connectors-and-runtime.md b/docs/official/internals/connectors-and-runtime.mdindex 60956dbcb..74065cbc7 100644--- a/docs/official/internals/connectors-and-runtime.md+++ b/docs/official/internals/connectors-and-runtime.md@@ -2,7 +2,7 @@_How Switch Console or its sidecar puts an agent session on Switch: the pushed skill, the session host, and the watcher that holds the connection_-Published at <https://docs.flintai.dev/flintai/switch/internals/connectors-and-runtime> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/internals/connectors-and-runtime> — link readers there, not to this file.Every agent session is started by **Switch Console** on your machine, or by the **sidecar** Console deploys to a remote host. Nothing is installed into the agent's host application: there is no plugin, no marketplace entry, and no process the host starts for itself. Console or the sidecar gives each session two things when it starts it:diff --git a/docs/official/internals/identity-and-access.md b/docs/official/internals/identity-and-access.mdindex 1a0711ced..33dbe2249 100644--- a/docs/official/internals/identity-and-access.md+++ b/docs/official/internals/identity-and-access.md@@ -2,7 +2,7 @@_Authorization over resources, addressing policy over agents, and the identity claims that connect them_-Published at <https://docs.flintai.dev/flintai/switch/internals/identity-and-access> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/internals/identity-and-access> — link readers there, not to this file.Switch answers the following access questions in separate places, with separate data.diff --git a/docs/official/internals/index.md b/docs/official/internals/index.mdindex 06be8a456..704fb5e49 100644--- a/docs/official/internals/index.md+++ b/docs/official/internals/index.md@@ -2,7 +2,7 @@_The components of Switch, what each one is responsible for, and how they connect_-Published at <https://docs.flintai.dev/flintai/switch/internals> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/internals> — link readers there, not to this file.Switch is a service that puts people and AI agents in rooms together, over a message bus of its own. This section covers its components, the contracts between them, and the parts of the design that aren't obvious from the outside.diff --git a/docs/official/internals/life-of-a-message.md b/docs/official/internals/life-of-a-message.mdindex 6208c9cee..4e2f5f4df 100644--- a/docs/official/internals/life-of-a-message.md+++ b/docs/official/internals/life-of-a-message.md@@ -2,7 +2,7 @@_One message traced from a Slack channel to an agent and back, with the component responsible for each hop_-Published at <https://docs.flintai.dev/flintai/switch/internals/life-of-a-message> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/internals/life-of-a-message> — link readers there, not to this file.A message posted in a Slack channel reaches an agent as an ordinary Switch room event. The reply returns along the same path in reverse.diff --git a/docs/official/internals/rooms-and-resources.md b/docs/official/internals/rooms-and-resources.mdindex eb0c75016..b077b2d2e 100644--- a/docs/official/internals/rooms-and-resources.md+++ b/docs/official/internals/rooms-and-resources.md@@ -2,7 +2,7 @@_The developer's view of the resource model and the room lifecycle — what's scoped where, and the ordering that matters_-Published at <https://docs.flintai.dev/flintai/switch/internals/rooms-and-resources> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/internals/rooms-and-resources> — link readers there, not to this file.A Switch room carries metadata, a position in a group tree, links to other rooms, roles its members can hold, and attached resources drawn from a library that exists outside any one room. This page covers where each of those is scoped, who owns it, what enforces what, and the order operations run in.diff --git a/docs/official/internals/switch-console.md b/docs/official/internals/switch-console.mdindex 0667a1e8b..ad0142379 100644--- a/docs/official/internals/switch-console.md+++ b/docs/official/internals/switch-console.md@@ -2,7 +2,7 @@_The desktop app that starts agent sessions on demand, holds their local state, and reports what they can be told to do_-Published at <https://docs.flintai.dev/flintai/switch/internals/switch-console> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/internals/switch-console> — link readers there, not to this file.Switch Console is the desktop app that runs agent sessions on the machine those agents live on. It watches for room activity addressed to an agent it manages, and starts a session when that agent has no live one. That is what lets a mention in Slack reach a working agent with nobody having opened Console first.diff --git a/docs/official/resources/glossary.md b/docs/official/resources/glossary.mdindex f1c03ca61..c6e92737c 100644--- a/docs/official/resources/glossary.md+++ b/docs/official/resources/glossary.md@@ -2,7 +2,7 @@_Switch terms and what they mean_-Published at <https://docs.flintai.dev/flintai/switch/resources/glossary> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/resources/glossary> — link readers there, not to this file.Switch borrows several words your messaging app already uses, and means somethingnarrower by most of them. This page is the one definition of each.diff --git a/docs/official/resources/room-commands.md b/docs/official/resources/room-commands.mdindex bffabc1d6..764ba81cf 100644--- a/docs/official/resources/room-commands.md+++ b/docs/official/resources/room-commands.md@@ -2,7 +2,7 @@_Every command you can run in a Switch room, and when to reach for it_-Published at <https://docs.flintai.dev/flintai/switch/resources/room-commands> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/resources/room-commands> — link readers there, not to this file.A command is a short instruction you type into the channel, and Switch acts onit directly. Use one to see what is in a room, bring an agent in, or take holddiff --git a/docs/official/resources/troubleshooting.md b/docs/official/resources/troubleshooting.mdindex 244e07bc1..60acce3b8 100644--- a/docs/official/resources/troubleshooting.md+++ b/docs/official/resources/troubleshooting.md@@ -2,7 +2,7 @@_Fast fixes for connecting, running an agent, and working in a room_-Published at <https://docs.flintai.dev/flintai/switch/resources/troubleshooting> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/resources/troubleshooting> — link readers there, not to this file.**If an agent didn't answer you at all, check the address first.** A message with no `@`, or with the name misspelled, reaches nobody and produces no error and no hint. [Work with your team](../using/mention-and-message.md) covers what counts as an address.diff --git a/docs/official/using/hand-off-work.md b/docs/official/using/hand-off-work.mdindex 198ff5790..ca4721b88 100644--- a/docs/official/using/hand-off-work.md+++ b/docs/official/using/hand-off-work.md@@ -2,7 +2,7 @@_Address a function rather than a particular agent, and give work that outlives a message_-Published at <https://docs.flintai.dev/flintai/switch/using/hand-off-work> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/using/hand-off-work> — link readers there, not to this file.Most of this section is about a conversation. This page is about the work thatoutlives one: reaching whoever is doing a job without knowing who that is today,diff --git a/docs/official/using/how-switch-works.md b/docs/official/using/how-switch-works.mdindex 877f19da1..af7954a26 100644--- a/docs/official/using/how-switch-works.md+++ b/docs/official/using/how-switch-works.md@@ -2,7 +2,7 @@_The room, the agent, and the session — what each one is and which one answers you_-Published at <https://docs.flintai.dev/flintai/switch/using/how-switch-works> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/using/how-switch-works> — link readers there, not to this file.You can use Switch without reading this page. It's here for the moment a reply doesn't make sense — an answer that arrives from somewhere you didn't expect, or a message telling you an agent isn't available when you can see it sitting in the room. What follows is what those replies are describing.diff --git a/docs/official/using/index.md b/docs/official/using/index.mdindex 84ef5c918..4abe24283 100644--- a/docs/official/using/index.md+++ b/docs/official/using/index.md@@ -2,7 +2,7 @@_What a Switch room is, and how it differs from any other group chat_-Published at <https://docs.flintai.dev/flintai/switch/using> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/using> — link readers there, not to this file.**A Switch room is where your team and their agents work together in the same place.** It's connected to a channel in the messaging app your team already uses — Slack, Microsoft Teams, Discord, Mattermost, or Telegram — so the work happens where the conversation already takes place. The agents in it are AI assistants that have been invited to the room, and invited participants need nothing more installed.diff --git a/docs/official/using/mention-and-message.md b/docs/official/using/mention-and-message.mdindex d949dd147..d443c68a4 100644--- a/docs/official/using/mention-and-message.md+++ b/docs/official/using/mention-and-message.md@@ -2,7 +2,7 @@_Address an agent so it acts, practice the ways an address misses, and send a command_-Published at <https://docs.flintai.dev/flintai/switch/using/mention-and-message> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/using/mention-and-message> — link readers there, not to this file.**Address an agent and it's the one that responds and acts. The others don't** — they don't respond, reply, or pick up any new work.diff --git a/docs/official/using/rooms-and-agents.md b/docs/official/using/rooms-and-agents.mdindex df8090663..e9be565d8 100644--- a/docs/official/using/rooms-and-agents.md+++ b/docs/official/using/rooms-and-agents.md@@ -2,7 +2,7 @@_See who is in a Switch room, give an agent a short name, and add people and agents to the room_-Published at <https://docs.flintai.dev/flintai/switch/using/rooms-and-agents> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/using/rooms-and-agents> — link readers there, not to this file.**The channel looks like any other channel. Working out who's in it doesn't.** The quickest way in is to ask an agent that's already answering: it has read the briefing every agent gets on joining, so it can tell you what this room is for. See [Share context](shared-context.md).diff --git a/docs/official/using/shared-context.md b/docs/official/using/shared-context.mdindex a247a6d3b..d54b9a637 100644--- a/docs/official/using/shared-context.md+++ b/docs/official/using/shared-context.md@@ -2,7 +2,7 @@_Shared context is everything a room holds — documents, resources, and agents — and it compounds as the team works_-Published at <https://docs.flintai.dev/flintai/switch/using/shared-context> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/using/shared-context> — link readers there, not to this file.**Shared context is everything the room holds — the documents, the resources it points at, and the agents themselves** — and every agent in the room gets the same briefing, so you say it once instead of repeating it to each agent, and again tomorrow.diff --git a/docs/official/using/what-comes-back.md b/docs/official/using/what-comes-back.mdindex ae0da0d15..29d3d0f88 100644--- a/docs/official/using/what-comes-back.md+++ b/docs/official/using/what-comes-back.md@@ -2,7 +2,7 @@_Read what comes back — an answer, an unavailable reply, silence, or a refusal — and know what each one means_-Published at <https://docs.flintai.dev/flintai/switch/using/what-comes-back> — link readers there, not to this file.+Published at <https://docs.switchagents.ai/flintai/switch/using/what-comes-back> — link readers there, not to this file.import SwitchCommandForm from '/snippets/switch-command-form.mdx';diff --git a/scripts/sync_docs.py b/scripts/sync_docs.pyindex 5fe2ab55e..82af1e3f4 100644--- a/scripts/sync_docs.py+++ b/scripts/sync_docs.py@@ -1,7 +1,7 @@"""Sync the published Switch documentation into this repository as Markdown.The reader-facing Switch pages live in `sandbox-quantum/docs` as Mintlify MDX and-are published at docs.flintai.dev. Agents working in this repository cannot read+are published at docs.switchagents.ai. Agents working in this repository cannot readthat site, so the pages are converted to plain Markdown and committed here.The output is generated. Edit the source pages in the docs repository and re-run@@ -22,7 +22,7 @@ from pathlib import PathDOCS_REPO_URL = "https://github.com/sandbox-quantum/docs"PRODUCT = "Switch Rooms"SOURCE_PREFIX = "switch-rooms/"-SITE_BASE = "https://docs.flintai.dev"+SITE_BASE = "https://docs.switchagents.ai"# Components whose body is kept and whose wrapper is dropped.TRANSPARENT = {