---
name: Bug Report
about: Create a report to help us improve Xuanpu
title: '[BUG] '
labels: 'bug, needs-triage'
assignees: ''
---

## Bug Description
<!-- A clear and concise description of what the bug is -->

## Steps to Reproduce
<!-- Steps to reproduce the behavior -->
1. Go to '...'
2. Click on '...'
3. Scroll down to '...'
4. See error

## Expected Behavior
<!-- What you expected to happen -->

## Actual Behavior
<!-- What actually happened -->

## Screenshots
<!-- If applicable, add screenshots to help explain your problem -->

## Environment
<!-- Please complete the following information -->
- **OS**: macOS [e.g., 14.2 Sonoma]
- **Xuanpu Version**: [e.g., 1.0.54]
- **Node Version**: [e.g., 20.10.0]
- **Installation Method**: [Homebrew / Direct Download]

## Worktree/Project Details
<!-- If the bug is related to a specific git setup -->
- **Git Version**: [e.g., 2.43.0]
- **Number of Worktrees**: [e.g., 5]
- **Repository Size**: [Small/Medium/Large]

## AI Session Details
<!-- If the bug occurred during an AI session -->
- **AI Provider**: [OpenCode / Claude Code]
- **Session Type**: [New / Resumed]
- **Tools Used**: [e.g., file operations, terminal commands]

## Error Messages
<!-- If you see any error messages, please include them here -->
```
Paste any error messages here
```

## Logs
<!-- Check ~/Library/Logs/xuanpu/ for log files -->
<details>
<summary>Log Output</summary>

```
Paste relevant log entries here
```

</details>

## Additional Context
<!-- Add any other context about the problem here -->

## Possible Solution
<!-- If you have an idea of how to fix this, please share! -->

---
<!-- Thank you for taking the time to report this issue! -->