Skip to content

Security: bymaxone/bymax-claude-code

SECURITY.md

Security Policy

πŸ›‘οΈ Reporting a vulnerability

If you discover a security vulnerability in this project β€” for example, a regex bypass in secret-scanner.sh, a command-injection vector in any hook script, or any way to exfiltrate user secrets β€” please do not open a public issue.

Email support@bymax.one with:

  • A clear description of the vulnerability.
  • Steps to reproduce.
  • The version (marketplace.json version field).
  • Optional: a suggested fix.

You will receive an acknowledgement within 48 hours. We will work with you on a fix and a coordinated disclosure timeline (typical: 30–90 days, depending on severity).


πŸ”’ What's in scope

  • All shipped slash commands, skills, agents, hooks, and templates.
  • Any way the toolkit could leak secrets, send unauthorized network requests, or write to unintended paths.
  • Pattern bypasses in secret-scanner.sh (false negatives that let credentials through).

πŸ“€ What's out of scope

  • Vulnerabilities in upstream tools (claude CLI itself, ESLint, Prettier, Husky, etc.) β€” please report those to their maintainers.
  • Vulnerabilities in vendor third-party skills under vendor/ β€” please report those to their original authors (links in vendor/*/ATTRIBUTION.md).
  • False positives in secret-scanner.sh (benign strings that match a credential pattern). These are usability bugs, not security bugs β€” open a normal issue.

πŸ”‘ Hardening guidance for users

When using this toolkit:

  1. Never paste credentials in chat β€” the secret-scanner.sh hook only catches Write/Edit/MultiEdit, not Bash. Use ~/.zshrc + macOS Keychain for tokens (see personal/README.md).
  2. Review the diff before approving any commit. Claude is asked to never auto-commit, but always verify.
  3. Audit vendor/ content before installing on a security-sensitive project β€” third-party scripts are MIT-licensed but you should still understand what they do.
  4. Keep the bymax-quality plugin enabled β€” it ships secret-scanner.sh as a PreToolUse hook via the plugin's own hooks/hooks.json (no manual wiring needed). Uninstalling or disabling the plugin removes the credential gate.

πŸ” What this toolkit does NOT do

  • Does not send any data to bymax.one or any third-party server.
  • Does not modify your global git config, credentials helper, or shell profile (except via opt-in scripts/install.sh steps that are clearly labeled).
  • Does not install npm packages globally without explicit user consent (the /bootstrap command proposes dev-deps but you confirm before install).
  • Does not include any analytics, telemetry, or auto-update mechanism.

Thank you for keeping the ecosystem safe. πŸ™

There aren't any published security advisories