Community
Community
archeus is a young project with a small user base. Bug reports are genuinely useful, especially from macOS and Linux, where there is less real-world use than on Windows.
Getting help
- Something is broken
- Open an issue. Include your platform, Python version, the archeus version and what you ran. If a screen faulted, the traceback matters more than the description.
- A question, or an idea
- Start a discussion. Ideas that begin as a discussion tend to arrive as better issues.
- It behaves oddly rather than failing
- The documentation site has a troubleshooting page covering the common causes — a Claude Code CLI that is not on PATH, an account whose config directory moved, and a GUI that opens in the browser because PyQt6 is not installed.
Contributing
Pull requests are welcome. The test suite is the contract: it is large, it is fast, and every gate in it exists because something broke once. If you change behaviour, the test that would have caught the old bug should fail before your fix and pass after it.
Code of conduct
The project follows the Contributor Covenant. It applies to the issue tracker, discussions and pull requests, and the full text is on this site.