Contributing
Guide to contributing platform support, posture checks, and fixes to the open-source Probo Agent, including source paths and the security review process.
The official Probo Agent is open source. Contributions that improve platform support, posture checks, packaging, or documentation are welcome.
Source code
Section titled “Source code”The agent lives in the getprobo/probo repository:
| Path | Role |
|---|---|
cmd/probo-agent |
CLI, installers, service integration |
pkg/deviceagent |
Enrollment client, heartbeat, check logic |
Read the repository CONTRIBUTING.md for the full development setup before opening a pull request.
What to contribute
Section titled “What to contribute”Good fit for the official agent:
- Support for additional operating systems, distributions, or architectures
- Platform-specific fixes for existing posture checks
- Packaging, install, or auto-update improvements that preserve the security model
- Documentation and test coverage
If you need an agent for an environment the official binary will not cover soon, you can also implement the Device Agent API yourself. That path does not require merging into the official agent.
Security review timeline
Section titled “Security review timeline”Plan for iteration. We may ask for smaller diffs, additional tests, or design changes that keep the agent a posture reporter rather than remote control software. Thank you for the patience; the review protects users who install the official agent.
Platforms we test today
Section titled “Platforms we test today”Our end-to-end environment currently covers:
- FreeBSD
- Linux
- Windows on AMD64
- macOS on Apple silicon (M series)
Windows on ARM is planned but is not yet part of that environment. Contributions that add or harden coverage for additional platforms are especially useful.