| Version | Status |
|---|---|
| 0.2.x | Active development, security patches |
| 0.1.x | Security patches only |
If you discover a security vulnerability in gwit, please report it responsibly:
- Do NOT open a public issue. Security vulnerabilities should not be disclosed publicly until a fix is available.
- Use GitHub Security Advisories. Go to the Security tab of this repository and click "Report a vulnerability."
- Alternatively, email the maintainer directly (see the repository profile).
- Description of the vulnerability
- Steps to reproduce
- Potential impact
- Suggested fix (if you have one)
- Acknowledgement: Within 48 hours
- Initial assessment: Within 1 week
- Fix and release: Best effort, typically within 2 weeks for critical issues
The following are considered security vulnerabilities in gwit:
- Shell injection via branch names, paths, or config values bypassing
runArgs()safety - Path traversal in
.gwitincludefile copying that escapes the worktree boundary - Environment variable leakage of
$GWIT_*values into unintended contexts - Registry corruption that could cause data loss or incorrect worktree state
- Privilege escalation through file permissions on
~/.gwitrcor~/.gwit/
The following are not in scope:
- Malicious commands in
.gwitcommand/.gwitcleanup(these are user-authored scripts; gwit's trust model matchesnpm installpostinstall scripts) - Issues requiring local filesystem access (gwit is a local CLI tool, not a network service)
For a detailed threat model and security controls, see docs/security.md.