Please use GitHub private vulnerability reporting. Do not open a public issue containing a secret, credential, private path, or exploit detail.
- Never commit
~/.config/agent-switch/secrets.envor copy it into a repository. - The repository ignores
.env,*.env,secrets.env, andbackups/, but ignore rules are only a last line of defense; credential values belong only in the Agent Switch private store. - Never include secret values in issues, screenshots, logs, or diagnostic output.
- Use the macOS app or
agent-switch secret set --stdin NAMEto write a value. - Use
agent-switch secret listfor audits; it returns names only. - Declare credential names on the MCP and keep their values out of the MCP's
ordinary
envmapping. Generated wrappers grant only declared names. - Pin package versions for MCPs launched through package runners such as
npx. - Rotate an affected provider credential immediately if exposure is suspected.
Security reports should cover Agent Switch itself: secret storage and transport, generated wrappers, MCP config projection, instruction management, the native macOS app, and CC Switch compatibility behavior.
Third-party MCP servers, CLI tools, Skill sources, and providers keep their own security boundaries. An MCP process can read the credentials explicitly granted to it; do not grant a credential to code whose source or package version you do not trust.