Get-Switch-Console link points at a path that only resolves via a redirect
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
- Domain
- backend, documentation, frontend
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
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from sandbox-quantum/switch
-
Console writes URL credentials to the local log, though AGENTS.md says secrets never reach diskOpen
Difficulty 1/5 Under an hour Newbie friendliness 86/100
sandbox-quantum/switch#2163 ·
Maintainers usually reply within 1 day
-
Difficulty 1/5 Under an hour Newbie friendliness 85/100
sandbox-quantum/switch#2162 ·
Maintainers usually reply within 1 day
-
Difficulty 1/5 Under an hour Newbie friendliness 85/100
sandbox-quantum/switch#2159 · 1 comment ·
Maintainers usually reply within 1 day
-
Difficulty 1/5 Under an hour Newbie friendliness 85/100
sandbox-quantum/switch#2157 ·
Maintainers usually reply within 1 day
-
A session's age is not surfaced, so you cannot tell how old an agent's context isPossibly taken A pull request linked to this issue is open or already merged. Openenhancement
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
sandbox-quantum/switch#1993 ·
Maintainers usually reply within 1 day
All issues in sandbox-quantum/switch
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
mohanraj00/entelos#200 ·
Maintainers usually reply within 1 day
-
Difficulty 1/5 Under an hour Newbie friendliness 68/100
-
sweep
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
bketelsen/truenas-mcp#77 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
openedx/xblock-lti-consumer#765 ·
Maintainers usually reply within 1 day
-
bug pydanty:is-working
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
pydantic/pydantic-ai#13939 ·
Maintainers usually reply within 1 day