Skip to content

Security: JNHFlow21/agent-switch

SECURITY.md

Security Policy

Report a vulnerability

Please use GitHub private vulnerability reporting. Do not open a public issue containing a secret, credential, private path, or exploit detail.

Secret handling contract

  • Never commit ~/.config/agent-switch/secrets.env or copy it into a repository.
  • The repository ignores .env, *.env, secrets.env, and backups/, 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 NAME to write a value.
  • Use agent-switch secret list for audits; it returns names only.
  • Declare credential names on the MCP and keep their values out of the MCP's ordinary env mapping. 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.

Scope

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.

There aren't any published security advisories