state-mcp: launch level switch to prohibit external backends; document env var effects
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 45/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- typescript
- Domain
- backend-api-design, cli, documentation
Research direction
Start at the squad state-mcp CLI entry point and trace how the three backend environment variables enable experimental tools; inspect the doctor command and its documentation. Add the launch switch, make doctor report configured variables and warn when the switch is set, then verify the bridge refuses external backends despite inherited variables and the docs describe each variable’s effect.
Written by the indexing model from the issue text.
Description
From enterprise integrator feedback (Teams, Oct 28): operators want local only operation to be explicit and fail closed.
Ask:
- A launch level switch (CLI flag and or
.mcp.jsonarg, e.g.--no-external-backend) that makessquad state-mcprefuse to enable experimental backend tools even ifSQUAD_EXPERIMENTAL_BACKEND/SQUAD_BACKEND_URL/SQUAD_BACKEND_TOKENare inherited from the environment. - Documentation of exactly how those env vars affect the bridge, and what
doctorreports when a backend is configured. doctorwarns when backend env vars are present but the switch is set.
Target: 2.0.0-preview.3. Related: backend wire contract review (preview.1 to dev) found no changes; this is a hardening add.
- Dominant language
- TypeScript
- Stars
- 3.4k
- Forks
- 516
- Avg merge
- 1d 15h
- Merged PRs (30d)
- 116
Getting set up
- Ships a 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 github/squad
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
Maintainers usually reply within 1 day
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 77/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Maintainers usually reply within 1 day
Similar issues
-
bot:ai-assisted component:platform-js status:untriaged
Difficulty 1/5 Under an hour Newbie friendliness 74/100
midnightntwrk/platform-js#38 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
ranxianglei/billion-context#7068 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
mybigday/whisper.rn#348 ·
-
enhancement severity:low
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
Battle-Cattle/BCUK-Bot-4#1075 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 67/100
ilan-pinto/roaring-lions#1552 ·
Maintainers usually reply within 1 day