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
feat: rename switchdash to Switch Console (display name only) — CHOO-2008 (#178)
Louis Amaudruz545b7a8d0134
diff --git a/CLAUDE.md b/CLAUDE.mdindex 20e6e6772..a98ac4bc6 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -8,12 +8,12 @@ Switch is an AI agent orchestration and governance platform. It onboards, orchesThe target architecture is documented in `docs/`.-## Switchdash+## Switch Console`dash/` is a local-first desktop app (Electron; a fork, upstreamattribution in `dash/NOTICE`) for managing the local AI coding-agent sessions thatparticipate in Switch. The upstream app is built around coding workflows-(projects → sessions → conversations); switchdash is being reworked+(projects → sessions → conversations); Switch Console is being reworkedaround **Switch agents and their sessions** — which rooms an agent belongs to andis connected to, its config (working dir, identity), and scheduling: e.g.auto-starting a Claude Code session when a Slack user addresses an agent that has@@ -84,7 +84,7 @@ each ships its own copy of the Switch room-workflow skill atShips the skill plus an MCP config (`.mcp.json`) and hooks. It contains **noruntime code**: the MCP server is `@sandbox-quantum/switch-agent-runtime`,fetched with `npx` and built from `dash/packages/switch-agent-runtime/`.- switchdash imports the same package for its protocol client, so there is one+ Switch Console imports the same package for its protocol client, so there is oneimplementation of the agent protocol rather than a copy per consumer.- `connectors/codex-plugin/` — manifest `.codex-plugin/plugin.json`. Ships theskill plus its own MCP config, declared as `"mcpServers": "./.mcp.json"`, so a@@ -92,19 +92,19 @@ each ships its own copy of the Switch room-workflow skill atexpand `${VAR}` in a bundled config, so the server names its variables under`env_vars` and Codex forwards them **by name** from its own environment — noexpansion, and no secret in the file. An unset name is simply not forwarded,- which is why the list can include the switchdash-only variables without+ which is why the list can include the Switch Console-only variables withoutbreaking a standalone session (the Claude connector cannot do this: `${VAR}`expansion makes every declared variable mandatory).The plugin's `.mcp.json` also carries `default_tools_approval_mode ="approve"`, so the Switch tools never prompt. It has to live there rather than- in anything switchdash writes: **no per-server setting can be layered onto a+ in anything Switch Console writes: **no per-server setting can be layered onto aplugin-provided MCP server.** An `mcp_servers.switch.*` entry with notransport of its own — from the base config, a profile, or `-c` on argv —makes Codex reject the whole config as "invalid transport" and the sessiondies with it.- switchdash writes a per-agent Codex profile+ Switch Console writes a per-agent Codex profile(`$CODEX_HOME/<slug>.config.toml`, launched with `--profile <slug>`) carrying**only** model, reasoning effort and instructions. It registers no MCP server.An agent that specializes none of those gets no profile and no `--profile`diff --git a/NOTICE b/NOTICEindex c2aea96b3..4e719c9fe 100644--- a/NOTICE+++ b/NOTICE@@ -10,7 +10,7 @@ must also include the Commons Clause License Condition notice.---------------------------------------------------------------------------------The Switchdash desktop application (dash/) is a derivative work of emdash+The Switch Console desktop application (dash/) is a derivative work of emdash(https://github.com/generalaction/emdash),Copyright 2026 General Action, Inc.,licensed under the Apache License, Version 2.0.diff --git a/README.md b/README.mdindex cd0104809..7cdd157f7 100644--- a/README.md+++ b/README.md@@ -98,7 +98,7 @@ point is to plug in yours. The quickest path is a bundled connector — theagent and joins the room. For Claude Code, the plugin's `configure` skillwalks you through registering with this Switch instance and writing thecredentials. The Codex plugin ships the room-workflow skill only — its- Switch MCP server is registered by the [switchdash desktop app](dash/) when+ Switch MCP server is registered by the [Switch Console desktop app](dash/) whenit launches the session, so set the agent up there; see[`connectors/codex-plugin/README.md`](connectors/codex-plugin/README.md).3. Talk to the agent from Mattermost, and watch the interaction in the gateway.@@ -184,7 +184,7 @@ The operator dashboard frontend lives in [`gateway/`](gateway/)| `core/switch_core/` | The main Python service package (import root `switch_core`, dist `switch-core`) || `core/tests/` | Test suite, mirroring the `switch_core/` module structure || `gateway/` | Operator dashboard frontend (Node/Vite) |-| `dash/` | The switchdash desktop app |+| `dash/` | The Switch Console desktop app || `connectors/` | Agent connectors (`claude-code-plugin`, `codex-plugin`) || `deploy/` | Deployment assets — Docker Compose stacks (`local/`) and shared resources || `justfile` | Repo-root task runner (drives all three code trees) |diff --git a/RELEASING.md b/RELEASING.mdindex 55b0fad64..0adfc730b 100644--- a/RELEASING.md+++ b/RELEASING.md@@ -2,7 +2,7 @@This describes how to cut a release of the **Switch core stack** — the`switch-core`, `gateway`, and `setup` container images, the Helm chart, and the-standalone Docker Compose file. The switchdash desktop app releases separately+standalone Docker Compose file. The Switch Console desktop app releases separately(see `.github/workflows/switchdash-release.yml` and `dash/docs/INSTALL.md`).## Versioning@@ -83,7 +83,7 @@ peer still on it, and it can never be raised past what is running in the field.You can also trigger `workflow_dispatch` manually from the Actions tab to test abuild without creating a release.-## switchdash desktop app release (separate)+## Switch Console desktop app release (separate)The desktop app (`dash/`) releases on its own tag, `switchdash-v<version>`, via`.github/workflows/switchdash-release.yml`. The tag MUST match@@ -138,7 +138,7 @@ SWITCH_VERSION=<version> docker compose -f standalone-docker-compose.yml up -dartifact (`standalone-compose:<version>`, plus `latest`) on every release,stamped with the same version as the images. It is a **versioned contract**:its service names, compose profiles, and env vars are an interface that-consumers — chiefly switchdash's local-server mode — pin against. Treat changes+consumers — chiefly Switch Console's local-server mode — pin against. Treat changesto that interface as you would any public API change.- **Images, not builds.** Services reference published GHCR images via@@ -173,6 +173,6 @@ change. The full list:- **Plugin marketplace source** — `SWITCH_MARKETPLACE_SOURCE` in`dash/packages/plugins/src/distribution.ts` (used by the Claudeconnector plugin descriptor).-- **switchdash auto-update target** — `RELEASE_REPO_OWNER` / `RELEASE_REPO_NAME`+- **Switch Console auto-update target** — `RELEASE_REPO_OWNER` / `RELEASE_REPO_NAME`in `dash/apps/switchdash-desktop/src/shared/app-identity.ts` (mirroredin `app-identity.canary.ts`), consumed by both electron-builder configs.diff --git a/SECURITY.md b/SECURITY.mdindex 08e4b70c0..60a899b07 100644--- a/SECURITY.md+++ b/SECURITY.md@@ -22,7 +22,7 @@ keep you informed of progress.When reporting, please include where relevant:- The component and version / commit affected (e.g. `switch-core`, the gateway,- switchdash, a collaboration bridge).+ Switch Console, a collaboration bridge).- A clear description of the vulnerability and its impact.- Steps to reproduce or a proof of concept.- Any suggested remediation.@@ -30,7 +30,7 @@ When reporting, please include where relevant:## ScopeThis policy covers the code in this repository: the Switch control plane-(`core/`), the operator gateway (`gateway/`), the switchdash desktop app+(`core/`), the operator gateway (`gateway/`), the Switch Console desktop app(`dash/`), the connector plugins (`connectors/`), and the deployment assets(`deploy/`). Vulnerabilities in third-party dependencies should be reported tothe upstream project; if a dependency issue affects Switch specifically, let usdiff --git a/connectors/claude-code-plugin/skills/configure/SKILL.md b/connectors/claude-code-plugin/skills/configure/SKILL.mdindex b625d827e..fe7119b2d 100644--- a/connectors/claude-code-plugin/skills/configure/SKILL.md+++ b/connectors/claude-code-plugin/skills/configure/SKILL.md@@ -41,7 +41,7 @@ authorised for returns **404**, not 403, because registries do not admit thatprivate packages exist. "Package not found" almost always means "not loggedin" here.-Sessions launched by switchdash get this handed to them and need nothing.+Sessions launched by Switch Console get this handed to them and need nothing.This step is for **standalone Claude Code**, where nothing is injecting it.First check whether it is already set up:diff --git a/connectors/claude-code-plugin/skills/switch/SKILL.md b/connectors/claude-code-plugin/skills/switch/SKILL.mdindex 30650668c..3914fd623 100644--- a/connectors/claude-code-plugin/skills/switch/SKILL.md+++ b/connectors/claude-code-plugin/skills/switch/SKILL.md@@ -217,7 +217,7 @@ react if relevant (e.g. greet a new arrival and explain the room). Yourown join never produces one.**Under a supervisor, the same events arrive as text instead.** A session-switchdash launched shares its connection: switchdash reads the stream and+Switch Console launched shares its connection: Switch Console reads the stream anddelivers each event into your session as a `[Switch] …` line rather than a`<channel>` notification, so you are not told twice. What is delivered, whatis filtered out, the unread count and the gap warning are all the samediff --git a/connectors/codex-plugin/README.md b/connectors/codex-plugin/README.mdindex 89e186cee..868b52de0 100644--- a/connectors/codex-plugin/README.md+++ b/connectors/codex-plugin/README.md@@ -19,7 +19,7 @@ Claude Code-specific and deliberately not part of this one.The manifest declares `"mcpServers": "./.mcp.json"`, and that file registers`@sandbox-quantum/switch-agent-runtime` over stdio under the server name`switch` — the name the skill assumes. A Codex session with this plugin-installed has the Switch tools, whether or not switchdash launched it.+installed has the Switch tools, whether or not Switch Console launched it.The config holds **no secret**. It names the variables the runtime needs under`env_vars`, and Codex forwards those **by name** from its own environment:@@ -52,7 +52,7 @@ depends on them:such. (This was previously documented the other way round, as a reason theserver could not ship here at all.)- **An unset name is simply not forwarded.** So the list can name- switchdash-only variables (`SWITCH_CONNECTION_ID`, the npm registry settings)+ Switch Console-only variables (`SWITCH_CONNECTION_ID`, the npm registry settings)without breaking a session that has none of them. The Claude connector cannotdo this: `${VAR}` expansion makes every declared variable mandatory.@@ -60,19 +60,19 @@ depends on them:never run the runtime can exceed it on the `npx` fetch alone, and a timeoutthere is indistinguishable from a broken server.-## What switchdash adds on top+## What Switch Console adds on top-switchdash writes a per-agent Codex *profile*+Switch Console writes a per-agent Codex *profile*(`$CODEX_HOME/<agent-slug>.config.toml`, launched with `--profile <agent-slug>`)carrying what is genuinely per-agent: model, reasoning effort, andinstructions. It registers **no** MCP server — this plugin does that — and anagent that specializes none of those three gets no profile at all.-switchdash's remaining job for the server is to put the credentials this config+Switch Console's remaining job for the server is to put the credentials this confignames into the session's environment, read from the agent's`.switch/agents/<slug>.json`.-Standalone — no switchdash — nothing populates that environment, and since+Standalone — no Switch Console — nothing populates that environment, and since`switch-agent-runtime` 0.2.0 the runtime reads that same file itself rather thanexiting. Where a working directory names several agents it serves a`select_agent` tool and refuses the rest until the session picks one; where it@@ -80,7 +80,7 @@ can find no usable agent at all it serves a single `switch_unavailable` toolthat reports why, rather than dying before the MCP handshake and leaving thesession with no explanation.-Because a plugin is only upgraded when a user clicks Update in switchdash's+Because a plugin is only upgraded when a user clicks Update in Switch Console'ssettings, and Codex caches each version in its own directory, an install on aplugin older than this one has no Switch tools until it is upgraded.@@ -103,7 +103,7 @@ Two things are worth knowing before changing it:drops the entire server and reports no MCP servers at all, so the sessionsimply has no Switch tools.-It lives here rather than in anything switchdash writes because no per-server+It lives here rather than in anything Switch Console writes because no per-serversetting can be layered onto a plugin-provided server: an `mcp_servers.switch.*`entry with no transport of its own, whether from the base config, a profile or`-c` on argv, makes Codex reject the whole config as "invalid transport".@@ -112,7 +112,7 @@ A profile does *not* replace a same-named server in the user's base`~/.codex/config.toml` — the two tables are merged. A base `switch` entry fromthe pre-profile design declares a `url`, which merges with a `command` entryinto a server that is both, and Codex then refuses to load the config at all.-switchdash removes such an entry.+Switch Console removes such an entry.## What the registered runtime gives a Codex session@@ -125,16 +125,16 @@ bridge media endpoint — that is now only the fallback for a session with noSwitch MCP server at all.Events are the part that differs from Claude Code. Codex has no channel of-its own to receive MCP notifications, so switchdash opens the session's+its own to receive MCP notifications, so Switch Console opens the session'sevent connection itself, hands the id over as `SWITCH_CONNECTION_ID`, anddelivers what arrives into the session's pane as `[Switch] …` lines. Theruntime borrows that connection rather than opening a second one: thesession's `connect_to_room` therefore claims the room on the connection-switchdash is reading, which is how switchdash learns which room the session+Switch Console is reading, which is how Switch Console learns which room the sessionis in — no tool-response scraping, and no per-session room-tracking hook.One caveat on remote hosts: room tracking depends on that connection, which-switchdash opens only for a session it can keep attached — i.e. a tmux session.+Switch Console opens only for a session it can keep attached — i.e. a tmux session.A remote session started with tmux disabled gets the Switch MCP tools (theplugin registers them regardless) but no `SWITCH_CONNECTION_ID`, so it neverclaims a room server-side and receives no `[Switch]` events. Run remote Codexdiff --git a/connectors/codex-plugin/skills/switch/SKILL.md b/connectors/codex-plugin/skills/switch/SKILL.mdindex 040e347fb..0cbb35062 100644--- a/connectors/codex-plugin/skills/switch/SKILL.md+++ b/connectors/codex-plugin/skills/switch/SKILL.md@@ -13,7 +13,7 @@ message bus.All Switch tools are served by a local runtime running beside you,registered as the `switch` MCP server. This plugin does **not** bundle it:-switchdash registers it when it launches your session, through a per-agent+Switch Console registers it when it launches your session, through a per-agentCodex profile (`--profile <name>`). Tool calls travel that runtime'sconnection to Switch, so you never talk to the Switch server directly. Ifthe Switch tools are missing, the session was launched without the profile;@@ -39,7 +39,7 @@ say so rather than guessing.ignoring it: work may have been interrupted somewhere else, and theother session will not be told by anyone but you.3. **Delivery starts automatically.** `connect_to_room` claims the room on- the connection your session was launched with, and switchdash — which+ the connection your session was launched with, and Switch Console — whichholds that connection — delivers the room's events into your session as`[Switch] …` lines. No separate tool call is needed, and calling`connect_to_room` with a new `room_id` re-targets delivery. See@@ -201,9 +201,9 @@ outstanding work.## Receiving room eventsRoom events reach you as **`[Switch] …` lines delivered into this session**-by switchdash, which holds your session's connection to Switch. They are not+by Switch Console, which holds your session's connection to Switch. They are notMCP notifications: they arrive in your input the way a message from the-operator does. If your session was not started by switchdash, nothing+operator does. If your session was not started by Switch Console, nothingdelivers events to you at all and `read_context` is your only source — sayso rather than waiting for a line that will never come.diff --git a/core/switch_core/bridges/agent/auth.py b/core/switch_core/bridges/agent/auth.pyindex 4d4f4cdbe..6368ce4e8 100644--- a/core/switch_core/bridges/agent/auth.py+++ b/core/switch_core/bridges/agent/auth.py@@ -27,7 +27,7 @@ PUBLIC_PATH_PREFIXES: tuple[str, ...] = ("/oauth","/gateway",# Public switchdash:// deeplink HTTP redirect — followed by whoever clicks- # the "Open in SwitchDash" link in an external channel, so no bearer token.+ # the "Open in Switch Console" link in an external channel, so no bearer token."/deeplink",)diff --git a/core/switch_core/bridges/agent/commands.py b/core/switch_core/bridges/agent/commands.pyindex 9f088e246..5577f811e 100644--- a/core/switch_core/bridges/agent/commands.py+++ b/core/switch_core/bridges/agent/commands.py@@ -311,7 +311,7 @@ async def _dispatch_control_command(# Mirror the runtime "working" surface: link back to the session in# switchdash when we know its deeplink.- body = f"{ack} ([Open in SwitchDash]({deeplink}))" if deeplink else ack+ body = f"{ack} ([Open in Switch Console]({deeplink}))" if deeplink else ackawait _reply(client, room, event, body)client._event_buffer.enqueue(client.agent.id,@@ -674,7 +674,7 @@ def _format_status_lines(parts.append("+".join(caps))deeplink = deeplinks.get(agent.id)if deeplink and status == AgentStatus.LIVE:- parts.append(f"[Open in SwitchDash]({deeplink})")+ parts.append(f"[Open in Switch Console]({deeplink})")lines.append("- " + " · ".join(parts))return "\n".join(lines)diff --git a/core/switch_core/bridges/agent/protocol/service.py b/core/switch_core/bridges/agent/protocol/service.pyindex cb77809bb..e6db1116d 100644--- a/core/switch_core/bridges/agent/protocol/service.py+++ b/core/switch_core/bridges/agent/protocol/service.py@@ -1094,7 +1094,7 @@ class ProtocolService:anything.The `switchdash://` deeplink is rewritten to a gateway HTTP redirect when- `GATEWAY_PUBLIC_URL` is configured, so the "Open in SwitchDash" link is+ `GATEWAY_PUBLIC_URL` is configured, so the "Open in Switch Console" link isclickable on platforms that only linkify http(s) (Discord). The rewrittenlink is what gets persisted and emitted, so both the bridged statusmessage and the `!status` command surface a clickable link. When unset,diff --git a/core/switch_core/bridges/collaboration/adapter.py b/core/switch_core/bridges/collaboration/adapter.pyindex f015a39e3..a6541ca2f 100644--- a/core/switch_core/bridges/collaboration/adapter.py+++ b/core/switch_core/bridges/collaboration/adapter.py@@ -334,14 +334,14 @@ class CollaborationAdapter(ABC):@staticmethoddef _deeplink_suffix(deeplink_url: str | None) -> str:- """A trailing ``(Open in SwitchDash)`` link to the session, or empty.+ """A trailing ``(Open in Switch Console)`` link to the session, or empty.Appended inline in parentheses after the status text. Rendered through``translate_outbound`` along with the rest of the body, so it convertsto each platform's link format."""if not deeplink_url:return ""- return f" ([Open in SwitchDash]({deeplink_url}))"+ return f" ([Open in Switch Console]({deeplink_url}))"def _working_body(self, detail: str | None, deeplink_url: str | None) -> str:"""The "working on it…" status text, rendered for this platform.diff --git a/core/switch_core/config.py b/core/switch_core/config.pyindex 59a66e708..a9912c70c 100644--- a/core/switch_core/config.py+++ b/core/switch_core/config.py@@ -62,7 +62,7 @@ class SwitchConfig(BaseSettings):# switchdash reports as its `server`, e.g. https://switch-api.<tailnet>.ts.net.# Distinct from `frontend_base_url`, which is the operator UI. Powers the# `switchdash://` deeplink HTTP redirect (`/deeplink/session`, served on the- # agent-bridge app) so the "Open in SwitchDash" link is clickable on platforms+ # agent-bridge app) so the "Open in Switch Console" link is clickable on platforms# that only linkify http(s) (Discord, and any future http-only bridge). When# unset, the raw `switchdash://` deeplink is posted as-is.gateway_public_url: str | None = Nonediff --git a/core/switch_core/deeplinks.py b/core/switch_core/deeplinks.pyindex 7c45fcd1c..313a711e5 100644--- a/core/switch_core/deeplinks.py+++ b/core/switch_core/deeplinks.py@@ -20,7 +20,7 @@ def switchdash_to_gateway(deeplink_url: str, gateway_public_url: str) -> str | NPlatforms like Discord only linkify http(s), so the raw custom-schemedeeplink renders as plain text. The gateway serves an HTTP endpoint(`DEEPLINK_REDIRECT_PATH`) that 302-redirects to the deeplink; posting that- https URL makes the "Open in SwitchDash" link clickable everywhere.+ https URL makes the "Open in Switch Console" link clickable everywhere.The query string is carried across verbatim (server/agent/room/session andany future params). Returns None when `deeplink_url` is not a switchdashdiff --git a/core/tests/switch_core/bridges/agent/test_commands_status.py b/core/tests/switch_core/bridges/agent/test_commands_status.pyindex 235665734..f008dc9b4 100644--- a/core/tests/switch_core/bridges/agent/test_commands_status.py+++ b/core/tests/switch_core/bridges/agent/test_commands_status.py@@ -110,13 +110,13 @@ class TestFormatStatusLines:{"a": "switchdash://session?server=s&agent=a&room=r"},)assert out.endswith(- "· [Open in SwitchDash](switchdash://session?server=s&agent=a&room=r)"+ "· [Open in Switch Console](switchdash://session?server=s&agent=a&room=r)")def test_no_deeplink_segment_when_absent(self) -> None:agents = [_agent("a", "alice", "session_addressable")]out = _format_status_lines(agents, {"a": AgentStatus.LIVE}, {}, {})- assert "SwitchDash" not in out+ assert "Switch Console" not in outdef test_deeplink_hidden_when_session_not_live_here(self) -> None:# A stored link survives a room switch; don't surface it where the@@ -129,7 +129,7 @@ class TestFormatStatusLines:{},{"a": "switchdash://session?server=s&agent=a&room=r"},)- assert "SwitchDash" not in out+ assert "Switch Console" not in outclass TestStatusCommandRegistration:diff --git a/dash/AGENTS.md b/dash/AGENTS.mdindex 5ddae8fdd..7b2d448f8 100644--- a/dash/AGENTS.md+++ b/dash/AGENTS.md@@ -1,19 +1,39 @@# Project Overview-Switchdash is a cross-platform, local-first Electron app for orchestrating multiple AI+Switch Console is a cross-platform, local-first Electron app for orchestrating multiple AIcoding agents in parallel. Each agent runs in its own session in its location's directory(there are no Git worktrees). An agent runs either locally or — when configured remote — on an-SSH host, where it runs inside tmux next to a switchdash-deployed sidecar so it keeps-working and listening to its Switch rooms while switchdash is closed (CHOO-1059). It+SSH host, where it runs inside tmux next to an app-deployed sidecar so it keeps+working and listening to its Switch rooms while the app is closed (CHOO-1059). Itcombines provider-agnostic CLI agent execution, session management,terminal sessions, MCP and skills, and packaging for desktop releases.-Switchdash is a fork; upstream attribution is recorded in `NOTICE`. The-product is fully rebranded to switchdash: packages (`@switchdash/*`), the app directory-(`apps/switchdash-desktop/`), the user-data directory, the per-project config file-(`.switchdash.json`), the macOS app id (`com.switchdash.*`), release artifact names-(`ARTIFACT_PREFIX`), and the agent-hook HTTP protocol (`X-Switchdash-*` headers) all carry-the switchdash name. The **update feed** points at GitHub Releases on the private+## The name: display vs identity (CHOO-2008)++Switch Console is a fork; upstream attribution is recorded in `NOTICE`. The app was+previously called **switchdash**, and before that `emdash`.++**Only the display name changed.** `PRODUCT_NAME` in `src/shared/app-identity.ts` is the+single thing a user reads — window title, About box, macOS app menu, `/Applications`.+Everything that identifies the app to the *operating system or the disk* deliberately+still says `switchdash`:++- the user-data directory (`USER_DATA_DIR_NAME`) and the SQLite file `switchdash.db`+- the macOS app id (`com.switchdash.*`) and release artifact names (`ARTIFACT_PREFIX`)+- the `switchdash://` deeplink scheme+- packages (`@switchdash/*`) and the app directory (`apps/switchdash-desktop/`)+- the per-project config file (`.switchdash.json`) and per-repo state dir (`.switchdash/`)+- `SWITCHDASH_*` environment variables and the agent-hook HTTP protocol+ (`X-Switchdash-*` headers)++This split is intentional and load-bearing — **do not "fix" it.** Renaming any of the+above strands existing installs: the user-data directory holds the database, the compose+project names derive from it (so the Postgres volume orphans), the app id and artifact+prefix carry macOS registration and auto-update continuity, and the env vars and headers+are baked into hook commands already written into users' own agent config files and into+sidecars already deployed on remote hosts.++The **update feed** points at GitHub Releases on the private`sandbox-quantum/switch` repo (see `electron-builder.config.ts` `publish`): the appdistributes to repo-readers and authenticates the updater with the user's `gh` CLI token(`src/main/core/updates/github-token.ts`). The SQLite database file is `switchdash.db`;@@ -352,7 +372,7 @@ pnpm run lint- Do not bypass path-safety, shell escaping, or validation helpers.- Use `pnpm-lock.yaml` for dependency integrity and review dependency changes.-## The Sidecar Mirrors switchdash — Check Both+## The Sidecar Mirrors Switch Console — Check Both`src/sidecar/` is a second, headless implementation of what the desktop app doesfor a session: it starts sessions, keeps them connected to their room, and@@ -414,11 +434,11 @@ reaches no session until the tag is pushed and the pins follow.Two traps worth knowing rather than rediscovering:- **A sidecar major replaces every sidecar on sight, live sessions included.**- It is judged on the contract *switchdash* speaks to, not on how much changed+ It is judged on the contract *Switch Console* speaks to, not on how much changedinside. Changing how the sidecar talks to Switch is not a major.- **A *new* sidecar endpoint is a minor, not a major.** A major only achievesanything if `MIN_SUPPORTED_SIDECAR_MAJOR` moves with it, and that kills every- older sidecar on sight — including one an older switchdash on the same host+ older sidecar on sight — including one an older Switch Console on the same hostthen kills right back, each replacing the other forever. The client owns thedetection instead: call the endpoint, and when an older sidecar 404s it, failthe operation with a message naming the upgrade rather than continuing@@ -497,13 +517,13 @@ pnpm run testpermissions" promises unattended approvals, not unattended filesystem andnetwork access, so the user's own `sandbox_mode` from `~/.codex/config.toml`stands. Measured against codex-cli 0.146.0, Codex runs hooks **outside** the- sandbox, so switchdash's `curl http://127.0.0.1:$SWITCHDASH_HOOK_PORT/hook`+ sandbox, so Switch Console's `curl http://127.0.0.1:$SWITCHDASH_HOOK_PORT/hook`hooks return 200 under `workspace-write` — the loopback block applies tomodel-generated commands only. See`packages/plugins/src/agents/impl/codex/index.ts`.-- Every switchdash-launched Codex session — not only auto-approving ones — carries+- Every Codex session launched by Switch Console — not only auto-approving ones — carries`--dangerously-bypass-hook-trust`. Codex skips any hook it has no persisted- `trusted_hash` for, which would take switchdash's own hooks with it; the flag is+ `trusted_hash` for, which would take Switch Console's own hooks with it; the flag isper-invocation and also un-gates hooks the user added to `~/.codex/hooks.json`themselves. Rationale and the rejected alternative are on `CODEX_HOOK_TRUST_FLAG` in`packages/plugins/src/agents/impl/codex/hooks.ts`.@@ -541,7 +561,7 @@ pnpm run test- [Shared modules](agents/architecture/shared.md)- [Remote execution: hosts, reachability, sidecar](agents/architecture/remote-execution.md)- [Switch rooms and sessions](agents/architecture/switch-rooms.md)-- [Data model (switchdash vs. its upstream origin)](agents/architecture/data-model.md)+- [Data model (Switch Console vs. its upstream origin)](agents/architecture/data-model.md)- [Testing workflow](agents/workflows/testing.md)- [Provider integration](agents/integrations/providers.md)- [MCP integration](agents/integrations/mcp.md)diff --git a/dash/NOTICE b/dash/NOTICEindex 07ab6487a..dc15a2d1b 100644--- a/dash/NOTICE+++ b/dash/NOTICE@@ -1,4 +1,4 @@-Switchdash+Switch ConsoleCopyright 2025 SandboxAQThis product is a fork of emdash (https://github.com/generalaction/emdash),@@ -10,8 +10,8 @@ copy of the license is available at:http://www.apache.org/licenses/LICENSE-2.0-The "switchdash" name, logos, and associated branding are not part of the-upstream emdash project and are owned by SandboxAQ.+The "Switch Console" and "switchdash" names, logos, and associated branding are+not part of the upstream emdash project and are owned by SandboxAQ.-------------------------------------------------------------------------------NOTE: The open-source license for this repository is still under legal reviewdiff --git a/dash/README.md b/dash/README.mdindex 55f45aba8..18c5005da 100644--- a/dash/README.md+++ b/dash/README.md@@ -1,6 +1,6 @@-# Switchdash+# Switch Console-Switchdash is a local-first desktop app (Electron) for managing the local AI+Switch Console is a local-first desktop app (Electron) for managing the local AIcoding-agent sessions that participate in [Agent Switch](../README.md) — whichrooms an agent belongs to, its configuration (working directory, identity),and the scheduling that starts and drives its sessions.diff --git a/dash/agents/README.md b/dash/agents/README.mdindex 466ccc0c7..12acb0ea8 100644--- a/dash/agents/README.md+++ b/dash/agents/README.md@@ -9,7 +9,7 @@ This directory is the system of record for agent-facing repo guidance. Keep topi3. the task-specific page for the area you are changingIf the change touches remote hosts or Switch rooms, read-`architecture/remote-execution.md` and `architecture/switch-rooms.md` too — switchdash+`architecture/remote-execution.md` and `architecture/switch-rooms.md` too — Switch Consoleruns agents on SSH hosts as well as locally, and the remote path is a separateimplementation.diff --git a/dash/apps/switchdash-desktop/electron-builder.config.ts b/dash/apps/switchdash-desktop/electron-builder.config.tsindex c0fbf34b4..5e725ec6a 100644--- a/dash/apps/switchdash-desktop/electron-builder.config.ts+++ b/dash/apps/switchdash-desktop/electron-builder.config.ts@@ -123,6 +123,11 @@ const config: Configuration = {// fpm requires a maintainer for the .deb and .rpm targets; without it the// packaging step aborts before writing any Linux artifact.maintainer: 'Louis Amaudruz <[email protected]>',+ // Overrides the top-level `executableName: PRODUCT_NAME`, which contains a+ // space. A space in the Linux binary name has to be quoted in the .desktop+ // Exec line and in the deb/rpm install path; keeping the lowercase,+ // space-free name avoids that and matches `desktopName` above.+ executableName: APP_NAME_LOWER,syncDesktopName: true,target: [{ target: 'AppImage', arch: ['x64'] },@@ -130,6 +135,14 @@ const config: Configuration = {{ target: 'rpm', arch: ['x64'] },],},+ // deb/rpm package names must be lowercase and space-free, so they are pinned+ // rather than derived from the display name (same as the canary channel).+ deb: {+ packageName: APP_NAME_LOWER,+ },+ rpm: {+ packageName: APP_NAME_LOWER,+ },win: {icon: 'src/assets/images/switchdash/app-icon-beta.png',target: [diff --git a/dash/apps/switchdash-desktop/src/main/app/menu.ts b/dash/apps/switchdash-desktop/src/main/app/menu.tsindex bdd0259ad..42c7867af 100644--- a/dash/apps/switchdash-desktop/src/main/app/menu.ts+++ b/dash/apps/switchdash-desktop/src/main/app/menu.ts@@ -17,7 +17,7 @@ import { getMainWindow } from './window';function copyVersionInfo(): void {const lines = [- `Switchdash ${app.getVersion()}`,+ `${app.getName()} ${app.getVersion()}`,`Platform: ${process.platform} ${process.arch}`,`Electron: ${process.versions.electron}`,];diff --git a/dash/apps/switchdash-desktop/src/main/core/execution-context/local-execution-context.test.ts b/dash/apps/switchdash-desktop/src/main/core/execution-context/local-execution-context.test.tsindex 6be721624..0390bb318 100644--- a/dash/apps/switchdash-desktop/src/main/core/execution-context/local-execution-context.test.ts+++ b/dash/apps/switchdash-desktop/src/main/core/execution-context/local-execution-context.test.ts@@ -57,7 +57,7 @@ describe('LocalExecutionContext', () => {const ctx = new LocalExecutionContext({ root: '/repo' });await expect(ctx.exec('git', ['status'])).rejects.toThrow(- 'Git is not installed or Switchdash cannot find it'+ 'Git is not installed or Switch Console cannot find it');});@@ -96,6 +96,6 @@ describe('LocalExecutionContext', () => {Object.assign(new Error('spawn git ENOENT'), { code: 'ENOENT', path: GIT_EXECUTABLE }));- await expect(promise).rejects.toThrow('Git is not installed or Switchdash cannot find it');+ await expect(promise).rejects.toThrow('Git is not installed or Switch Console cannot find it');});});diff --git a/dash/apps/switchdash-desktop/src/main/core/managed-switch-server/env-file.test.ts b/dash/apps/switchdash-desktop/src/main/core/managed-switch-server/env-file.test.tsindex ebf21845c..66697895e 100644--- a/dash/apps/switchdash-desktop/src/main/core/managed-switch-server/env-file.test.ts+++ b/dash/apps/switchdash-desktop/src/main/core/managed-switch-server/env-file.test.ts@@ -72,7 +72,7 @@ describe('buildEnvFile', () => {it('defines every var the bundled compose file interpolates', () => {// Derived from the compose file rather than a hand-kept list. The previous// list had drifted both ways — it omitted GATEWAY_PUBLIC_URL (so the- // "Open in SwitchDash" redirect was silently disabled on every managed+ // "Open in Switch Console" redirect was silently disabled on every managed// stack) while asserting vars compose never interpolates. A list cannot// notice a variable being added to the contract; this can.const interpolated = new Set(diff --git a/dash/apps/switchdash-desktop/src/main/core/managed-switch-server/env-file.ts b/dash/apps/switchdash-desktop/src/main/core/managed-switch-server/env-file.tsindex ed0529556..1bae1641a 100644--- a/dash/apps/switchdash-desktop/src/main/core/managed-switch-server/env-file.ts+++ b/dash/apps/switchdash-desktop/src/main/core/managed-switch-server/env-file.ts@@ -28,7 +28,7 @@ export type LocalServerEnvParams = {export function buildEnvFile(params: LocalServerEnvParams): string {const { version, registry, namespace, ports, secrets } = params;return [- '# Generated by switchdash local-server mode — do not edit by hand.',+ '# Generated by Switch Console local-server mode — do not edit by hand.','# Secrets originate in the app encrypted store; this file is derived.',`SWITCH_REGISTRY=${registry}`,`SWITCH_IMAGE_NAMESPACE=${namespace}`,@@ -56,7 +56,7 @@ export function buildEnvFile(params: LocalServerEnvParams): string {`GATEWAY_ADMIN_EMAIL=${LOCAL_SERVER_ADMIN_EMAIL}`,`GATEWAY_ADMIN_PASSWORD=${secrets.gatewayAdminPassword}`,`FRONTEND_BASE_URL=${gatewayUrlFor(ports)}`,- // Turns the "Open in SwitchDash" link into an http(s) one. Discord (and any+ // Turns the "Open in Switch Console" link into an http(s) one. Discord (and any// other bridge that only linkifies http) renders a raw `switchdash://`// deeplink as dead text, so switch-core rewrites it to point at its own// `/deeplink/session`, which 302s back to the deeplink — but only when thisdiff --git a/dash/apps/switchdash-desktop/src/main/core/managed-switch-server/secrets.test.ts b/dash/apps/switchdash-desktop/src/main/core/managed-switch-server/secrets.test.tsindex cd8323f7f..545b730ae 100644--- a/dash/apps/switchdash-desktop/src/main/core/managed-switch-server/secrets.test.ts+++ b/dash/apps/switchdash-desktop/src/main/core/managed-switch-server/secrets.test.ts@@ -1,6 +1,18 @@-import { describe, expect, it } from 'vitest';+import { beforeEach, describe, expect, it, vi } from 'vitest';import { generateSecrets } from './secret-values';+const getSecret = vi.fn();+const setSecret = vi.fn();++vi.mock('@main/core/secrets/encrypted-app-secrets-store', () => ({+ encryptedAppSecretsStore: {+ getSecret: (...args: unknown[]) => getSecret(...args),+ setSecret: (...args: unknown[]) => setSecret(...args),+ },+}));++const { loadOrCreateSecrets } = await import('./secrets');+describe('generateSecrets', () => {it('populates every field with a non-empty value', () => {const s = generateSecrets();@@ -18,3 +30,45 @@ describe('generateSecrets', () => {expect(a.dbPassword).not.toBe(b.dbPassword);});});++describe('loadOrCreateSecrets', () => {+ beforeEach(() => {+ getSecret.mockReset();+ setSecret.mockReset();+ });++ it('creates and persists a bundle when the host has none', async () => {+ getSecret.mockResolvedValue(null);++ const secrets = await loadOrCreateSecrets({ secretsKey: 'host-a' });++ expect(secrets.dbPassword).toBeTruthy();+ expect(setSecret).toHaveBeenCalledWith('host-a', JSON.stringify(secrets));+ });++ it('reuses the stored bundle rather than generating a second one', async () => {+ const stored = generateSecrets();+ getSecret.mockResolvedValue(JSON.stringify(stored));++ await expect(loadOrCreateSecrets({ secretsKey: 'host-a' })).resolves.toEqual(stored);+ expect(setSecret).not.toHaveBeenCalled();+ });++ it('fails loud on an unreadable bundle instead of regenerating over a live volume', async () => {+ getSecret.mockResolvedValue('not json');++ await expect(loadOrCreateSecrets({ secretsKey: 'host-a' })).rejects.toThrow(+ /credentials for this managed server are unreadable/+ );+ expect(setSecret).not.toHaveBeenCalled();+ });++ it('propagates a decryption failure rather than treating it as absent', async () => {+ getSecret.mockRejectedValue(new Error("Stored secret 'host-a' could not be decrypted."));++ await expect(loadOrCreateSecrets({ secretsKey: 'host-a' })).rejects.toThrow(+ /could not be decrypted/+ );+ expect(setSecret).not.toHaveBeenCalled();+ });+});diff --git a/dash/apps/switchdash-desktop/src/main/core/managed-switch-server/secrets.ts b/dash/apps/switchdash-desktop/src/main/core/managed-switch-server/secrets.tsindex 51f67dc8b..0af8f9927 100644--- a/dash/apps/switchdash-desktop/src/main/core/managed-switch-server/secrets.ts+++ b/dash/apps/switchdash-desktop/src/main/core/managed-switch-server/secrets.ts@@ -2,6 +2,26 @@ import { encryptedAppSecretsStore } from '@main/core/secrets/encrypted-app-secreimport type { ServerHost } from './host/types';import { generateSecrets, type LocalServerSecrets } from './secret-values';+/**+ * A stored bundle that will not parse is not the same as no bundle at all, and+ * the two callers below have to tell them apart: a reader shows nothing, while+ * the loader must refuse to mint replacements.+ */+type StoredSecrets =+ | { kind: 'missing' }+ | { kind: 'present'; secrets: LocalServerSecrets }+ | { kind: 'unreadable'; cause: unknown };++async function readStoredSecrets(host: Pick<ServerHost, 'secretsKey'>): Promise<StoredSecrets> {+ const existing = await encryptedAppSecretsStore.getSecret(host.secretsKey);+ if (!existing) return { kind: 'missing' };+ try {+ return { kind: 'present', secrets: JSON.parse(existing) as LocalServerSecrets };+ } catch (cause) {+ return { kind: 'unreadable', cause };+ }+}+/*** Return the host's stored secret bundle, generating and persisting one on first* use. Reusing the same secrets across restarts is required — the Postgres@@ -12,8 +32,16 @@ import { generateSecrets, type LocalServerSecrets } from './secret-values';export async function loadOrCreateSecrets(host: Pick<ServerHost, 'secretsKey'>): Promise<LocalServerSecrets> {- const existing = await readSecrets(host);- if (existing) return existing;+ const stored = await readStoredSecrets(host);+ if (stored.kind === 'present') return stored.secrets;+ if (stored.kind === 'unreadable') {+ throw new Error(+ `The stored credentials for this managed server are unreadable. Generating replacements ` ++ `would lock the stack out of the Postgres volume its first password created, so this ` ++ `stops instead: reset the stack to start from fresh credentials, which deletes its data.`,+ { cause: stored.cause }+ );+ }const fresh = generateSecrets();await encryptedAppSecretsStore.setSecret(host.secretsKey, JSON.stringify(fresh));@@ -32,13 +60,8 @@ export async function loadOrCreateSecrets(export async function readSecrets(host: Pick<ServerHost, 'secretsKey'>): Promise<LocalServerSecrets | null> {- const existing = await encryptedAppSecretsStore.getSecret(host.secretsKey);- if (!existing) return null;- try {- return JSON.parse(existing) as LocalServerSecrets;- } catch {- return null;- }+ const stored = await readStoredSecrets(host);+ return stored.kind === 'present' ? stored.secrets : null;}/** Drop the host's secret bundle so the next start generates fresh credentials.diff --git a/dash/apps/switchdash-desktop/src/main/core/remote-hosts/setup/host-setup-runner.ts b/dash/apps/switchdash-desktop/src/main/core/remote-hosts/setup/host-setup-runner.tsindex e98ebf367..13d2d70c9 100644--- a/dash/apps/switchdash-desktop/src/main/core/remote-hosts/setup/host-setup-runner.ts+++ b/dash/apps/switchdash-desktop/src/main/core/remote-hosts/setup/host-setup-runner.ts@@ -446,8 +446,8 @@ function describeUnactionable(step: HostSetupStep): string {case 'unknown':return step.error ?? `Could not determine whether ${step.name} is available.`;case 'wrong-version':- return `${step.name} is installed but too old, and switchdash has no upgrade command for this host.`;+ return `${step.name} is installed but too old, and Switch Console has no upgrade command for this host.`;default:- return `${step.name} is not installed, and switchdash has no install command for this host.`;+ return `${step.name} is not installed, and Switch Console has no install command for this host.`;}}diff --git a/dash/apps/switchdash-desktop/src/main/core/remote-hosts/setup/step-outcomes.ts b/dash/apps/switchdash-desktop/src/main/core/remote-hosts/setup/step-outcomes.tsindex 7ccf2cafe..2c691d3b5 100644--- a/dash/apps/switchdash-desktop/src/main/core/remote-hosts/setup/step-outcomes.ts+++ b/dash/apps/switchdash-desktop/src/main/core/remote-hosts/setup/step-outcomes.ts@@ -115,7 +115,7 @@ export function describeInstallFailure(// to sudo on someone's host.const eaccesPath = NPM_GLOBAL_EACCES.exec(output ?? '')?.[1];if (eaccesPath) {- return `Could not install ${name}: the SSH user cannot write to \`${eaccesPath}\`, which is where this host's npm installs global packages. switchdash does not run installs as root on its own. Either make npm's global prefix writable by this user (\`npm config set prefix\` pointing somewhere it owns, with that bin directory on PATH), or install this agent on the host manually with sudo and re-check. Nothing was changed on the host.`;+ return `Could not install ${name}: the SSH user cannot write to \`${eaccesPath}\`, which is where this host's npm installs global packages. Switch Console does not run installs as root on its own. Either make npm's global prefix writable by this user (\`npm config set prefix\` pointing somewhere it owns, with that bin directory on PATH), or install this agent on the host manually with sudo and re-check. Nothing was changed on the host.`;}// The install never started: the tool that runs it is not there. Left raw,diff --git a/dash/apps/switchdash-desktop/src/main/core/secrets/encrypted-app-secrets-store.ts b/dash/apps/switchdash-desktop/src/main/core/secrets/encrypted-app-secrets-store.tsindex 1b0953ab5..40adb663c 100644--- a/dash/apps/switchdash-desktop/src/main/core/secrets/encrypted-app-secrets-store.ts+++ b/dash/apps/switchdash-desktop/src/main/core/secrets/encrypted-app-secrets-store.ts@@ -23,7 +23,18 @@ export class EncryptedAppSecretsStore {}this.assertSecureStorageAvailable();- return this.safeStorageApi.decryptString(Buffer.from(secret, 'base64'));+ try {+ return this.safeStorageApi.decryptString(Buffer.from(secret, 'base64'));+ } catch (cause) {+ throw new Error(+ `Stored secret '${key}' exists but could not be decrypted. On macOS and Linux the ` ++ `encryption key lives in an OS keychain entry named after the application, so a build ` ++ `whose product name changed is handed a different key and cannot read secrets written ` ++ `by the previous one. Whatever owns this secret has to write it again; for a managed ` ++ `Switch server that means resetting the stack, which deletes its data.`,+ { cause }+ );+ }}async setSecret(key: string, secret: string): Promise<void> {diff --git a/dash/apps/switchdash-desktop/src/main/core/sessions/remote-session-preflight.test.ts b/dash/apps/switchdash-desktop/src/main/core/sessions/remote-session-preflight.test.tsindex edf8e39aa..6f84e65c5 100644--- a/dash/apps/switchdash-desktop/src/main/core/sessions/remote-session-preflight.test.ts+++ b/dash/apps/switchdash-desktop/src/main/core/sessions/remote-session-preflight.test.ts@@ -98,7 +98,7 @@ describe('preflightRemoteSession', () => {it('fails loud when node is present but too old', async () => {const deps = makeDeps({ nodeVersion: 'v12.22.9', credsFile: CREDS_FILE });await expect(preflightRemoteSession(deps)).rejects.toThrow(- /has Node v12.22.9, but the switchdash sidecar needs Node 18 or newer/+ /has Node v12.22.9, but the Switch Console sidecar needs Node 18 or newer/);});diff --git a/dash/apps/switchdash-desktop/src/main/core/sessions/remote-session-preflight.ts b/dash/apps/switchdash-desktop/src/main/core/sessions/remote-session-preflight.tsindex 4ef4d20e6..19ecdae46 100644--- a/dash/apps/switchdash-desktop/src/main/core/sessions/remote-session-preflight.ts+++ b/dash/apps/switchdash-desktop/src/main/core/sessions/remote-session-preflight.ts@@ -106,7 +106,7 @@ async function assertHostReady(detail,});throw new Error(- `the SSH connection to host '${host}' could not open another channel (${detail}). Every remote session on a host shares one SSH connection — either the server's sshd MaxSessions is exhausted (close some sessions on '${host}' or raise it), or the shared connection is unhealthy; switchdash rebuilds an unhealthy connection automatically, so retry in a few seconds.`+ `the SSH connection to host '${host}' could not open another channel (${detail}). Every remote session on a host shares one SSH connection — either the server's sshd MaxSessions is exhausted (close some sessions on '${host}' or raise it), or the shared connection is unhealthy; Switch Console rebuilds an unhealthy connection automatically, so retry in a few seconds.`);}if (isTransportFailure(error)) {@@ -116,7 +116,7 @@ async function assertHostReady(detail,});throw new Error(- `the SSH connection to host '${host}' is not usable right now (${detail}). switchdash reconnects automatically — retry in a few seconds.`+ `the SSH connection to host '${host}' is not usable right now (${detail}). Switch Console reconnects automatically — retry in a few seconds.`);}log.warn('preflightRemoteSession: host-ready probe failed', { workDir, host, detail });@@ -144,7 +144,7 @@ async function assertHostReady(const major = Number.parseInt(nodeVersion.replace(/^v/, ''), 10);if (!Number.isFinite(major) || major < MIN_NODE_MAJOR) {throw new Error(- `remote host '${host}' has Node ${nodeVersion || '(unknown)'}, but the switchdash sidecar needs Node ${MIN_NODE_MAJOR} or newer. Install a current Node on the host (e.g. via NodeSource or nvm) so it is the default \`node\` on PATH, then retry.`+ `remote host '${host}' has Node ${nodeVersion || '(unknown)'}, but the Switch Console sidecar needs Node ${MIN_NODE_MAJOR} or newer. Install a current Node on the host (e.g. via NodeSource or nvm) so it is the default \`node\` on PATH, then retry.`);}}diff --git a/dash/apps/switchdash-desktop/src/main/core/switch-rooms/mattermost-embed.ts b/dash/apps/switchdash-desktop/src/main/core/switch-rooms/mattermost-embed.tsindex 99596935d..0b56cd178 100644--- a/dash/apps/switchdash-desktop/src/main/core/switch-rooms/mattermost-embed.ts+++ b/dash/apps/switchdash-desktop/src/main/core/switch-rooms/mattermost-embed.ts@@ -160,7 +160,7 @@ export async function resolveChannelEmbed(params: {}return {kind: 'unavailable',- reason: `This room is bridged to ${bridgeType}, which cannot be shown inside switchdash.`,+ reason: `This room is bridged to ${bridgeType}, which cannot be shown inside Switch Console.`,};}diff --git a/dash/apps/switchdash-desktop/src/main/core/switch-rooms/room-connection.ts b/dash/apps/switchdash-desktop/src/main/core/switch-rooms/room-connection.tsindex dd3617a49..07ab72078 100644--- a/dash/apps/switchdash-desktop/src/main/core/switch-rooms/room-connection.ts+++ b/dash/apps/switchdash-desktop/src/main/core/switch-rooms/room-connection.ts@@ -331,7 +331,7 @@ export class RoomConnection {this.stream.start();// Seed this room's deeplink right away (an idle report carries it) so the- // session's `(Open in SwitchDash)` link is available in the new room's+ // session's `(Open in Switch Console)` link is available in the new room's// !status immediately on connect/switch — not only once the agent next// works. idle surfaces nothing on the bridge, so this posts no message.if (this.roomId) void this.postRuntimeState('idle', null).catch(() => {});diff --git a/dash/apps/switchdash-desktop/src/main/core/switch-servers/bundled-chat-sign-in.ts b/dash/apps/switchdash-desktop/src/main/core/switch-servers/bundled-chat-sign-in.tsindex 87578ddf4..8a6b1a5f9 100644--- a/dash/apps/switchdash-desktop/src/main/core/switch-servers/bundled-chat-sign-in.ts+++ b/dash/apps/switchdash-desktop/src/main/core/switch-servers/bundled-chat-sign-in.ts@@ -26,13 +26,16 @@ export async function bundledChatSignInFor(server: SwitchServer | null): Promise<BundledChatSignIn> {if (!server) {- return { kind: 'unavailable', reason: 'This server is no longer registered in switchdash.' };+ return {+ kind: 'unavailable',+ reason: 'This server is no longer registered in Switch Console.',+ };}if (!server.managed) {return {kind: 'unavailable',reason:- 'switchdash does not run this server, so its chat is someone else’s deployment and switchdash holds no sign-in for it.',+ 'Switch Console does not run this server, so its chat is someone else’s deployment and Switch Console holds no sign-in for it.',};}@@ -41,7 +44,7 @@ export async function bundledChatSignInFor(return {kind: 'unavailable',reason:- 'switchdash has not started this deployment yet, so it has not chosen the port its chat is published on.',+ 'Switch Console has not started this deployment yet, so it has not chosen the port its chat is published on.',};}@@ -50,7 +53,7 @@ export async function bundledChatSignInFor(return {kind: 'unavailable',reason:- 'switchdash has no stored credentials for this deployment. They are generated the first time it starts.',+ 'Switch Console has no stored credentials for this deployment. They are generated the first time it starts.',};}diff --git a/dash/apps/switchdash-desktop/src/main/core/switch-setup/controller.ts b/dash/apps/switchdash-desktop/src/main/core/switch-setup/controller.tsindex 65b9eccf8..bd5857cc5 100644--- a/dash/apps/switchdash-desktop/src/main/core/switch-setup/controller.ts+++ b/dash/apps/switchdash-desktop/src/main/core/switch-setup/controller.ts@@ -38,7 +38,7 @@ export const switchSetupController = createRPCController({return {agentId: status.agentId,available: false,- blockedReason: `switchdash cannot manage this agent type on ${sshHost}.`,+ blockedReason: `Switch Console cannot manage this agent type on ${sshHost}.`,};}return status.installeddiff --git a/dash/apps/switchdash-desktop/src/main/core/updates/dev-harness.ts b/dash/apps/switchdash-desktop/src/main/core/updates/dev-harness.tsindex 519125c21..1cb69c5bf 100644--- a/dash/apps/switchdash-desktop/src/main/core/updates/dev-harness.ts+++ b/dash/apps/switchdash-desktop/src/main/core/updates/dev-harness.ts@@ -178,7 +178,7 @@ export class FakeUpdateDriver {path: '',sha512: '',releaseDate: new Date().toISOString(),- releaseName: `Switchdash ${this.nextVersion}`,+ releaseName: `Switch Console ${this.nextVersion}`,} as UpdateInfo;}diff --git a/dash/apps/switchdash-desktop/src/main/core/utils/exec.ts b/dash/apps/switchdash-desktop/src/main/core/utils/exec.tsindex 2d5150f4e..e01cd7763 100644--- a/dash/apps/switchdash-desktop/src/main/core/utils/exec.ts+++ b/dash/apps/switchdash-desktop/src/main/core/utils/exec.ts@@ -25,6 +25,6 @@ export function isMissingGitExecutableError(error: unknown): boolean {export function missingGitExecutableError(): Error {return new Error(- 'Git is not installed or Switchdash cannot find it. Install Git, then restart Switchdash.'+ 'Git is not installed or Switch Console cannot find it. Install Git, then restart Switch Console.');}diff --git a/dash/apps/switchdash-desktop/src/renderer/app/app-menu-events.tsx b/dash/apps/switchdash-desktop/src/renderer/app/app-menu-events.tsxindex 3d362c26c..3fa0b3a4e 100644--- a/dash/apps/switchdash-desktop/src/renderer/app/app-menu-events.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/app/app-menu-events.tsx@@ -33,7 +33,7 @@ export function AppMenuEvents({ onOpenSettings }: { onOpenSettings?: () => booleuseEffect(() => {return events.on(menuQuitRequestedChannel, () => {showConfirmQuitModal({- title: 'Quit Switchdash?',+ title: 'Quit Switch Console?',description: 'Active terminal sessions and running agents will stop when the app quits.',confirmLabel: 'Quit',onSuccess: () => {diff --git a/dash/apps/switchdash-desktop/src/renderer/features/locations/components/add-agent-modal/configure-agent-panel.tsx b/dash/apps/switchdash-desktop/src/renderer/features/locations/components/add-agent-modal/configure-agent-panel.tsxindex bf4aaf1f4..d380776d5 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/locations/components/add-agent-modal/configure-agent-panel.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/locations/components/add-agent-modal/configure-agent-panel.tsx@@ -142,7 +142,7 @@ export const ConfigureAgentPanel = observer(function ConfigureAgentPanel({<span className="flex flex-col gap-0.5"><span className="text-sm">Auto-create a session on notify</span><span className="text-xs text-foreground-muted">- switchdash watches this agent's rooms and starts a session automatically when+ Switch Console watches this agent's rooms and starts a session automatically whenit's addressed with none running.</span></span>diff --git a/dash/apps/switchdash-desktop/src/renderer/features/locations/components/add-agent-modal/onboard-existing-panel.tsx b/dash/apps/switchdash-desktop/src/renderer/features/locations/components/add-agent-modal/onboard-existing-panel.tsxindex 1d020bb57..bcce76bdd 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/locations/components/add-agent-modal/onboard-existing-panel.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/locations/components/add-agent-modal/onboard-existing-panel.tsx@@ -56,8 +56,8 @@ export function OnboardExistingPanel({<div className="flex flex-col gap-2 rounded-md border border-border bg-background-1 px-3 py-2.5 text-sm"><span className="text-foreground-muted">{agents.length} agent{agents.length === 1 ? '' : 's'} in this directory{' '}- {agents.length === 1 ? "isn't" : "aren't"} in switchdash yet — pick which to bring in, or- create a new one below.+ {agents.length === 1 ? "isn't" : "aren't"} in Switch Console yet — pick which to bring in,+ or create a new one below.</span><div className="flex flex-col gap-0.5">{agents.map((a) => {diff --git a/dash/apps/switchdash-desktop/src/renderer/features/locations/components/delete-agent-modal.tsx b/dash/apps/switchdash-desktop/src/renderer/features/locations/components/delete-agent-modal.tsxindex f3ae8cade..94adf1c92 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/locations/components/delete-agent-modal.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/locations/components/delete-agent-modal.tsx@@ -33,7 +33,7 @@ export function DeleteAgentModal({ agentLabel, onSuccess, onClose }: Props) {<DialogContentArea className="flex flex-col gap-4 pt-0"><p className="text-sm text-foreground-muted"><span className="font-medium text-foreground">{agentLabel}</span> will be removed from- switchdash and the Switch credentials it stored on this machine will be cleared. The+ Switch Console and the Switch credentials it stored on this machine will be cleared. Thefolder stays on the filesystem.</p>diff --git a/dash/apps/switchdash-desktop/src/renderer/features/locations/components/reset-agent-modal.tsx b/dash/apps/switchdash-desktop/src/renderer/features/locations/components/reset-agent-modal.tsxindex 5b7413e96..3ae61ae74 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/locations/components/reset-agent-modal.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/locations/components/reset-agent-modal.tsx@@ -24,8 +24,8 @@ export function ResetAgentModal({ agentLabel, onSuccess, onClose }: Props) {</DialogHeader><DialogContentArea className="flex flex-col gap-4 pt-0"><p className="text-sm text-foreground-muted">- <span className="font-medium text-foreground">{agentLabel}</span> will be reset.- switchdash kills all of its remote sessions — the watcher and every running session — then+ <span className="font-medium text-foreground">{agentLabel}</span> will be reset. Switch+ Console kills all of its remote sessions — the watcher and every running session — thenrestarts it fresh.</p>diff --git a/dash/apps/switchdash-desktop/src/renderer/features/locations/components/settings-view/sections/auto-approve-settings-section.tsx b/dash/apps/switchdash-desktop/src/renderer/features/locations/components/settings-view/sections/auto-approve-settings-section.tsxindex 48cb85c72..82198fdf6 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/locations/components/settings-view/sections/auto-approve-settings-section.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/locations/components/settings-view/sections/auto-approve-settings-section.tsx@@ -46,9 +46,9 @@ export function AutoApproveSettingsSection({)}</div><FieldDescription className="text-foreground-muted">- When on, switchdash starts this agent's sessions with permission prompts bypassed (the- provider's auto-approve flag). Off by default; turn it on only for agents you trust to- run unattended.+ When on, Switch Console starts this agent's sessions with permission prompts bypassed+ (the provider's auto-approve flag). Off by default; turn it on only for agents you+ trust to run unattended.</FieldDescription>{!single && (<div className="flex flex-col gap-2">diff --git a/dash/apps/switchdash-desktop/src/renderer/features/locations/components/settings-view/sections/auto-session-settings-section.tsx b/dash/apps/switchdash-desktop/src/renderer/features/locations/components/settings-view/sections/auto-session-settings-section.tsxindex 25c6cad9a..5525a9276 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/locations/components/settings-view/sections/auto-session-settings-section.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/locations/components/settings-view/sections/auto-session-settings-section.tsx@@ -41,7 +41,7 @@ export function AutoSessionSettingsSection({{single && <AutoSessionSwitch agentId={single.id} />}</div><FieldDescription className="text-foreground-muted">- When on, switchdash watches this agent's Switch rooms and automatically starts a+ When on, Switch Console watches this agent's Switch rooms and automatically starts asession — connected to the room and ready to reply — whenever it's addressed with nosession running.</FieldDescription>diff --git a/dash/apps/switchdash-desktop/src/renderer/features/locations/components/settings-view/sections/sidecar-settings-section.tsx b/dash/apps/switchdash-desktop/src/renderer/features/locations/components/settings-view/sections/sidecar-settings-section.tsxindex 009105aef..664009298 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/locations/components/settings-view/sections/sidecar-settings-section.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/locations/components/settings-view/sections/sidecar-settings-section.tsx@@ -76,8 +76,8 @@ export function SidecarSettingsSection({ agentId }: { agentId: string }) {{data && <VerdictBadge verdict={data.verdict} />}</div><FieldDescription className="text-foreground-muted">- The on-host process that keeps this agent connected to its Switch rooms while switchdash is- closed. Updated automatically when switchdash connects; you can also manage it here.+ The on-host process that keeps this agent connected to its Switch rooms while Switch Console+ is closed. Updated automatically when Switch Console connects; you can also manage it here.</FieldDescription>{isLoading && (diff --git a/dash/apps/switchdash-desktop/src/renderer/features/remote-hosts/add-host-modal.tsx b/dash/apps/switchdash-desktop/src/renderer/features/remote-hosts/add-host-modal.tsxindex ef8d57320..f42320623 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/remote-hosts/add-host-modal.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/remote-hosts/add-host-modal.tsx@@ -88,8 +88,8 @@ export function AddHostModal({ onboarded, onAdded, onClose }: AddHostModalProps)<Field><FieldLabel>SSH host</FieldLabel><p className="text-xs text-foreground-muted">- A Host alias from your <code>~/.ssh/config</code>. Auth uses your SSH agent —- switchdash stores no credentials.+ A Host alias from your <code>~/.ssh/config</code>. Auth uses your SSH agent — Switch+ Console stores no credentials.</p>{/*Wait for the alias list before choosing which control to show.diff --git a/dash/apps/switchdash-desktop/src/renderer/features/remote-hosts/views/remote-host-view.tsx b/dash/apps/switchdash-desktop/src/renderer/features/remote-hosts/views/remote-host-view.tsxindex 48067adf5..b16e1e38e 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/remote-hosts/views/remote-host-view.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/remote-hosts/views/remote-host-view.tsx@@ -144,7 +144,7 @@ export const RemoteHostMainPanel = observer(function RemoteHostMainPanel() {<PageHeaderstickytitle={host?.name ?? sshHost}- description={`Remote host · ${sshHost}. Auth uses your SSH agent — switchdash stores no credentials.`}+ description={`Remote host · ${sshHost}. Auth uses your SSH agent — Switch Console stores no credentials.`}back={<Buttonsize="sm"diff --git a/dash/apps/switchdash-desktop/src/renderer/features/settings/agents-page/InstallationOverrideCard.tsx b/dash/apps/switchdash-desktop/src/renderer/features/settings/agents-page/InstallationOverrideCard.tsxindex d060f2367..ef5e17190 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/settings/agents-page/InstallationOverrideCard.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/settings/agents-page/InstallationOverrideCard.tsx@@ -55,8 +55,8 @@ export function InstallationOverrideCard({/><Alert variant="warning">{kind === 'path'- ? "Using an absolute path to the agent binary overrides auto-resolution and disables switchdash's ability to update the agent."- : "Enter the command name or binary resolved on PATH. This overrides auto-resolution and disables switchdash's ability to update the agent."}+ ? "Using an absolute path to the agent binary overrides auto-resolution and disables Switch Console's ability to update the agent."+ : "Enter the command name or binary resolved on PATH. This overrides auto-resolution and disables Switch Console's ability to update the agent."}</Alert>{hasValue && (<div className="flex justify-end">diff --git a/dash/apps/switchdash-desktop/src/renderer/features/settings/agents-page/SwitchSetupCard.tsx b/dash/apps/switchdash-desktop/src/renderer/features/settings/agents-page/SwitchSetupCard.tsxindex 2962d51d8..8604a6b97 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/settings/agents-page/SwitchSetupCard.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/settings/agents-page/SwitchSetupCard.tsx@@ -120,8 +120,8 @@ export function SwitchSetupCard({ agentId }: { agentId: string }) {)}{currencyUnknown && !status.refreshError && (<p className="text-xs text-foreground-warning">- This agent type doesn't report plugin versions here, so switchdash can't tell whether an- update exists. Reinstall to be sure you are on the latest.+ This agent type doesn't report plugin versions here, so Switch Console can't tell+ whether an update exists. Reinstall to be sure you are on the latest.</p>)}{!status.installed && !ghReady && (diff --git a/dash/apps/switchdash-desktop/src/renderer/features/settings/components/NotificationSettingsCard.tsx b/dash/apps/switchdash-desktop/src/renderer/features/settings/components/NotificationSettingsCard.tsxindex 2f43c312b..e18516037 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/settings/components/NotificationSettingsCard.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/settings/components/NotificationSettingsCard.tsx@@ -216,7 +216,7 @@ const NotificationSettingsCard: React.FC = () => {<SettingRowtitle="OS notifications"- description="Show system banners when agents need attention or finish (while Switchdash is unfocused)."+ description="Show system banners when agents need attention or finish (while Switch Console is unfocused)."control={<><ResetToDefaultButtondiff --git a/dash/apps/switchdash-desktop/src/renderer/features/settings/components/ThemeCard.tsx b/dash/apps/switchdash-desktop/src/renderer/features/settings/components/ThemeCard.tsxindex 025efbc61..03b62ba50 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/settings/components/ThemeCard.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/settings/components/ThemeCard.tsx@@ -20,7 +20,7 @@ const ThemeCard: React.FC = () => {<div className="grid gap-3 text-sm"><div><div className="font-medium text-foreground">Color mode</div>- <div className="text-foreground-muted">Choose how Switchdash looks.</div>+ <div className="text-foreground-muted">Choose how Switch Console looks.</div></div><div className="grid grid-cols-[repeat(auto-fit,minmax(6.5rem,1fr))] gap-2"><button@@ -38,20 +38,20 @@ const ThemeCard: React.FC = () => {onClick={() => handleSetTheme('emlight')}className={`${buttonBase} ${theme === 'emlight' ? activeClass : inactiveClass}`}aria-pressed={theme === 'emlight'}- aria-label="Set theme to Switchdash Light"+ aria-label="Set theme to Switch Console Light"><Sun className="h-4 w-4 shrink-0" aria-hidden="true" />- <span className="text-center">Switchdash Light</span>+ <span className="text-center">Switch Console Light</span></button><buttontype="button"onClick={() => handleSetTheme('emdark')}className={`${buttonBase} ${theme === 'emdark' ? activeClass : inactiveClass}`}aria-pressed={theme === 'emdark'}- aria-label="Set theme to Switchdash Dark"+ aria-label="Set theme to Switch Console Dark"><Moon className="h-4 w-4 shrink-0" aria-hidden="true" />- <span className="text-center">Switchdash Dark</span>+ <span className="text-center">Switch Console Dark</span></button></div></div>diff --git a/dash/apps/switchdash-desktop/src/renderer/features/sidebar/sidebar-room-grouping.tsx b/dash/apps/switchdash-desktop/src/renderer/features/sidebar/sidebar-room-grouping.tsxindex ffe0a003e..4bfe9af9d 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/sidebar/sidebar-room-grouping.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/sidebar/sidebar-room-grouping.tsx@@ -273,7 +273,7 @@ export function RoomRow({/><TooltipContent>{undrawableCount} more {undrawableCount === 1 ? 'member is' : 'members are'} in this- room but not on this switchdash, so they cannot be shown here+ room but not on this copy of Switch Console, so they cannot be shown here</TooltipContent></Tooltip>)}diff --git a/dash/apps/switchdash-desktop/src/renderer/features/switch-rooms/AddAgentsToRoomModal.tsx b/dash/apps/switchdash-desktop/src/renderer/features/switch-rooms/AddAgentsToRoomModal.tsxindex 5b89dbaf7..646ea706e 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/switch-rooms/AddAgentsToRoomModal.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/switch-rooms/AddAgentsToRoomModal.tsx@@ -156,8 +156,8 @@ export const AddAgentsToRoomModal = observer(function AddAgentsToRoomModal({)}{nothingToAdd && (<p className="mt-1 text-xs text-foreground-muted">- Every agent on this switchdash is already in the room. Agents registered elsewhere- can only be added from the gateway.+ Every agent on this copy of Switch Console is already in the room. Agents registered+ elsewhere can only be added from the gateway.</p>)}</Field>diff --git a/dash/apps/switchdash-desktop/src/renderer/features/switch-rooms/session-deeplink-listener.tsx b/dash/apps/switchdash-desktop/src/renderer/features/switch-rooms/session-deeplink-listener.tsxindex e3ca3828d..ee21bc801 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/switch-rooms/session-deeplink-listener.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/switch-rooms/session-deeplink-listener.tsx@@ -73,7 +73,7 @@ export function SessionDeeplinkListener(): null {});toast.error('No agent session found for this link', {description:- 'This switchdash has no local session for the linked room. Open it on the client running that agent.',+ 'This copy of Switch Console has no local session for the linked room. Open it on the client running that agent.',});return;}diff --git a/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/AddServerModal.tsx b/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/AddServerModal.tsxindex 3ee3fa8f0..d1f419db7 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/AddServerModal.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/AddServerModal.tsx@@ -132,19 +132,19 @@ function ChooseStep({<ChoiceCardicon={<HardDrive className="size-5" />}title="Run a server on this computer"- description="switchdash sets up and runs the full Switch stack here with Docker. Best for trying Switch out."+ description="Switch Console sets up and runs the full Switch stack here with Docker. Best for trying Switch out."onClick={onLocal}/><ChoiceCardicon={<Server className="size-5" />}title="Run a server on a remote host"- description="switchdash sets it up over SSH on a host you've onboarded. Stays running when switchdash is closed."+ description="Switch Console sets it up over SSH on a host you've onboarded. Stays running when Switch Console is closed."onClick={onRemoteHost}/><ChoiceCardicon={<Globe className="size-5" />}title="Connect to an existing server"- description="Point switchdash at a Switch gateway someone else runs, by URL."+ description="Point Switch Console at a Switch gateway someone else runs, by URL."onClick={onExternal}/></div>@@ -521,7 +521,8 @@ const RemoteHostSetupStep = observer(function RemoteHostSetupStep({<CircleCheck className="size-4" /><AlertTitle>Server is running on {sshHost}</AlertTitle><AlertDescription>- It's in your servers list, reachable from this computer while switchdash is open.+ It's in your servers list, reachable from this computer while Switch Console is+ open.</AlertDescription></Alert>)}diff --git a/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/ConnectMessagingAppModal.tsx b/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/ConnectMessagingAppModal.tsxindex 16416ec38..491c62fc0 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/ConnectMessagingAppModal.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/ConnectMessagingAppModal.tsx@@ -189,7 +189,7 @@ export const ConnectMessagingAppModal = observer(function ConnectMessagingAppMod}}/><p className="mt-1 text-xs text-foreground-muted">- How this connection is labelled in switchdash when you pick it for a room.+ How this connection is labelled in Switch Console when you pick it for a room.</p></Field>diff --git a/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/DeleteServerModal.tsx b/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/DeleteServerModal.tsxindex 3e7d4bb36..caf7fdaf4 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/DeleteServerModal.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/DeleteServerModal.tsx@@ -102,12 +102,12 @@ export const DeleteServerModal = observer(function DeleteServerModal({? `on ${server.sshHost}`: 'on this computer'}{' '}— its containers, <strong className="text-foreground">all data and secrets</strong> —- and removes it from switchdash. This can’t be undone.+ and removes it from Switch Console. This can’t be undone.</p>) : (<p className="text-sm text-foreground-muted">- This removes the server from switchdash. The server itself isn’t touched — you can add- it again later.+ This removes the server from Switch Console. The server itself isn’t touched — you can+ add it again later.</p>)}<p className="text-sm text-foreground-muted">{agentsNote}</p>diff --git a/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/LocalServerControls.tsx b/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/LocalServerControls.tsxindex 3a88bbafb..32fc91fee 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/LocalServerControls.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/LocalServerControls.tsx@@ -109,7 +109,7 @@ export const LocalServerControls = observer(function LocalServerControls() {</div><p className="text-xs text-foreground-tertiary-passive">- The stack keeps running when you close switchdash.+ The stack keeps running when you close Switch Console.</p><div className="mt-1 flex items-center justify-between gap-3 border-t border-border pt-4">diff --git a/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/RemoteServerControls.tsx b/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/RemoteServerControls.tsxindex 238b96918..921a0eebe 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/RemoteServerControls.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/RemoteServerControls.tsx@@ -126,8 +126,8 @@ export const RemoteServerControls = observer(function RemoteServerControls({</div><p className="text-xs text-foreground-tertiary-passive">- The stack keeps running on {sshHost} when you close switchdash. Remote-host agents stay- connected; agents on this computer can reach it while switchdash is open.+ The stack keeps running on {sshHost} when you close Switch Console. Remote-host agents stay+ connected; agents on this computer can reach it while Switch Console is open.</p><div className="mt-1 flex items-center justify-between gap-3 border-t border-border pt-4">diff --git a/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/VersionDriftNotice.tsx b/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/VersionDriftNotice.tsxindex 4da32d548..be170478f 100644--- a/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/VersionDriftNotice.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/features/switch-servers/VersionDriftNotice.tsx@@ -50,7 +50,7 @@ export function VersionDriftNotice({return (<Alert variant="destructive"><TriangleAlert className="size-4" />- <AlertTitle>This server is newer than switchdash</AlertTitle>+ <AlertTitle>This server is newer than Switch Console</AlertTitle><AlertDescription>{switchVersionDowngradeMessage(drift.deployed, drift.expected)}</AlertDescription>diff --git a/dash/apps/switchdash-desktop/src/renderer/index.html b/dash/apps/switchdash-desktop/src/renderer/index.htmlindex b012b3525..ff21d11d1 100644--- a/dash/apps/switchdash-desktop/src/renderer/index.html+++ b/dash/apps/switchdash-desktop/src/renderer/index.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8" /><meta name="viewport" content="width=device-width, initial-scale=1.0" />- <title>Switchdash</title>+ <title>Switch Console</title><script>(function () {try {diff --git a/dash/apps/switchdash-desktop/src/renderer/lib/components/external-link-choice-dialog.tsx b/dash/apps/switchdash-desktop/src/renderer/lib/components/external-link-choice-dialog.tsxindex 50a1f8ae8..e86b82224 100644--- a/dash/apps/switchdash-desktop/src/renderer/lib/components/external-link-choice-dialog.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/lib/components/external-link-choice-dialog.tsx@@ -45,7 +45,7 @@ export function ExternalLinkChoiceDialog({onClick={() => onSuccess('switchdash-browser')}><Globe className="size-4" />- Open in Switchdash+ Open in Switch Console</Button><Button className="w-full" variant="default" onClick={() => onSuccess('external-browser')}><ExternalLink className="size-4" />diff --git a/dash/apps/switchdash-desktop/src/renderer/lib/components/feedback-modal/use-feedback-submit.test.ts b/dash/apps/switchdash-desktop/src/renderer/lib/components/feedback-modal/use-feedback-submit.test.tsindex 151ef2dad..1bf5ee08b 100644--- a/dash/apps/switchdash-desktop/src/renderer/lib/components/feedback-modal/use-feedback-submit.test.ts+++ b/dash/apps/switchdash-desktop/src/renderer/lib/components/feedback-modal/use-feedback-submit.test.ts@@ -14,7 +14,7 @@ describe('buildFeedbackContent', () => {expect(content).toContain('Great app');expect(content).toContain('Contact: [email protected]');expect(content).toContain('GitHub: Octo Cat (@octocat)');- expect(content).toContain('Switchdash Version: 1.2.3');+ expect(content).toContain('Switch Console Version: 1.2.3');});it('notes diagnostic logs when user opts in', () => {diff --git a/dash/apps/switchdash-desktop/src/renderer/lib/components/feedback-modal/use-feedback-submit.ts b/dash/apps/switchdash-desktop/src/renderer/lib/components/feedback-modal/use-feedback-submit.tsindex 5b470971d..ae95d552f 100644--- a/dash/apps/switchdash-desktop/src/renderer/lib/components/feedback-modal/use-feedback-submit.ts+++ b/dash/apps/switchdash-desktop/src/renderer/lib/components/feedback-modal/use-feedback-submit.ts@@ -61,7 +61,7 @@ export function buildFeedbackContent({const trimmedAppVersion = appVersion?.trim();if (trimmedAppVersion) {- metadataLines.push(`Switchdash Version: ${trimmedAppVersion}`);+ metadataLines.push(`Switch Console Version: ${trimmedAppVersion}`);}if (includeDiagnosticLogs) {diff --git a/dash/apps/switchdash-desktop/src/renderer/lib/switchdash-logo.tsx b/dash/apps/switchdash-desktop/src/renderer/lib/switchdash-logo.tsxindex fd263a138..cf536a9f9 100644--- a/dash/apps/switchdash-desktop/src/renderer/lib/switchdash-logo.tsx+++ b/dash/apps/switchdash-desktop/src/renderer/lib/switchdash-logo.tsx@@ -1,13 +1,16 @@-export const NATURAL_WIDTH = 400;+// Wide enough for LOGO_TEXT at the size below in the widest system sans the+// font stack can resolve to. The <svg> viewport clips, so this must not be+// tightened without re-measuring — the wordmark would lose its outer glyphs.+export const NATURAL_WIDTH = 545;export const NATURAL_HEIGHT = 70;-export const LOGO_TEXT = 'switchdash';+export const LOGO_TEXT = 'Switch Console';export const LOGO_FONT_FAMILY ="ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif";// The wordmark is rendered as text rather than as baked-in glyph paths so it-// carries the switchdash name with no upstream logo artwork.+// carries the product name with no upstream logo artwork.export function SwitchdashLogo({className,height = NATURAL_HEIGHT,diff --git a/dash/apps/switchdash-desktop/src/shared/app-identity.canary.ts b/dash/apps/switchdash-desktop/src/shared/app-identity.canary.tsindex b9fb74e79..58c062af3 100644--- a/dash/apps/switchdash-desktop/src/shared/app-identity.canary.ts+++ b/dash/apps/switchdash-desktop/src/shared/app-identity.canary.ts@@ -1,8 +1,10 @@// Inlined rather than re-exported from ./app-identity so this module has no relative// imports. It is loaded under Node (--experimental-strip-types) by// electron-builder.canary.config.ts, where extensionless ESM specifiers do not resolve.+// Display name only; the app id / storage identity stay on `switchdash` —+// see the note in ./app-identity.ts (CHOO-2008).export const APP_ID = 'com.switchdash.canary';-export const PRODUCT_NAME = 'Switchdash Canary';+export const PRODUCT_NAME = 'Switch Console Canary';export const APP_NAME_LOWER = 'switchdash-canary';export const UPDATE_CHANNEL = 'v1-canary';export const ARTIFACT_PREFIX = 'switchdash-canary';diff --git a/dash/apps/switchdash-desktop/src/shared/app-identity.ts b/dash/apps/switchdash-desktop/src/shared/app-identity.tsindex a08298a7c..4da79948b 100644--- a/dash/apps/switchdash-desktop/src/shared/app-identity.ts+++ b/dash/apps/switchdash-desktop/src/shared/app-identity.ts@@ -4,8 +4,16 @@ const env = (import.meta as ImportMetaWithEnv).env;const isDev = env?.DEV === true;const isCanary = env?.VITE_BUILD === 'canary';+// The product's DISPLAY name and its STORAGE identity are deliberately separate.+//+// PRODUCT_NAME is the only name a user reads. Everything below it — the app id,+// the userData directory, the artifact prefix, the `switchdash://` scheme — is+// storage/OS identity, and renaming any of it strands an existing install:+// userData holds the database, and APP_ID/ARTIFACT_PREFIX carry auto-update and+// macOS registration continuity. They stay on `switchdash` on purpose. Do not+// "fix" the inconsistency (CHOO-2008).export const APP_ID = isCanary ? 'com.switchdash.canary' : 'com.switchdash.stable';-export const PRODUCT_NAME = isCanary ? 'Switchdash Canary' : 'Switchdash';+export const PRODUCT_NAME = isCanary ? 'Switch Console Canary' : 'Switch Console';export const APP_NAME_LOWER = isCanary ? 'switchdash-canary' : 'switchdash';export const USER_DATA_DIR_NAME = isDev? 'switchdash-dev'diff --git a/dash/apps/switchdash-desktop/src/shared/commands.ts b/dash/apps/switchdash-desktop/src/shared/commands.tsindex b9c060e6a..6e14d16c3 100644--- a/dash/apps/switchdash-desktop/src/shared/commands.ts+++ b/dash/apps/switchdash-desktop/src/shared/commands.ts@@ -50,7 +50,7 @@ export const APP_COMMAND_DEFS = defineCommandDefs([{id: 'app.addServer',label: 'Add Switch Server',- description: 'Connect switchdash to a Switch server, or run a managed one',+ description: 'Connect Switch Console to a Switch server, or run a managed one',scope: 'app',group: 'App',iconKey: 'server',@@ -67,7 +67,7 @@ export const APP_COMMAND_DEFS = defineCommandDefs([{id: 'app.giveFeedback',label: 'Give Feedback',- description: 'Send feedback to the switchdash team',+ description: 'Send feedback to the Switch Console team',scope: 'app',group: 'App',iconKey: 'message-square-share',diff --git a/dash/apps/switchdash-desktop/src/shared/core/managed-switch-server/managed-switch-server.ts b/dash/apps/switchdash-desktop/src/shared/core/managed-switch-server/managed-switch-server.tsindex 738b953e1..99e732da0 100644--- a/dash/apps/switchdash-desktop/src/shared/core/managed-switch-server/managed-switch-server.ts+++ b/dash/apps/switchdash-desktop/src/shared/core/managed-switch-server/managed-switch-server.ts@@ -67,7 +67,7 @@ export type SwitchVersionDrift =export function switchVersionDowngradeMessage(deployed: string, expected: string): string {return (`Runs switch-core ${deployed}; this app pins ${expected}. Its database has already migrated ` +- `forward and switch-core can't roll back — update switchdash to a build with switch-core ` ++ `forward and switch-core can't roll back — update Switch Console to a build with switch-core ` +`${deployed} or newer, or reset the stack (deletes its data).`);}diff --git a/dash/apps/switchdash-desktop/tooling/byoi/README.md b/dash/apps/switchdash-desktop/tooling/byoi/README.mdindex 995a50a4a..559e1c687 100644--- a/dash/apps/switchdash-desktop/tooling/byoi/README.md+++ b/dash/apps/switchdash-desktop/tooling/byoi/README.md@@ -1,14 +1,14 @@-# Switchdash BYOI Testing Kit+# Switch Console BYOI Testing Kit-A copy-pasteable setup for testing switchdash's BYOI (Bring Your Own Infrastructure) feature.+A copy-pasteable setup for testing Switch Console's BYOI (Bring Your Own Infrastructure) feature.Each task gets its own Docker container running a full Linux dev environment with Node.js, git, tmux, and Claude Code pre-installed.## How it works-1. When you create a task, switchdash runs `provision.sh`+1. When you create a task, Switch Console runs `provision.sh`2. The script builds a Docker image (first run only), starts a new container, clones your repo into it, and prints a JSON object to stdout-3. Switchdash SSH-connects to the container using password auth and opens the workspace at `/home/devuser/workspace`-4. When you terminate the task, switchdash runs `terminate.sh` which stops and removes the container+3. Switch Console SSH-connects to the container using password auth and opens the workspace at `/home/devuser/workspace`+4. When you terminate the task, Switch Console runs `terminate.sh` which stops and removes the container## Prerequisites@@ -34,7 +34,7 @@ Make the scripts executable:chmod +x scripts/provision.sh scripts/terminate.sh```-Add the project in switchdash, then create a task. That's it.+Add the project in Switch Console, then create a task. That's it.## First provision@@ -49,7 +49,7 @@ This sample prints:| Field | Value | Notes || -------------- | ------------------------------ | ---------------------------------------------------------------- || `id` | Docker container name | Passed to `terminate.sh` as `REMOTE_WORKSPACE_ID` |-| `host` | `localhost` | Host Switchdash connects to |+| `host` | `localhost` | Host Switch Console connects to || `port` | Random Docker host port for 22 | Must be a JSON number || `username` | `devuser` | SSH username || `password` | `devpass` | SSH password |@@ -58,7 +58,7 @@ This sample prints:## Forwarding API keys-The provision script forwards API keys from your host environment into the container automatically. Just make sure the relevant variables are set in your shell before switchdash runs the provision script:+The provision script forwards API keys from your host environment into the container automatically. Just make sure the relevant variables are set in your shell before Switch Console runs the provision script:```bashexport ANTHROPIC_API_KEY=sk-ant-...diff --git a/dash/docs/INSTALL.md b/dash/docs/INSTALL.mdindex 21b353409..198414c51 100644--- a/dash/docs/INSTALL.md+++ b/dash/docs/INSTALL.md@@ -1,6 +1,6 @@-# Installing switchdash+# Installing Switch Console-switchdash is distributed as a desktop app through **GitHub Releases on this+Switch Console is distributed as a desktop app through **GitHub Releases on thisrepository** (`sandbox-quantum/switch`). The repo is private, so the releasedownloads are automatically limited to people with repo-read access — there isno separate sign-up or allowlist. No need to build from source.@@ -46,24 +46,25 @@ gh release download switchdash-v<version> \## Install (macOS)-1. Open the downloaded `.dmg`.-2. Drag **Switchdash** into your **Applications** folder.+1. Open the downloaded `.dmg` (the download filename still uses the old+ `switchdash-` prefix — only the app's display name changed).+2. Drag **Switch Console** into your **Applications** folder.### First launch — one-time Gatekeeper bypassThese builds are **unsigned** (no Apple Developer certificate), so macOSGatekeeper blocks the first launch. Clear it once, either way:-- **Right-click → Open**: right-click (or Control-click) Switchdash in+- **Right-click → Open**: right-click (or Control-click) Switch Console inApplications, choose **Open**, then confirm **Open** in the dialog. macOSremembers the choice for future launches.- **Or via Terminal**:```bash- xattr -dr com.apple.quarantine /Applications/Switchdash.app+ xattr -dr com.apple.quarantine "/Applications/Switch Console.app"```-After that, launch switchdash normally.+After that, launch Switch Console normally.## Install (Linux x64)@@ -94,13 +95,13 @@ Linux builds are **unsigned**. Pick the format your distro uses:## Updating-switchdash checks this repo's Releases for new versions in-app. Because the repo+Switch Console checks this repo's Releases for new versions in-app. Because the repois private, the updater authenticates using the **GitHub CLI token you alreadyhave** — no extra login inside the app:1. Make sure the [`gh` CLI](https://cli.github.com) is installed and you've run`gh auth login` once.-2. switchdash reads your token via `gh auth token` and offers the update when+2. Switch Console reads your token via `gh auth token` and offers the update whenone is available (Settings → checks automatically; you can also recheckmanually).@@ -113,8 +114,9 @@ re-install (drag over the old app).## Notes- Release **asset filenames are prefixed `switchdash-`** (e.g. `switchdash-arm64.dmg`).- The release identity — app id, artifact names, and signing — all carry the- **switchdash** name.-- switchdash releases use the `switchdash-v*` tag prefix and are published with+ Only the display name is "Switch Console": the release identity — app id,+ artifact names, and signing — deliberately still carries the **switchdash**+ name so existing installs keep updating.+- Switch Console releases use the `switchdash-v*` tag prefix and are published withthe repo-wide "Latest" badge **off**, so they never collide with other releasestreams in this repo.diff --git a/dash/packages/plugins/src/agents/impl/kiro/hooks.ts b/dash/packages/plugins/src/agents/impl/kiro/hooks.tsindex a91e881b1..e198a681f 100644--- a/dash/packages/plugins/src/agents/impl/kiro/hooks.ts+++ b/dash/packages/plugins/src/agents/impl/kiro/hooks.ts@@ -17,7 +17,7 @@ export function buildKiroHookConfig() {],{name: 'switchdash',- description: 'Switchdash-managed Kiro agent configuration for lifecycle hooks.',+ description: 'Switch Console-managed Kiro agent configuration for lifecycle hooks.',});}diff --git a/dash/packages/plugins/src/agents/impl/mistral/hooks.ts b/dash/packages/plugins/src/agents/impl/mistral/hooks.tsindex 7fc83d73b..a1f49b45a 100644--- a/dash/packages/plugins/src/agents/impl/mistral/hooks.ts+++ b/dash/packages/plugins/src/agents/impl/mistral/hooks.ts@@ -17,7 +17,7 @@ const MISTRAL_HOOK_ENTRIES = [command: makeStdinHookCommand('stop'),timeout: 10,strict: false,- description: 'Notify Switchdash when Mistral Vibe finishes an agent turn.',+ description: 'Notify Switch Console when Mistral Vibe finishes an agent turn.',},{name: 'switchdash-ask-user-question',@@ -26,7 +26,7 @@ const MISTRAL_HOOK_ENTRIES = [command: makeNotificationHookCommand('permission_prompt'),timeout: 10,strict: false,- description: 'Notify Switchdash when Mistral Vibe asks for user input.',+ description: 'Notify Switch Console when Mistral Vibe asks for user input.',},];diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.mdindex 1a0d3da10..fcfb2278d 100644--- a/docs/ARCHITECTURE.md+++ b/docs/ARCHITECTURE.md@@ -92,7 +92,7 @@ flowchart LR| Persistence | `db/` | PostgreSQL via SQLAlchemy async; table models in `db/models.py`, query logic in `db/stores/`. || Homeserver admin | `matrix_admin.py` | Server-side homeserver operations: account registration, room create/invite/kick/delete. |-### The desktop app (switchdash)+### The desktop app (Switch Console)`dash/` is a local-first Electron desktop app (a fork; see`dash/NOTICE`) for managing the local coding-agent sessions that participate indiff --git a/docs/api/AGENT_PROTOCOL.md b/docs/api/AGENT_PROTOCOL.mdindex c16864b4c..d4cc3f4a1 100644--- a/docs/api/AGENT_PROTOCOL.md+++ b/docs/api/AGENT_PROTOCOL.md@@ -18,13 +18,13 @@ is an MCP tool that writes a row keyed on the MCP transport session id, whileevents are fetched over an unrelated HTTP request that never mentions it. Thething that joined the room and the thing receiving that room's events are twoindependent connections sharing only an agent id. Neither notices when the-other dies. Clients then keep their own copies — switchdash persists a+other dies. Clients then keep their own copies — Switch Console persists asession→room map to SQLite, the remote reconciler mirrors it, the sidecar keepsa third — so the same fact is stored four times and reconciled nowhere.**Events are held in memory and destroyed on read.** The event queue is aper-agent, per-room `asyncio.Queue`. A poll *removes* what it returns, so only-one consumer can exist (hence `SWITCH_CHANNEL_DISABLE_POLL`, which switchdash+one consumer can exist (hence `SWITCH_CHANNEL_DISABLE_POLL`, which Switch Consolesets to stop the connector stealing its events). Nothing survives a restart,and there is no way to ask "what did I miss?" because no record is kept.@@ -120,7 +120,7 @@ Exactly one recipient per room at all times: no duplicate delivery, nocoordination needed for handoff in either direction.This rule already exists — implemented client-side in-`auto-session-watcher.ts`, which skips a room when switchdash's own map says a+`auto-session-watcher.ts`, which skips a room when Switch Console's own map says asession covers it. Moving it into the protocol is the split-brain fix.**Collision.** If a `single` connection tries to claim a room already claimed@@ -685,7 +685,7 @@ Planned second mode off the same code: *daemon* (long-lived, `scope: all`,- **Claude Code** — plugin `.mcp.json` at the plugin root, `${CLAUDE_PLUGIN_ROOT}`for the path, `${VAR}` expansion for endpoint and token.- **Codex** — Codex expands neither, and a stdio server cannot be expressed on- argv the way an HTTP one can, so switchdash writes a per-agent Codex profile+ argv the way an HTTP one can, so Switch Console writes a per-agent Codex profile(`$CODEX_HOME/<slug>.config.toml`) registering the server and launches with`--profile <slug>`. It controls the launch, so it can also inject per-sessioncredentials.@@ -711,8 +711,8 @@ fallback tier and costs minting, expiry, rotation and injection.It asks; it does not observe.-switchdash used to learn a session's room by watching: a `PostToolUse` hook-fired after `connect_to_room` succeeded and switchdash recorded the room in its+Switch Console used to learn a session's room by watching: a `PostToolUse` hook+fired after `connect_to_room` succeeded and Switch Console recorded the room in itsown map, persisted to SQLite. The hook was accurate — the flaw was the *copy*. Acopy drifts when the session dies, when the connection fails after the toolreturned, when the server restarts, or when the room is deleted.@@ -722,13 +722,13 @@ that is authoritative. A client reads it from the local runtime it spawned(same process as the connection) or from Switch. **The hook, the persistedsession→room blob, and the remote mirror all go away.**-*State of the migration.* switchdash now opens the stream itself and hands the-session `SWITCH_CONNECTION_ID`, so a switchdash-launched session claims its room-on a connection switchdash already holds — for Claude Code and for Codex alike.+*State of the migration.* Switch Console now opens the stream itself and hands the+session `SWITCH_CONNECTION_ID`, so a Switch Console-launched session claims its room+on a connection Switch Console already holds — for Claude Code and for Codex alike.The `PostToolUse` hook survives only as the fallback for a **Claude** session-switchdash did not start and adopted afterwards, which holds a connection of its+Switch Console did not start and adopted afterwards, which holds a connection of itsown. Codex registers no such hook. Since the Codex connector plugin now ships-the Switch MCP server, a Codex session switchdash did not start *can* call+the Switch MCP server, a Codex session Switch Console did not start *can* call`connect_to_room`; such a session is currently untracked rather than impossible.Cross-checking a room against incoming events becomes unnecessary: a@@ -867,7 +867,7 @@ three renews is unaffected and unaware.`AdminClient` and the bridge app — the Matrix clients are wired before thebridge, so the bridge could no longer own it.-5. switchdash (`RoomConnection` → session-grained connection that repoints+5. Switch Console (`RoomConnection` → session-grained connection that repointsrooms; daemon mode) and the sidecar, which reuses the same class verbatim —`sidecar-runtime.ts` constructs `RoomConnection` directly, so the two migratetogether rather than separately. The `auto_session` watcher'sdiff --git a/docs/bridges/DISCORD_SETUP.md b/docs/bridges/DISCORD_SETUP.mdindex 15f87a745..84db30fa7 100644--- a/docs/bridges/DISCORD_SETUP.md+++ b/docs/bridges/DISCORD_SETUP.md@@ -73,11 +73,11 @@ On success the bridge opens its Gateway WebSocket to that guild. Post in achannel the bot can see (or have an agent post) and the Switch room is created onthe first bridged message.-## Clickable "Open in SwitchDash" links (`GATEWAY_PUBLIC_URL`)+## Clickable "Open in Switch Console" links (`GATEWAY_PUBLIC_URL`)Discord only linkifies `http(s)`, so a raw `switchdash://session?…` deeplinkrenders as plain text. Set **`GATEWAY_PUBLIC_URL`** on switch-core to the Switch-API's public origin — scheme + host only, **no path** — the same host SwitchDash+API's public origin — scheme + host only, **no path** — the same host Switch Consolereports as its `server` (distinct from the operator UI):```dotenv@@ -100,7 +100,7 @@ routes the API root, not only `/gateway/*`.## Notes-- **Room icon.** SwitchDash shows a Discord icon for Discord-channel rooms+- **Room icon.** Switch Console shows a Discord icon for Discord-channel rooms(`discord.svg`, keyed to `bridge_type` `"discord"`).- **Outbound images.** Agents can relay images into Discord — the adapteruploads the bytes through the channel webhook under the agent's username/avatardiff --git a/docs/bridges/MATTERMOST_SETUP.md b/docs/bridges/MATTERMOST_SETUP.mdindex f542d9359..365a2480c 100644--- a/docs/bridges/MATTERMOST_SETUP.md+++ b/docs/bridges/MATTERMOST_SETUP.md@@ -69,4 +69,4 @@ don't onboard Mattermost by hand — it's already there after setup. Log in at- **DMs.** Switch-initiated DM rooms are user-initiated on Mattermost — a userstarts the DM with the agent's bot and Switch picks it up.- **Deeplinks.** Set `GATEWAY_PUBLIC_URL` on switch-core for clickable "Open in- SwitchDash" links (see the [index](README.md#deployment-knobs)).+ Switch Console" links (see the [index](README.md#deployment-knobs)).diff --git a/docs/bridges/README.md b/docs/bridges/README.mdindex 8068eaa0c..3aa431fbd 100644--- a/docs/bridges/README.md+++ b/docs/bridges/README.md@@ -49,7 +49,7 @@ the live set and the fields each one requires.- **Addressing agents.** Users `@mention` an agent by name in the channel toaddress it; unaddressed chatter is bridged as context. Bridge in-room commands(e.g. `!invite-agent`) and slash commands work per platform.-- **"Open in SwitchDash" links.** Agents surface a `switchdash://…` deeplink with+- **"Open in Switch Console" links.** Agents surface a `switchdash://…` deeplink withtheir runtime status. Platforms that only linkify `http(s)` (notably Discord)need `GATEWAY_PUBLIC_URL` set so Switch can rewrite it to a clickable`https://<switch-api-host>/deeplink/session?…` redirect. See the Discord guide.@@ -60,7 +60,7 @@ Most bridge configuration is per-bridge (in `connection_config`). A few thingsare deployment-level environment config on switch-core:- **`GATEWAY_PUBLIC_URL`** — the Switch API's public origin (scheme + host only,- no path): the same host SwitchDash reports as its `server`, and distinct from+ no path): the same host Switch Console reports as its `server`, and distinct fromthe operator UI. Used to build the clickable deeplink redirect, which is servedat `/deeplink/session` on the API root (the agent-bridge app), **not** under the`/gateway` mount — so front it with a proxy that routes the API root, not onlydiff --git a/docs/bridges/SLACK_SETUP.md b/docs/bridges/SLACK_SETUP.mdindex c2a9228e6..d75ac07b6 100644--- a/docs/bridges/SLACK_SETUP.md+++ b/docs/bridges/SLACK_SETUP.md@@ -201,7 +201,7 @@ manifest) so Switch's in-room commands work from Slack.## Notes-- **Deeplinks.** Slack linkifies `http(s)`, so "Open in SwitchDash" links work+- **Deeplinks.** Slack linkifies `http(s)`, so "Open in Switch Console" links workonce `GATEWAY_PUBLIC_URL` is set on switch-core (see the[index](README.md#deployment-knobs)); otherwise the raw `switchdash://` link isposted.