state-mcp: launch level switch to prohibit external backends; document env var effects

Open
#2,358 3 comments 0 reactions 0 assignees View on GitHub

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

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

squad squad:architect wave:2-soon

From enterprise integrator feedback (Teams, Oct 28): operators want local only operation to be explicit and fail closed.

Ask:

  1. A launch level switch (CLI flag and or .mcp.json arg, e.g. --no-external-backend) that makes squad state-mcp refuse to enable experimental backend tools even if SQUAD_EXPERIMENTAL_BACKEND / SQUAD_BACKEND_URL / SQUAD_BACKEND_TOKEN are inherited from the environment.
  2. Documentation of exactly how those env vars affect the bridge, and what doctor reports when a backend is configured.
  3. doctor warns 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

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 github/squad

All issues in github/squad

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.