> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lyzr.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Report an Issue

> How to file bug reports, feature requests, and security vulnerabilities.

## Before filing a bug

1. Search [existing issues](https://github.com/LyzrCore/langship/issues); it may already be reported or fixed
2. Check the [changelog](https://github.com/LyzrCore/langship/blob/main/CHANGELOG.md) to see if it was recently fixed in a version you haven't updated to
3. Try reproducing on the latest version: `pip install --upgrade gitagent` or `npm update -g @lyzr/langship`

## Which repo?

File the issue in the correct repository:

| Issue type                   | Repo                                                                           |
| ---------------------------- | ------------------------------------------------------------------------------ |
| Control Plane bug or feature | [LyzrCore/langship](https://github.com/LyzrCore/langship/issues/new)           |
| GitAgent bug or feature      | [open-gitagent/gitagent](https://github.com/open-gitagent/gitagent/issues/new) |
| OpenGAP feedback             | [open-gitagent/opengap](https://github.com/open-gitagent/opengap/issues/new)   |
| Docs issue                   | [LyzrCore/documentation](https://github.com/LyzrCore/documentation/issues/new) |

## What to include in a bug report

A good bug report has three things:

**1. What you did**\
The exact command or code you ran. Include the full command with all flags.

**2. What you expected**\
What the correct behavior should be.

**3. What happened instead**\
The full error output. Do not summarize; paste the raw output.

```
Environment:
  OS: macOS 14.2 / Ubuntu 22.04 / Windows 11
  Python / Node.js version: 3.11 / 20.11.0
  Package version: gitagent 0.8.0

Steps to reproduce:
  1. ...
  2. ...

Expected: ...
Actual: ...

Full error output:
  [paste here]
```

## Security vulnerabilities

**Do not file security issues publicly.**

Email **[security@lyzr.ai](mailto:security@lyzr.ai)** with:

* Description of the vulnerability
* Steps to reproduce
* Potential impact

We will respond within 48 hours and coordinate a fix and disclosure timeline with you.

## Feature requests

Use [GitHub Discussions](https://github.com/LyzrCore/langship/discussions) for feature requests rather than issues. Describe the problem you're trying to solve, not just the solution you have in mind; there may be a better approach.