Contributing

Contributions are welcome through issues and pull requests.

Report bugs

When reporting a bug, include:

  • your operating system,

  • your terminal emulator,

  • clear reproduction steps,

  • any relevant error output or screenshots.

Suggest enhancements

If you want to propose a feature or UX improvement, open an issue first so the approach can be discussed before implementation.

Pull request flow

  1. Fork the repository.

  2. Create a feature branch.

  3. Make the change and add tests when appropriate.

  4. Run the local checks.

  5. Open a pull request.

Design expectations

The project favors:

  • responsive terminal interactions,

  • cross-platform behavior,

  • polished TUI details such as search, previews, and feedback states.

For broader contribution guidance, see the repository root CONTRIBUTING.md.