---
name: Bug report
about: Report something broken or surprising in CodeAlmanac
title: "bug: "
labels: bug
assignees: ""
---

## What happened?

Describe the behavior you saw.

## What did you expect?

Describe what you expected CodeAlmanac to do.

## Reproduction

```bash
# Paste the smallest command sequence that reproduces the issue.
```

## Environment

- OS:
- Python version:
- CodeAlmanac version:
- Install method: `uv tool`, `pip`, local checkout, or other
- Agent provider, if relevant: Codex, Claude, Cursor, or none
- Almanac root, if relevant: `almanac/`, `docs/almanac/`, `.almanac/`, or custom

## Logs or output

```text
Paste relevant output here.
```

## Extra context

Add anything else that might help explain the issue, such as whether the repo
already had a CodeAlmanac wiki or whether automation was enabled.
