---
name: 🐛 Bug Report
about: Report a bug or unexpected behavior
title: '[BUG] '
labels: bug
assignees: goharabbas321
---

## Description

A clear and concise description of the bug.

## Steps to Reproduce

1. Run `npx zeoel-framework init`
2. Open in [AI tool name]
3. Say "..."
4. See error

## Expected Behavior

What you expected to happen.

## Actual Behavior

What actually happened. Include error messages or logs if applicable.

## Environment

- **OS**: [e.g., macOS 15, Ubuntu 24.04, Windows 11]
- **AI Tool**: [e.g., Claude Code, Cursor, Gemini CLI, Copilot, Antigravity]
- **Zeoel Version**: [e.g., 2.0.1]
- **Node.js Version**: [e.g., 20.x]

## Screenshots / Logs

If applicable, add screenshots or paste relevant logs.

## Additional Context

Any other context about the problem.