---
name: Bug Report
about: Create a report to help us improve
title: '[BUG] '
labels: 'bug'
assignees: ''
---
## Bug Description
A clear and concise description of what the bug is.
## Steps To Reproduce
1. Go to '...'
2. Run command '...'
3. See error
## Expected Behavior
A clear and concise description of what you expected to happen.
## Actual Behavior
What actually happened instead.
## Environment
- **OS**: [e.g., macOS 14.0, Ubuntu 22.04, Windows 11]
- **Node.js version**: [e.g., 18.17.0]
- **Package version**: [e.g., 1.0.0-beta.2]
- **Installation method**: [e.g., npm install -g, npx, local development]
## Configuration
<!-- If relevant, share your configuration (remove sensitive data) -->
**Claude Desktop config** (if using with Claude):
```json
{
"mcpServers": {
"hummbl": {
"command": "...",
"args": ["..."]
}
}
}
```
## Error Logs
<!-- Include any error messages, stack traces, or relevant log output -->
```
Paste error logs here
```
## Screenshots
<!-- If applicable, add screenshots to help explain your problem -->
## Additional Context
<!-- Add any other context about the problem here -->
## Possible Solution
<!-- Optional: Suggest a fix/reason for the bug -->
## Checklist
- [ ] I have searched existing issues to ensure this is not a duplicate
- [ ] I have included all relevant information above
- [ ] I am using the latest version of the package
- [ ] I have read the [troubleshooting guide](../TROUBLESHOOTING.md)