| Version | Supported |
|---|---|
| 5.x | ✅ |
| 4.x | ✅ |
| < 4.0 | ❌ |
We take security seriously. If you discover a vulnerability, please follow these steps:
- Do not open a public issue
- Email the maintainer directly or use GitHub's private vulnerability reporting
- Include the following information:
- Type of vulnerability
- Full path of affected file(s)
- Steps to reproduce
- Potential impact
- Any suggested fix
You can report vulnerabilities through:
- Acknowledgment within 48 hours
- Initial assessment within 5 business days
- Regular updates on progress
- Credit in the security advisory (unless you prefer to remain anonymous)
We ask that you:
- Give us reasonable time to fix the issue before public disclosure
- Avoid accessing or modifying other users' data
- Do not degrade service quality during investigation
Thank you for helping keep this project secure.
Shadow Brain treats AI agent hooks and MCP servers as sensitive local automation.
postinstalldoes not modify project files unlessSHADOW_BRAIN_POSTINSTALL_SETUP=1is explicitly set.- Use
shadow-brain attach-all --dry-runbefore installing hooks. - Use
shadow-brain audit-hooksto inspect installed hook files. - Use
shadow-brain detach-allto remove Shadow Brain hooks without creating new ones. - Use
shadow-brain firewall checkorshadow-brain firewall hookto block secret access, destructive commands, curl-to-shell installs, and prompt-injection payloads. - For HTTP MCP mode, prefer
--auth-tokenorSHADOW_BRAIN_MCP_TOKEN.