Get-Switch-Console link points at a path that only resolves via a redirect

Open Beginner friendly
#1,998 2 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

@Darshan3690 is already working on this.

Since Nov 15, 2026.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
85/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
python, typescript

Research direction

Start with the URL constant GET_SWITCH_CONSOLE_URL at line 137 of core/switch_core/deeplinks.py, and the same URL at line 15 of gateway/src/pages/templates/RunInConsoleDialog.tsx. Replace the old flintai/switch path with the switch-rooms/getting-started/install-switch-console path given in the issue, and update the old getting-started/switch-expert fixture in console/apps/switch-console-desktop/src/main/core/agent-templates/controller.test.ts. Done when no product file references the old namespace and the existing tests still pass.

Written by the indexing model from the issue text.

Description

What's wrong

Two places in the product link to docs.switchagents.ai/flintai/switch/..., a documentation path namespace that no longer exists:

  • core/switch_core/deeplinks.py:137 — GET_SWITCH_CONSOLE_URL, described in the code as "where someone without Switch Console is sent to get it"
  • gateway/src/pages/templates/RunInConsoleDialog.tsx:15 — the same URL

Both resolve today only because the documentation site carries a wildcard redirect, /flintai/switch/:slug* → /switch-rooms/:slug*.

Why it matters

GET_SWITCH_CONSOLE_URL is the install link shown to someone who does not have Switch Console yet. It works, so nothing has ever flagged it: no test fails, no link checker fires, no user sees a 404.

The risk is the redirect being removed as routine cleanup of the old namespace. Nothing on the documentation side indicates that a product link depends on it, so the install link would start 404ing for new users with no warning and no obvious cause.

Suggested fix

Point both at the current path:

https://docs.switchagents.ai/switch-rooms/getting-started/install-switch-console

A test fixture under console/apps/switch-console-desktop/src/main/core/agent-templates/controller.test.ts uses the old namespace too (for getting-started/switch-expert) and can be updated in passing.

Ordering

Land this before the wildcard redirect is removed, not after.

Dominant language
Python
Stars
4.5k
Forks
348
Avg merge
1d 17h
Merged PRs (30d)
287

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from sandbox-quantum/switch

All issues in sandbox-quantum/switch

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.