Open Source
Contributing
Ways to help improve UsageNow, and where the contribution guide lives.
Contributions of every size help. The full guide — setup, code guidelines, and pull request expectations — is CONTRIBUTING.md in the repository. This page is a short overview.
Ways to contribute#
- Issues — ideas and questions, in GitHub Issues.
- Bug reports — include your UsageNow version and build (from Settings › About), your macOS version, and what you expected to see. Never include prompts, tokens, account details, or files from
~/.codexor~/.claude. - Provider integrations — support for a new tool starts with finding a reliable, privacy-respecting source of usage data. Open an issue to discuss it before writing code.
- Documentation — use Edit this page on GitHub at the bottom of any page to suggest a fix.
- Pull requests — keep each one focused on one change, with tests for non-UI logic and light and dark screenshots for UI changes.
Security issues#
Don’t report vulnerabilities in public issues. Follow SECURITY.md instead.
License of contributions#
By contributing, you agree that your contributions are licensed under the MIT License.