# Docs

https://shipcheck.run/docs/

Your agent runs its tests with `shipcheck run`, and that run gives the GitHub check its PR waits for. shipcheck starts the run itself: it runs your checks locally, natively in an OS sandbox or as your workflows in containers with act, keeps the result for each git tree, and posts one required check per job, such as `shipcheck/test`.

New here? [Install it](https://shipcheck.run/docs/install.md), then follow the [quickstart](https://shipcheck.run/docs/quickstart.md). It takes a few minutes for a repository owner and one command for each teammate. Once it works, [speed up runs](https://shipcheck.run/docs/speed.md).

Using a coding agent? [Agents](https://shipcheck.run/docs/agents.md) says what `init` writes for it, with any agent.

Deciding whether to trust it? [What a green check proves](https://shipcheck.run/docs/proof.md) and [Security](https://shipcheck.run/docs/security.md) say what a check guarantees and what a job can reach.