Project · Contributing

Contributing

OpenLegal is open source and built on verified claims. Contributions that add capabilities, tests, docs, or honest status reports are welcome — as long as they respect the privacy boundary and never fake a pass.

Where the work lives

The canonical repository is on GitHub (verified as the project’s configured git remote): github.com/M4G3LL4N0/obviouslybad. It is currently private while the public open-source release is prepared. Issues, pull requests, documentation, and the regression suite live there alongside the CLI, API, and extensions.

git clone https://github.com/M4G3LL4N0/obviouslybad.git openlegal cd openlegal

Privacy-first contribution rule

Never commit case data, credentials, provider keys, or private configuration. Real-matter artifacts must stay out of the repository and out of issues. Synthetic fixtures only.

How to contribute

SCOPE

Match the mission

Contributions must make OpenLegal more real, usable, reliable, or honest — or they probably do not belong.

TEST

Test-first, evidence-backed

Features ship with tests. Status claims in the capability matrix must be backed by verified runs — not aspiration.

PRIVACY

Stay on the safe side

No secrets, no case data, no private paths, no .env values — in code, docs, or issues.

REVIEW

Honest review

Reviewers verify the claims as well as the diff. Blocked or partial status stays blocked or partial until proven otherwise.

Verification you can run

pip install -e . --no-deps pytest tests/ # the canonical suite openlegal doctor # environment diagnostics openlegal health

Related

Status

Current verified state and limits.

Read

Roadmap

Upcoming work to pick up.

Read

Capabilities

The matrix your changes update.

Read