diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
new file mode 100644
index 0000000..64587a3
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,32 @@
+---
+name: Bug Report
+about: Create a report to help us improve.
+title: 'bug: '
+labels: ['bug', 'triage']
+assignees: ''
+---
+
+## Description
+
+A clear and concise description of what the bug is.
+
+## Steps to Reproduce
+
+Steps to reproduce the behavior:
+1. Run CLI command '...'
+2. See error '...'
+
+## Expected Behavior
+
+A clear and concise description of what you expected to happen.
+
+## Environment Details
+
+* OS: [e.g. Ubuntu 22.04, macOS Sonoma]
+* Python Version: [e.g. 3.12.2]
+* Installation Method: [e.g. cli/install.sh, pip install -e cli/]
+* Active LLM Provider: [e.g. Gemini, OpenAI, Claude, Ollama]
+
+## Additional Context
+
+Add any other context or terminal log snippets about the problem here.