AI Code Review with DeepSeek

Headless PR review automation that verifies PR descriptions claim-by-claim against real code, checks docs against reality, and flags requirement impact. Open source, runs locally.

View on GitHub Read the guides

PR descriptions lie. Docs go stale. Manual code review is slow and inconsistent. This tool runs a DeepSeek Harness agent that deep-dives into the actual code of every pull request and tells you whether the description matches reality — with file:line evidence for every claim.

The tool reviewing its own pull request. Each sentence of the description becomes a numbered claim with file:line evidence, and the header reports what it found rather than what the author claimed.

What it does

Code review — the changed code is read for defects: correctness, error handling, security, concurrency, resources, performance, missing tests. Each issue names a concrete failure scenario, a second agent confirms or rejects every Blocker / Major, and confirmed ones are posted inline on their lines
Claim verification — each sentence of the PR description is split into verifiable claims and checked against the real code: Matches / Partial / Mismatch / Unverified
Docs reality-check — repo docs are compared with actual code: Match / Stale / Wrong / Fabricated. Up to 60% of repo docs are wrong — this catches them
Requirement impact — which business requirements a change touches and whether it breaks anything: Changed / Broken / Risk
Human-in-the-loop — ≤20-word confirmation questions only when the agent cannot decide. It never guesses
Auto review poller — watches your repos, reviews every new PR and re-reviews when the diff changes. A rebase, a merge of the base branch or an amended message moves the head without changing a line, and costs nothing
Web dashboard — per-repo KPIs: bugs found, needs a look, doc errors, verdicts, review rounds

Guides

How to automate PR review with DeepSeekSet up a headless AI code review pipeline for your GitHub repos in 5 minutes Verify PR descriptions with an LLMSplit a PR description into verifiable claims and check each one against the code Detect stale and fabricated docs in your codebaseAutomatically compare repo documentation against real code — Match, Stale, Wrong or Fabricated

Quickstart

curl -fsSL https://raw.githubusercontent.com/nexpeakcore/deepseek-harness-pr-review/main/scripts/install.sh | bash
gh auth login
export DEEPSEEK_API_KEY=sk-...

harness-pr-review doctor                                  # check readiness
harness-pr-review https://github.com/owner/repo/pull/123  # review one PR
harness-pr-review owner/repo 123                          # or owner/repo + number
autoreview --daemon                                       # auto review every 2 min
harness-pr-review web                                   # dashboard at :6789