---
name: π Bug Report (Something's Not Right!)
about: Found a bug? Don't panic! Even Aye's code has occasional hiccups.
title: '[BUG] '
labels: 'bug, needs-triage'
assignees: ''
---
## π Bug Report - "Houston, We Have a Problem!"
*Thanks for taking the time to report this! Hue is already putting on their debugging hat, and Trisha is updating the bug tracking spreadsheet.*
### π Describe the Bug
*Give us the juicy details! What went wrong? Was it more catastrophic than Trisha's first attempt at using Git?*
A clear and concise description of what the bug is.
### π To Reproduce
*Help us recreate this digital disaster! Steps to make the bug happen again:*
1. Go to '...'
2. Run command '....'
3. Watch as things go sideways '....'
4. See error (cue dramatic music)
**Command used:**
```bash
st [your command here]
```
### π― Expected Behavior
*What did you expect to happen? What would make Trisha proud?*
A clear and concise description of what you expected to happen.
### π± Actual Behavior
*What actually happened? Did it explode? Did it show you the wrong directory tree? Did it somehow order pizza?*
A clear and concise description of what actually happened.
### π Sample Output
*If applicable, paste the output here. Don't worry, we've seen worse!*
```
[Paste any error messages or unexpected output here]
```
### π₯οΈ Environment (The Crime Scene)
*Help us understand your setup! Even Sherlock Holmes needed to know the details.*
- **OS:** [e.g. macOS 14.0, Ubuntu 22.04, Windows 11, or that old Linux box in the corner]
- **Smart Tree Version:** [run `st --version` or `st -V`]
- **Rust Version:** [run `rustc --version` if you built from source]
- **Terminal:** [e.g. iTerm2, Windows Terminal, that ancient terminal you refuse to upgrade]
- **Shell:** [e.g. zsh, bash, fish, or something exotic]
### π Directory Structure (If Relevant)
*If the bug is related to a specific directory structure, help us understand what you were trying to scan:*
- Directory size: [e.g. "small project", "monorepo from hell", "my entire home folder because why not"]
- Approximate file count: [e.g. 50 files, 10,000 files, "more files than Trisha has spreadsheets"]
- Any special files: [symlinks, very long filenames, files with emoji, cursed legacy code]
### π§ Additional Context
*Anything else that might help? Screenshots, interpretive dance videos, offerings to the debugging gods?*
- Did this work before? When did it break?
- Any error messages in your terminal?
- Were you doing anything unusual? (We don't judge)
- Is this reproducible or just happened once?
### π¨ Severity Level (Trisha's Scale)
*How bad is this bug? Rate it on Trisha's patented severity scale:*
- [ ] π **Paperwork Error** - Minor annoyance, like a typo in documentation
- [ ] β **Coffee Spill** - Inconvenient but workable, like when the coffee machine breaks
- [ ] π₯ **Fire Drill** - Significant problem, disrupts workflow
- [ ] π **Volcano** - Major issue, nothing works as expected
- [ ] π **End Times** - Critical bug, Smart Tree is unusable (call Hue immediately!)
### π·οΈ Bug Category (Help Us Sort This)
*What kind of bug is this?*
- [ ] π¨οΈ **Output formatting** - The tree looks wrong or ugly
- [ ] π **Performance** - It's slower than Trisha processing expense reports
- [ ] π₯ **Crash** - It exploded spectacularly
- [ ] π€ **Unexpected behavior** - It's doing something weird
- [ ] π± **Platform-specific** - Only happens on certain systems
- [ ] π¨ **Visual/Display** - Colors, emojis, or formatting issues
- [ ] π§ **CLI/Arguments** - Command line options not working
### π Bonus Points
*Want to be extra helpful? Any of these would make our day:*
- [ ] I've checked if this is already reported
- [ ] I've tested with the latest version
- [ ] I've included a minimal reproduction case
- [ ] I've included relevant log output
- [ ] I've sacrificed a rubber duck to the debugging gods
---
*Remember: Every bug report makes Smart Tree better! You're not just reporting a problem, you're contributing to making directory trees more beautiful for everyone. Trisha will personally thank you in the changelog!*
**Thanks for helping us improve Smart Tree!** π³β¨