Truecount

In development: not installable yet

Find what your tests would let through.

Truecount is a GitHub App for pull request review and repository audits. It breaks your changed code on purpose to see whether your tests notice, checks your docs against your code, and reviews pull requests against the guidelines you already wrote.

What a finding looks like

The tests caught 62 of 80 deliberate breaks in the changed lines.

Not caught
- truecount/admin.py:54       not rows → rows                 (remove not)
- truecount/retention.py:75   conn.execute('ROLLBACK') → pass (remove call)
- truecount/settings.py:100   return int(raw) → return None   (return None)

From Truecount's own repository, the day the check was built. Each line is a change the test suite would have accepted. The missing tests were written, and the next run caught 93 of 102. Some breaks change nothing observable, so a survivor is a lead to check, not a verdict.

The agents

AgentRuns whenRuns onCan change
Pull request reviewA collaborator opens a pull request, or a maintainer asksTruecount (reads the diff)Nothing; it comments
Mutation checkOn pull requests (Python)Your Actions runnerNothing; it reports
Docs auditWeekly, skipped if the code has not changedYour Actions runnerMarkdown and docs/, through a pull request
Code healthWeekly, skipped if the code has not changedTruecount reports; your runner fixesOne fix per run, through a pull request
Bug reproductionYou label an issueYour Actions runnerNothing; it comments with what it ran

Configure it

# .github/truecount.yml, read from your default branch
review:
  enabled: true
  guidelines: .github/review-guidelines.md
ignore:
  - "docs/generated/**"

Ask for a review with a /truecount review comment or the truecount-review label. The config is read from the branch a pull request targets, so a pull request cannot change how it is reviewed.

Guarantees

Plans

PlanForIncludes
FreePublic repositoriesPull request review, docs audit and code health, with a monthly run allowance
IndividualPersonal accountsPrivate repositories and every agent, with a generous run allowance
TeamOrganizationsPrivate repositories and every agent, with an allowance sized for a team
EnterpriseLarge organizationsRuns on your own model endpoint, under an annual license

A run is one review or one audit. Runs past your allowance wait for spare capacity instead of failing, and top-ups are available. Prices and allowances will be published before launch.