DiffPal Docs

Choose the section that matches what you want to do.

Getting Started

Use Getting Started for the first successful review path. Start with the GitHub quickstart, then verify the expected summary, comments, artifacts, and gate behavior with Verify First Review. Continue with Next Steps after the first run works.

Concepts

Use Concepts to understand how DiffPal turns pull request diffs into structured findings and host-native feedback. The section also includes the comparison guide.

• How DiffPal works
• Review lifecycle
• Providers and agents
• Findings, feedback, and gates
• Glossary

Integrations

Use Integrations for CI setup and host-specific requirements:

• GitHub Actions
• GitLab CI
• Azure Pipelines
• Custom CI/CD

Providers

Use Providers to choose Codex, Copilot, OpenCode, or a custom ACP-compatible CLI:

• Codex
• Copilot
• OpenCode
• Custom ACP-compatible CLI

Guides

Use Guides for operational guidance that spans setup and reference material:

• Secrets and fork PRs
• Security controls

Reference

Use Reference for stable contracts:

• Configuration
• CLI
• Findings schema
• Artifacts
• Exit behavior
• Versioning
• Support matrix

Help

Use Help for operational fixes, including troubleshooting for missing comments, token failures, fork PRs, and incomplete diffs. Use the FAQ for short answers to common product, provider, CI, and artifact questions.

Examples

Use the examples gallery for copy-paste configs and CI files.