Self-host pr-agent
v0.50.0AI pull-request reviewer that runs from comments, CI or CLI
$ docker run --rm -it -e OPENAI__KEY=<your_openai_key> -e GITHUB__USER_TOKEN=<your_github_token> pragent/pr-agent:latest --pr_url <pr_url> review- Stars
- 15 667
- Port
- 3000 (Port the self-hosted webhook server (gunicorn) binds to)
pragent/pr-agentWhat is pr-agent?
PR-Agent is an AI coding assistant that gives automated pull-request feedback to development teams. Deployed as a git-provider app, webhook receiver, CI job or CLI tool, it writes PR titles and summaries, produces structured reviews that flag likely problems, security risks and missing tests, and posts code suggestions authors can apply. Extra commands answer free-text questions about a diff, add missing documentation, generate custom labels, keep the CHANGELOG current, and surface related issues in the same repo. It supports GitHub, GitLab, Bitbucket, Gitea, Azure DevOps, and also Gerrit and CodeCommit, and can drive models from OpenAI, Anthropic, Google, DeepSeek or Mistral, plus anything LiteLLM exposes (Azure OpenAI, Bedrock, Vertex AI, Ollama and more). Run it yourself with the pragent/pr-agent Docker image, a pip package, a GitHub Actions step, or a self-hosted webhook server that binds port 3000 by default; with your own API key, code traffic stays strictly between you and the model provider. Qodo donated the project to the community and it is MIT-licensed, though /help_docs has been disabled since v0.36.1 while a credential-exposure bug is fixed.
pr-agent alternatives
GitWitGitWit is a self-hosted, open-source AI coding platform with a browser-based IDE, live preview, AI chat, and support for Anthropic, OpenAI, and AWS Bedrock.CompareGitWit with pr-agent
OgcodeSelf-hosted, open-source AI coding agent that maps codebases, recalls decisions across sessions, and runs locally with any model provider including Ollama.CompareOgcode with pr-agent
superplaneAn open-source AI software factory that turns routine backlog items into review-ready pull requests. Self-host with Docker on a VM, or Terraform on Kubernetes.Comparesuperplane with pr-agent
openhandsSelf-hosted AI agent platform running autonomous coding agents on local, remote, and cloud backends with integrations for Slack, GitHub, Jira, and Linear.Compareopenhands with pr-agent
agentlogsSelf-hosted platform capturing AI coding agent transcripts (Claude Code, Codex, OpenCode, Pi, Cline) with git commit linking, team dashboards, and secret redaction.Compareagentlogs with pr-agent
QA-PilotQA-Pilot is a self-hosted, open-source chat app that helps developers understand GitHub code repositories using local or cloud LLMs with code graph visualization.CompareQA-Pilot with pr-agent
CodinIT.devSelf-hosted open-source AI full-stack dev platform for building Node.js apps with code generation and 19+ AI providers.CompareCodinIT.dev with pr-agent
SourcebotSelf-hosted code search, symbol navigation and AI Q&A spanning every repository you index, with an MCP server that supplies coding agents full codebase context.CompareSourcebot with pr-agent
Should you self-host pr-agent?
pr-agent scores 84/100 on selfhost.directory (how scoring works) and ranks #1 of 10 in Code Review. It has 15 667 GitHub stars, +2 393 in the last 30 days.
It shipped 24 stable releases in the past year. The latest, v0.50.0, came out on 7 November 2026. New versions land roughly every 9 days.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Python.
Its closest alternative on selfhost.directory is SonarQube (71/100, 11 165 stars). pr-agent scores higher overall. See pr-agent vs SonarQube side by side.
Features
- Agent skills support
- AI pull-request review
- Ask questions about a PR
- Automatic feedback on PR events
- Changelog updates
- Code improvement suggestions
- Configurable review behavior
- Documentation generation
- Label generation
- Large PR handling
- Multiple AI model support
- PR description generation
- Repo context files
- Similar issue detection
pr-agent README
This repository contains the open-source PR Agent Project. It is not the Qodo offering for open-source projects.
PR-Agent is an open-source, AI-powered code review agent and a community-maintained legacy project of Qodo. It is distinct from Qodo's primary AI code review offering, which provides a feature-rich, context-aware experience. Qodo offers a free version for open-source projects and integrates seamlessly with GitHub, GitLab, Bitbucket, and Azure DevOps for high-quality automated reviews.
How to install pr-agent
Install pr-agent with Docker
docker run --rm -it -e OPENAI__KEY=<your_openai_key> -e GITHUB__USER_TOKEN=<your_github_token> pragent/pr-agent:latest --pr_url <pr_url> review
Provider-specific variants (GitLab, BitBucket, Gitea, Azure DevOps) use CONFIG__GIT_PROVIDER plus the provider's token variables; self-hosted webhook server targets also exist.
Install pr-agent with pip
OPENAI_KEYpip install "pr-agent[github]"
export OPENAI_KEY=your_key_here
pr-agent --pr_url https://github.com/owner/repo/pull/123 review
Git provider SDKs are optional extras (github, gitlab, bitbucket, azure, codecommit, gitea), or pr-agent[all] for every integration.
How to configure pr-agent
OPENAI_KEYOpenAI API key used by the GitHub Action / CLI quick start.GITHUB_TOKENGitHub token used by the GitHub Action workflow.model=gpt-5.6Main LLM model used by the tools (configuration.toml [config]).publish_output=trueWhether tool results are published as PR comments (false prints locally).values: true, false
GUNICORN_WORKERS=(unset)Pins the worker count exactly. Overrides the derived count and GUNICORN_MAX_WORKERS.
pr-agent releases & version history
AI summary Removed host-only settings and comment arguments
⚠️ Breaking changes and upgrade notes
- Host-only settings: Repository
.pr_agent.tomlfiles can no longer override GitHub pacing and retry settings (github.seconds_between_requests,github.seconds_between_writes,github.api_retries,github.ratelimit_retries),config.num_retries,azure_devops_server.agent_identity, custom-label settings (config.enable_custom_labelsand[custom_labels]), orpr_code_suggestions.max_number_of_calls.config.num_retriesis capped at 10. Per-directory.pr_agent.tomlfiles also cannot setpr_code_suggestions.dual_publishing_score_threshold. Move values you rely on to host configuration. (#4445, #4475, #4485, #4632, #4745) - Comment arguments:
config.ai_timeoutandpr_code_suggestions.max_number_of_callscan no longer be set through command comments. (#4445) - Removed no-op settings:
pr_code_suggestions.approve_pr_on_self_reviewandpr_code_suggestions.fold_suggestions_on_self_revieware removed from the shipped configuration. PR-Agent warns if they remain set; they never changed/improvebehavior. (#4598) - Custom provider integrations: Unused provider methods and capability names were removed. Review #4691 if a custom provider calls those internal methods.
- Auto-approval:
config.enable_auto_approvalis now host-only. The auto-approval path remains disabled in this release. (#4700)
🔐 Trusted Publishing
PyPI releases now use PyPI Trusted Publishing through GitHub Actions OIDC and produce package attestations. The release workflow rejects commits that are not reachable from main. (#3909)
🚀 Features
- feat(push_outputs): select tools and deliver Ask answers by @PeterDaveHello in #4739
- feat(cli): enable JSON output for plain-diff describe and improve by @PeterDaveHello in #4730
- feat(i18n): localize improve summaries and empty states by @PeterDaveHello in #4731
- feat(config): add protected host system instructions by @Evhye38496 in #4716
- feat(i18n): translate the fixed text of the /review comment into response_language by @AdelFetner in #4684
- feat: add Microsoft Teams output sink by @utsab345 in #4630
- feat(repo-context): expand @path imports by @utsab345 in #4620
- feat(review): include commit messages in /review and /improve prompts by @abhiramshaji-cyber in #4603
- feat(scripts): link config reference sections to their docs pages by @mirzasnowy in #4596
- feat(doctor): check configured output destinations by @oleksii-tumanov in #4541
- feat(config): identify keys absent from shipped declarations by @oleksii-tumanov in #4505
- feat(litellm): add per-PR session ids by @utsab345 in #4503
- feat(models): support Kimi K3 / K3.1 Pro and bypass temperature parameter by @JI4JUN in #4515
- feat(review): add an opt-in deterministic structural-reach row by @moinerus in #4421
- feat: support Amazon Bedrock guardrails on the Converse route by @luisrviz in #4420
- feat: configure improve failure comments by @utsab345 in #4426
- feat(models): add Claude Sonnet 5.5 and Haiku 5.5 support by @montss in #4360
- feat(model-routing): support a patch character limit by @oleksii-tumanov in #4376
- feat(github-action): stop the runner on a failed key check by @Yoel-qin in #4325
🐛 Bug Fixes
-
[Bug] Prefetch review diff outside the event loop by @askarshabdanov1-collab in #4403
-
fix(ci): Restrict releases to main and attest PyPI packages by @oleksii-tumanov in #3909
-
fix(config): keep dual_publishing_score_threshold out of per-directory settings by @shu-chen-dot-ca in #4745
-
fix(gitea): build file links for AGit-flow PRs from the head SHA by @Yi-111-a in #4744
-
fix(plain-diff): strip terminal controls from Markdown output by @jiangjiang248 in #4738
-
fix(github): keep suggestions just outside a hunk instead of dropping them by @ylcn91 in #4734
-
fix(servers): parse string-valued boolean settings in webhook servers by @ylcn91 in #4735
-
fix: pin auto-approval to the reviewed head and make enable_auto_approval host-only by @wanjinhao1 in #4700
-
fix(improve): reuse persistent summaries when history is disabled by @PeterDaveHello in #4717
-
fix(servers): honor disabled string-valued push triggers by @PeterDaveHello in #4720
-
fix(output): preserve stdout JSON on restricted encodings by @PeterDaveHello in #4719
-
fix(doctor): keep the report when stdout cannot encode it by @Bortlesboat in #4714
-
fix(security): reject host-only and forbidden keys written with whitespace around the section dot by @Yi-111-a in #4686
-
fix(push_outputs): require exact channel names by @PeterDaveHello in #4705
-
fix(gitlab): ignore unified-diff file headers in per-file line counts by @zhengqiuyang in #4651
-
fix(github): support GitHub Enterprise Cloud data residency (*.ghe.com) by @alexjansons in #4688
-
fix(providers): build help_docs links from the whole repo URL by @Xch4rt in #4687
-
fix(review): preserve distinct ticket identities across chunks by @rudycelekli in #4662
-
fix(improve): preserve literal data in already aligned replacements by @rudycelekli in #4674
-
fix(diff): keep negative context settings from corrupting hunk counts by @rudycelekli in #4680
-
fix(usage): reject negative and boolean token counts by @rudycelekli in #4664
-
fix(describe): retain files when unused optional summaries are malformed by @rudycelekli in #4676
-
fix(improve): retain suggestions with quoted or unusable length caps by @rudycelekli in #4681
-
fix(add_docs): validate model anchors and placement before insertion by @rudycelekli in #4677
-
fix(doctor): align endpoint and key checks with model routing by @PeterDaveHello in #4570
-
fix(bitbucket): preserve significant spaces in rename paths by @rudycelekli in #4682
-
fix(action): write Unicode outputs using UTF-8 by @rudycelekli in #4663
-
fix(diff): preserve Git line boundaries in supplied diff parsing by @rudycelekli in #4668
-
fix(azure): preserve physical lines in suggestion ranges and reconciliation by @rudycelekli in #4672
-
fix(azure): keep the suggestion fence in inline /improve threads by @Chebaleomkar in #4659
-
fix(review): keep invalid chunk scores out of conservative reduction by @rudycelekli in #4669
-
fix(routing): skip overflowing model limits by @rudycelekli in #4667
-
fix: keep an unpaired backtick literal in replace_code_tags by @kevin9327 in #4679
-
fix(tickets): offload blocking ticket reads by @PeterDaveHello in #4658
-
fix(action): skip duplicate first-open review requests by @Aschenbath in #4654
-
fix(bitbucket): decode raw file contents as UTF-8 by @tanishqbaweja in #4648
-
fix(describe): strip whitespace from type items before schema validation by @mirzasnowy in #4647
-
fix: scope response language instructions to each command by @PeterDaveHello in #4645
-
fix(jira): accept Jira Cloud project keys that contain digits by @tanishqbaweja in #4646
-
fix: retry truncated responses before publishing tool results by @PeterDaveHello in #4640
-
fix(diff): preserve complete filenames in compressed metadata by @PeterDaveHello in #4639
-
fix(azure): preserve encoded PR names in published links by @Aschenbath in #4637
-
fix(labels): remove labels left out of the set on Gitea by @tanishqbaweja in #4628
-
fix: protect custom labels from repo overrides by @utsab345 in #4632
-
fix(gerrit): keep credentials out of child arguments by @utsab345 in #4569
-
fix(labels): remove labels left out of the set on Azure DevOps by @tanishqbaweja in #4618
-
fix: deprecate no-op self-review marker keys by @utsab345 in #4598
-
fix(azure): resolve agent identity for persistent reviews by @dellch in #4613
-
fix: align config comments and large patch fallback by @utsab345 in #4593
-
fix(bitbucket-server): find the projects/users segment by its position in the PR URL by @tanishqbaweja in #4563
-
fix(github-action): allow static commands without model keys by @PeterDaveHello in #4583
-
fix(structural-reach): preserve imports for blobs shared across languages by @oleksii-tumanov in #4579
-
fix(improve): retry truncated suggestion responses by @PeterDaveHello in #4582
-
fix(ci): preserve the test image cache after smoke builds by @PeterDaveHello in #4610
-
fix: exclude NuGet and Swift lockfiles from analysis by @PeterDaveHello in #4608
-
fix: include Gradle build scripts in default analysis by @PeterDaveHello in #4600
-
fix: align config comments and gitlab bot log by @utsab345 in #4592
-
fix(ask): keep inline diff reads off the event loop by @PeterDaveHello in #4601
-
fix: match patch_extension_skip_types regardless of case by @RagedPanda in #4605
-
fix(improve): preserve const-to-let reassignment suggestions by @PeterDaveHello in #4607
-
fix(gitlab): skip webhook events from ignored user IDs by @sarankumar1325 in #4562
-
fix: filter generated suffixes regardless of case by @oleksii-tumanov in #4572
-
fix(plain-diff): preserve the default title in describe output by @PeterDaveHello in #4571
-
fix(gitlab): handle single-line /ask diff notes by @PeterDaveHello in #4568
-
fix(describe): tolerate mixed category list values by @PeterDaveHello in #4578
-
fix(tools): remove unmatched closing rows from HTML tables by @PeterDaveHello in #4576
-
fix(polling): preserve queued work when marking another notification fails by @PeterDaveHello in #4567
-
fix(improve): honor publish_output when reconciling suggestion threads by @PeterDaveHello in #4566
-
fix(yaml): preserve reviews with unicode separators by @awais-ur-rehman in #4555
-
fix: ignore bot push commits in github app by @utsab345 in #4558
-
fix: align suggestions score threshold default by @utsab345 in #4559
-
fix(review): retry truncated model completions before publishing by @PeterDaveHello in #4533
-
fix(providers): validate suggestion line ranges in Gerrit, Gitea and CodeCommit by @TheNetherWatcher in #4520
-
fix(github-action): fail when the required GitHub token missing by @PeterDaveHello in #4544
-
fix(review): render split themes without GFM by @oleksii-tumanov in #4542
-
fix: clarify unresolved token limits and guard model budgets by @PeterDaveHello in #4539
-
fix(polling): preserve command text after repeated bot mentions by @PeterDaveHello in #4540
-
fix(doctor): apply the ambient-auth exemption to the doctor key check by @Kiddo4993 in #4536
-
fix(ignore): drop a non-list ignore setting instead of disabling every rule by @RagedPanda in #4510
-
fix(review): drop look-alike structural_reach keys and skip malformed tsconfig files by @RagedPanda in #4522
-
fix(gitlab): request max page size for full lists by @utsab345 in #4517
-
fix(add_docs): keep local failures out of review.md by @utsab345 in #4516
-
fix(providers): classify GitLab and Gitea URLs by path segment by @RagedPanda in #4509
-
fix(providers): include filtered filenames in local review context by @oleksii-tumanov in #4504
-
fix(labels): report label read and publication failures by @oleksii-tumanov in #4502
-
fix(github): avoid rebuilding diffs from failed content reads by @PeterDaveHello in #4473
-
fix(providers): share LF-based diff line counting by @PeterDaveHello in #4489
-
fix(deps): Replace deprecated Uvicorn workers in Gunicorn service images by @PeterDaveHello in #4491
-
fix(bitbucket): reject invalid diffstat line counts by @PeterDaveHello in #4490
-
fix(github): classify issue and pull request URLs by path by @PeterDaveHello in #4486
-
fix(similar_issue): stop embedding fallback on access errors by @PeterDaveHello in #4497
-
fix(improve): match const and let as whole words by @PeterDaveHello in #4499
-
fix(azure_devops): make azure_devops_server.agent_identity host-only by @itsvrushabh in #4485
-
fix: keep valid ignore rules when a pattern has the wrong type by @Aschenbath in #4484
-
fix(servers): disable_auto_feedback stops push and review commands too by @MilkteaTW1 in #4461
-
fix(local): stop failed /improve and /describe from overwriting review.md by @YokoAC in #4483
-
fix: move describe and improve diff fetch off event loop by @utsab345 in #4462
-
fix: cap config.num_retries and keep host only by @utsab345 in #4475
-
fix(improve): only update comments authored by the agent by @Aschenbath in #4330
-
fix(deps): Update certifi to 2026.10.23 to drop distrusted roots by @PeterDaveHello in #4478
-
fix(packaging): honor the declared uv version requirement by @PeterDaveHello in #4474
-
fix(telemetry): mark recorded tool errors as command span errors by @PeterDaveHello in #4477
-
fix(describe): preserve large PR file walkthrough format by @PeterDaveHello in #4432
-
fix(github-action): honor PR ignore policy for automatic tools by @PeterDaveHello in #4471
-
fix(describe): use provider head SHA in marker headers by @PeterDaveHello in #4467
-
fix(improve): preserve Git line boundaries in code suggestions by @PeterDaveHello in #4472
-
fix: merge section-level comment args into the section instead of replacing it by @mirzasnowy in #4458
-
fix(settings): declare the Bitbucket push settings and document the Server switch by @MilkteaTW1 in #4457
-
fix(settings): declare app_key under [bitbucket] in secrets template by @vishalkaay in #4459
-
fix: use model_dump in prepare_logs to avoid pydantic dict deprecation by @mirzasnowy in #4456
-
fix: load tiktoken files bundled with LiteLLM so token counting works… by @luisrviz in #4423
-
fix(similar_issue): migrate deprecated Pydantic Config to ConfigDict by @itsvrushabh in #4447
-
fix(security): make pacing and retry settings host-only by @utsab345 in #4445
-
fix(litellm): make the handler the only retry layer by @dodoshell in #4425
-
fix: publish empty improve results in GitHub workflow by @ofir-frd in #4442
-
fix(config): share boolean parsing across command entry points by @PeterDaveHello in #4438
-
fix(similar_issue): enforce embedding model token limits by @PeterDaveHello in #4437
-
fix(gitlab): record the head used by the reviewed diff by @PeterDaveHello in #4431
-
fix(add-docs): preserve Git line numbers in source anchors by @PeterDaveHello in #4435
-
fix: enforce tiny skills token budgets by @utsab345 in #4415
-
fix(improve): handle quoted integer impact thresholds by @PeterDaveHello in #4399
-
fix(gitlab): publish validated suggestions from patch-only files by @PeterDaveHello in #4428
-
fix: only use static AWS fallback for auth errors by @pei711 in #4414
-
fix(gerrit): preserve commit-message Jira context by @oleksii-tumanov in #4416
-
fix(improve): retry malformed suggestion responses with fallback models by @PeterDaveHello in #4408
-
fix(github-action): skip ignored comments before repo setup by @PeterDaveHello in #4406
-
fix(describe): preserve title and labels in structured outputs by @PeterDaveHello in #4405
-
fix(describe): retain fallback entries in file walkthroughs by @PeterDaveHello in #4402
-
fix(add-docs): skip suggestions without the original source line by @PeterDaveHello in #4401
-
fix(diff): exclude metadata from inline comment anchors by @PeterDaveHello in #4398
-
fix: skip GitHub merge commits in incremental reviews by @utsab345 in #4371
-
fix(providers): reset the whole diff state between auto commands by @Yoel-qin in #4373
-
fix(improve): retry unusable self-reflection feedback by @PeterDaveHello in #4377
-
fix(improve): don't state identifiers that aren't visible in the diff as fact by @ira-at-work in #4223
-
fix: reject invalid webhook body sizes by @utsab345 in #4388
-
fix(telemetry): isolate direct Prometheus runs by @oleksii-tumanov in #4380
-
fix(review): preserve prose TODO findings across chunks by @PeterDaveHello in #4384
-
fix(review): include commit context in contribution-time estimates by @oleksii-tumanov in #4381
-
fix(describe): handle nullable description output by @PeterDaveHello in #4382
-
fix(review): retain partial compliance in ticket summaries by @PeterDaveHello in #4383
-
fix(review): preserve effort labels without a valid replacement by @PeterDaveHello in #4378
-
fix(help): retry unusable structured answers with fallback models by @PeterDaveHello in #4365
-
fix: preserve quoted headers in user descriptions by @oleksii-tumanov in #4358
⚡ Performance
- perf(ask_line): offload review history reads by @PeterDaveHello in #4728
- perf(gitlab): batch verified MR file content reads by @PeterDaveHello in #4718
- perf(review): keep diff preparation off the event loop by @PeterDaveHello in #4721
- perf(gitlab): skip redundant notes reads in inline deduplication by @PeterDaveHello in #4661
- perf(github-action): reuse provider across commands with fresh PR state by @PeterDaveHello in #4580
- perf(github): prefetch diff file contents via GraphQL with REST fallback by @PeterDaveHello in #4581
- perf(github): avoid duplicate comment reads for short threads by @PeterDaveHello in #4602
- perf(providers): reuse latest commit URLs within a command by @PeterDaveHello in #4577
- perf(tools): reuse request-scoped providers in manual commands by @PeterDaveHello in #4430
- perf(tools): remove unused initial token handlers by @PeterDaveHello in #4545
- perf(tools): keep manual diff preparation off the event loop by @PeterDaveHello in #4538
- perf(tickets): skip sub-issue queries for known-empty issues by @PeterDaveHello in #4537
- perf(review): split only the requested source excerpt by @PeterDaveHello in #4498
- perf(models): skip tokenizing uncached user prompts by @PeterDaveHello in #4494
- perf(improve): count file lines without allocating split strings by @PeterDaveHello in #4493
- perf(github): reuse repository objects for differently cased URLs by @PeterDaveHello in #4492
- perf(similar_issue): stop fetching comments after the selected match by @PeterDaveHello in #4488
- perf(gitlab): fetch merge request comments in larger pages by @PeterDaveHello in #4487
- perf(tools): remove unused TokenHandler setup from four commands by @PeterDaveHello in #4496
- perf(docker): preserve dependencies across docs changes by @PeterDaveHello in #4469
- perf(tests): skip files without referenced names by @PeterDaveHello in #4468
- perf(tickets): skip redundant empty-ticket budget evaluation by @PeterDaveHello in #4434
- perf(diff): avoid splitting unused head file tails by @PeterDaveHello in #4439
- perf(improve): avoid repeatedly serializing suggestion thread context by @PeterDaveHello in #4433
- perf(gitlab): skip parent reads for expanded submodule files by @PeterDaveHello in #4436
- perf(labels): skip publishing unchanged label sets by @PeterDaveHello in #4429
- perf(tests): use literal checks for quoted configuration keys by @PeterDaveHello in #4427
- perf(gitea): skip deleted-file head reads by @oleksii-tumanov in #4417
- perf(diff): stop preparing chunks after reaching the call limit by @PeterDaveHello in #4404
- perf(diff): render whole-file additions and deletions directly by @PeterDaveHello in #4400
- perf(azure): skip history without an incremental anchor by @oleksii-tumanov in #4375
- perf(context): bound instruction rendering to retained lines by @PeterDaveHello in #4366
- perf(help-docs): bound memory when reading documentation by @PeterDaveHello in #4367
- perf(tickets): reuse issue reads during ticket extraction by @PeterDaveHello in #4363
- perf(similar-issue): request only required result fields by @PeterDaveHello in #4364
- perf: skip truncation when commands require the full diff by @oleksii-tumanov in #4362
- perf(gitea): skip raw diff for nonreviewable files by @oleksii-tumanov in #4361
- perf(bitbucket): skip OAuth setup for ignored webhook events by @oleksii-tumanov in #4357
📚 Documentation
-
docs: simplify compatible provider setup by @copilot-swe-agent[bot] in #4441
-
docs: correct configuration and usage guidance by @PeterDaveHello in #4722
-
docs(readme): add linked release and project status badges by @PeterDaveHello in #4584
-
docs: clarify doctor CLI entry point on service Docker images by @Yi-111-a in #4701
-
docs: clarify doctor command in service images by @dajiaohuang in #4641
-
docs: correct CLI example and section boundaries by @PeterDaveHello in #4643
-
docs: describe config keys and push trigger scope by @utsab345 in #4594
-
docs: shorten long configuration descriptions by @utsab345 in #4597
-
docs: align documentation with implementation by @utsab345 in #4557
-
docs(platforms): align provider matrix with implementation by @utsab345 in #4524
-
docs: document config.num_retries for rate-limit handling by @HarshRajSinghania in #4194
-
docs: add APIClaw to changing_a_model by @ankita37105 in #4355
-
docs: add a Runcrate section to changing_a_model by @heydryft in #4374
🧹 Maintenance
-
test(config): record the keys PR comments can override by @atishay-kasliwal in #4706
-
test: exercise real lockfile filtering in provider diff tests by @PeterDaveHello in #4609
-
test: clean up SyntaxWarning escape sequences and PytestRemovedIn10Warning by @itsvrushabh in #4482
-
ci: cancel superseded pull request test runs by @PeterDaveHello in #4466
-
refactor: one command registry so aliases behave the same in every entry point by @SpinachDigital in #4727
-
chore(deps): bump oauthlib from 4.0.0 to 4.0.1 by @dependabot[bot] in #4709
-
chore: remove helpers only their own tests called by @Goldloli in #4692
-
chore(providers): remove unused provider methods by @utsab345 in #4691
-
chore(deps): update webpack-dev-server in docs/ via npm audit fix by @PeterDaveHello in #4660
-
chore(deps): bump the python-minor-and-patch group with 15 updates by @dependabot[bot] in #4635
-
chore(deps): exclude litellm from Python groups by @utsab345 in #4633
-
chore(ci): bump astral-sh/setup-uv from 10.3.2 to 10.3.3 in the actions-minor-and-patch group by @dependabot[bot] in #4616
-
chore(docker): bump python from
b347e2dto35caba8in /docker by @dependabot[bot] in #4615 -
refactor(code-suggestions): move replacement helpers into algo/code_replacement by @ira-at-work in #4393
-
chore(deps): bump joi from 17.13.8 to 17.13.9 in /docs by @dependabot[bot] in #4573
-
chore(deps): bump pyasn1 from 0.6.4 to 0.6.5 by @dependabot[bot] in #4575
-
chore(deps): bump follow-redirects from 1.16.1 to 1.16.2 in /docs by @dependabot[bot] in #4574
-
chore: bump pytest to 9.2.0 and ruff to 0.17.3, fix tests by @even-even in #4543
-
refactor(providers): share the get_languages percentage helper by @TheNetherWatcher in #4521
-
refactor(deps): Reuse Tenacity for GitHub diffs and remove legacy retry by @PeterDaveHello in #4495
-
chore(deps): bump qs from 6.16.0 to 6.16.2 in /docs by @dependabot[bot] in #4479
-
refactor(tests): remove test smells from unit tests by @lizandrapinheiro in #4440
-
chore(deps): bump anthropic from 1.15.0 to 2.3.0 in the python-major group across 1 directory by @dependabot[bot] in #4419
-
chore(deps): bump postcss-selector-parser from 6.1.4 to 6.1.5 in /docs by @dependabot[bot] in #4418
-
chore: clean up settings file detection by @utsab345 in #4389
-
chore(ci): bump the actions-minor-and-patch group with 6 updates by @dependabot[bot] in #4410
-
chore(deps): Update boto3 and botocore to 1.43.118 by @PeterDaveHello in #4379
-
chore: remove fixable list ruff rules by @even-even in #4359
⬆️ Dependencies
- chore(deps): bump oauthlib from 4.0.0 to 4.0.1 by @dependabot[bot] in #4709
- chore(deps): bump the python-minor-and-patch group with 15 updates by @dependabot[bot] in #4635
- chore(ci): bump astral-sh/setup-uv from 10.3.2 to 10.3.3 in the actions-minor-and-patch group by @dependabot[bot] in #4616
- chore(docker): bump python from
b347e2dto35caba8in /docker by @dependabot[bot] in #4615 - chore(deps): bump joi from 17.13.8 to 17.13.9 in /docs by @dependabot[bot] in #4573
- chore(deps): bump pyasn1 from 0.6.4 to 0.6.5 by @dependabot[bot] in #4575
- chore(deps): bump follow-redirects from 1.16.1 to 1.16.2 in /docs by @dependabot[bot] in #4574
- chore(deps): bump qs from 6.16.0 to 6.16.2 in /docs by @dependabot[bot] in #4479
- chore(deps): bump anthropic from 1.15.0 to 2.3.0 in the python-major group across 1 directory by @dependabot[bot] in #4419
- chore(deps): bump postcss-selector-parser from 6.1.4 to 6.1.5 in /docs by @dependabot[bot] in #4418
- chore(ci): bump the actions-minor-and-patch group with 6 updates by @dependabot[bot] in #4410
Full Changelog: v0.49.0...v0.50.0
AI summary GitHub polling now requires an allowlist
⚠️ Upgrade notes
- GitHub polling needs an allowlist. New host-only
github.polling_repositories = ["owner/repo", ...]; empty (the default) ignores every notification, so polling deployments must set it (#4294). - Jira
project_keys = []now disables lookups. The default is now["*"]. If you set[]to mean "all projects", change it to["*"]or remove it (#4049). litellm.extra_headersis host-only. Repository.pr_agent.tomland comment arguments can no longer set it (#4287).- Default model is now
gpt-6.1-solwithgpt-6-lunaas fallback (wasgpt-5.6/gpt-5.6-terra). Pinconfig.modelto keep the old one (#4088). - Langfuse SDK 4.18.0 needs self-hosted Langfuse 3.63.0+; use the
langfuse_otelcallback (#4343). - GitHub App token in Actions: set
github.agent_loginto<app-slug>[bot]so PR-Agent recognises its own comments (#4329).
✨ Highlights
pr-agent doctorpreflights a deployment (#4321).--json-outputfor/describe,/improveand/review(#4265, #4227, #4226).- Jira scoped API tokens (#4250),
/askwith the CI artifact as context (#4176), globs inrepo_context_files(#4220), opt-in GitLab subgroup settings inheritance (#4059). - Security hardening: DNS rebinding block, repo-context path escapes, host-only config output, loguru diagnose off, more credential redaction (#4252, #4279, #4293, #4280, #4328).
What's Changed
- Redact Stripe, Twilio and SendGrid credentials by @IlyaKhalafi in #4328
- ci(review): make self-hosted /improve post suggestions again by @Yoel-qin in #4174
- Enable automatic /review on new PRs (fixes #4162) by @kiranmutyala18 in #4170
🚀 Features
- feat(artifacts): support multiple artifact files by @utsab345 in #4338
- feat(cli): add a doctor command to preflight the deployment by @Yoel-qin in #4321
- feat(describe): write the description to --json-output by @Yoel-qin in #4265
- feat(jira): support scoped API tokens by @utsab345 in #4250
- feat(repo-context): glob entries and fallback alternatives in repo_context_files by @ira-at-work in #4220
- feat(ask): include organizational skills in line-level answers by @Yoel-qin in #4225
- feat(review): list the files left out in the JSON output by @Sajinthan in #4226
- feat(improve): write suggestions to --json-output by @Sajinthan in #4227
- feat(ask): answer questions with the CI artifact as context by @Yoel-qin in #4176
- feat(help): prioritize a matching document in constrained prompts by @oleksii-tumanov in #4101
- feat(gitlab): add opt-in closest-subgroup settings inheritance by @ashearin in #4059
- feat(improve): retain equal summaries across files by @oleksii-tumanov in #4128
🐛 Bug Fixes
- fix(ask_line): defer handler setup until a diff hunk matches by @oleksii-tumanov in #4354
- fix(mosaico): retain tasks with bounded owner history by @utsab345 in #4337
- fix(add-docs): retry malformed model responses with fallback models by @PeterDaveHello in #4346
- fix(routing): count diff hunks without splitting patch lines by @PeterDaveHello in #4344
- fix: retry whitespace-only model completions by @PeterDaveHello in #4348
- fix(azure): reject incomplete linked work item responses by @oleksii-tumanov in #4173
- fix(algo): prefer exact source lines before fuzzy matching by @PeterDaveHello in #4340
- fix(similar_issue): use the supported Qdrant query API by @PeterDaveHello in #4341
- fix(azure): handle created events without a web link by @oleksii-tumanov in #4171
- fix(ask): answer with a note when every changed file is filtered out by @sarankumar1325 in #4336
- fix(gitlab): paginate repository directory listings by @utsab345 in #4332
- fix(github): let the operator name the agent login an app token posts as by @sarankumar1325 in #4329
- fix: reject boolean routing limits by @utsab345 in #4302
- fix: parse GitLab boolean settings by @utsab345 in #4303
- fix: stop Gitea changed-files pagination at the advertised total by @fixfon in #4306
- fix(describe): retain valid YAML file-description chunks by @PeterDaveHello in #4315
- fix(gitlab): preserve Git line boundaries when resolving fixed threads by @PeterDaveHello in #4313
- fix(improve): keep embedded fences inside summary diffs by @PeterDaveHello in #4312
- fix: skip generate_labels, add_docs and update_changelog when all files are filtered by @swayamg20 in #4307
- fix(help_docs): preserve fenced examples during cleanup by @PeterDaveHello in #4319
- fix: reject boolean body size limits by @utsab345 in #4301
- fix: normalize list settings consistently by @utsab345 in #4300
- fix: restrict polling to allowlisted repositories by @utsab345 in #4294
- fix: hide host-only configuration output by @utsab345 in #4293
- fix: anchor incremental reviews to agent comments by @utsab345 in #4292
- fix: require bot authorship for describe persistent comments by @utsab345 in #4291
- fix: authorize cross-project GitLab tickets by @utsab345 in #4290
- fix(config): keep litellm.extra_headers host-only by @fixfon in #4287
- fix: disable loguru diagnose and backtrace by @utsab345 in #4280
- fix: reject escaping repo context paths by @utsab345 in #4279
- fix(github): use the GraphQL endpoint on GitHub Enterprise Server by @MaxFreedomPollard in #4272
- fix(help_docs): preserve ranked documents that already fit by @PeterDaveHello in #4267
- fix(review): preserve source characters in patch-based snippets by @PeterDaveHello in #4268
- fix(review): resolve findings in a chunked review when none were cut by @jadhavgaurav in #4222
- fix(config): honor settings context selection by @utsab345 in #4251
- fix(ci): update uv security pin by @utsab345 in #4263
- fix(ignore): keep bracket expressions in string glob patterns by @utsab345 in #4245
- fix(skills): treat a string paths value as one path by @utsab345 in #4244
- fix: parse CRLF plain diffs correctly by @strawberry-little-bear in #4231
- fix(ignore): cap glob length by @utsab345 in #4259
- fix: treat scalar PR ignore settings as single values by @kocaemre in #4257
- fix(security): block DNS rebinding by @utsab345 in #4252
- fix: normalize scalar PR commands by @utsab345 in #4253
- fix(bitbucket): read ambiguous diff headers from patch metadata by @utsab345 in #4248
- fix(outputs): deliver the sinks off the event loop by @utsab345 in #4247
- fix(polling): avoid rerunning commands found in comment history by @PeterDaveHello in #4239
- fix(gitlab): publish notice for incomplete merge request diffs by @Evhye38496 in #4234
- fix(help): render static help without initializing an AI handler by @PeterDaveHello in #4241
- fix(labels): preserve label changes made during model calls by @PeterDaveHello in #4237
- fix(bedrock): stop sending temperature to GLM-5 by default by @ira-at-work in #4219
- fix(repo-context): survive a failed revision lookup by @utsab345 in #4246
- fix(algo): keep yaml fence stripping linear by @utsab345 in #4232
- fix: stop bare #N in comments, link text, colours and words becoming tickets by @jay23606 in #4198
- fix: prevent local config contents in log artifact while preserving PR comment by @wjc2821296948 in #4197
- fix(describe): fall back on unusable model responses by @PeterDaveHello in #4186
- fix(gitlab): avoid double-encoding submodule project paths by @PeterDaveHello in #4214
- fix(changelog): retry empty model responses before publishing by @PeterDaveHello in #4209
- fix(help_docs): recognize Unicode letters in documentation by @PeterDaveHello in #4206
- fix: skip review and describe when all files are filtered by @utsab345 in #4204
- fix(help_docs): recount tokens after cleaning documentation by @PeterDaveHello in #4188
- fix(review): preserve case-sensitive paths when merging chunks by @PeterDaveHello in #4182
- fix(gerrit): bound direct git and SSH commands by @oleksii-tumanov in #4177
- fix(plain-diff): decode Git-quoted file paths by @Aling33 in #4152
- fix(add_docs): preserve literal indentation in suggestions by @oleksii-tumanov in #4172
- fix(review): preserve corrected answers for the latest question by @PeterDaveHello in #4166
- fix(models): avoid same-model retries for authentication failures by @PeterDaveHello in #4167
- fix(diff): preserve non-LF characters when rebuilding patches by @PeterDaveHello in #4168
- fix(gitlab): pin repository settings to one revision by @oleksii-tumanov in #4093
- fix: require Bitbucket Server diff content by @utsab345 in #4111
- fix(github): read repository settings from one revision by @oleksii-tumanov in #4094
- fix(gitlab): retry not-ready merge request diffs with bounded backoff by @Yoel-qin in #4150
- fix: align Bitbucket patches by file path by @utsab345 in #4102
- fix(diff): split patches on newlines only so line numbers match git by @porkedchop in #4080
- fix(ask): parse markdown image URLs precisely by @utsab345 in #4087
- fix(review): merge chunked ticket entries by the real ticket by @utsab345 in #4139
- fix(jira): default project_keys to wildcard and empty list to disable lookups (#3887) by @itsvrushabh in #4049
- fix(routing): retain displaced primary in colliding fallback chains by @PeterDaveHello in #4064
- fix(bitbucket): encode file paths in content reads by @utsab345 in #4095
- fix: preserve repeated override quote types by @utsab345 in #4129
- fix(review): cap merged chunk findings at num_max_findings by @utsab345 in #4138
- fix: keep quoted list settings as lists in parse_command by @utsab345 in #4070
- fix(github): scope API-URL classification to exact host + path prefix by @depohmel in #4143
- fix(github): refresh all PR label pages before replacement by @PeterDaveHello in #4083
- fix: discard stale plain diff context by @utsab345 in #4114
- fix: honor ignore rules in local diff providers by @utsab345 in #4110
- fix(gitea): skip inline comments on lines outside the diff by @fbidu in #4130
- fix(gitea): read renamed base from old path by @utsab345 in #4132
- fix(gitea): encode raw file content paths by @jiuyueQ in #4106
- fix: include DNS validation in URL fetch timeouts by @oleksii-tumanov in #4109
- fix(diff): bound context at adjacent hunks by @utsab345 in #4086
- fix(diff): decode UTF-16 file content correctly by @utsab345 in #4096
- fix(describe): preserve success when final feedback fails by @oleksii-tumanov in #4092
- fix(describe): skip file walkthrough entries with empty fields by @utsab345 in #4082
- fix(codecommit): report unreadable changed files by @utsab345 in #4133
- fix: avoid partial Azure incremental reviews by @utsab345 in #4099
- fix(bitbucket): prevent fork changelog writes by @utsab345 in #4098
- fix(gitlab): match ticket URLs to the configured origin by @oleksii-tumanov in #4097
- fix(similar_issue): retry after filtering excluded hits by @oleksii-tumanov in #4104
- fix: avoid invented GitLab file changes by @utsab345 in #4100
⚡ Performance
- perf(bitbucket): reuse the initial diffstat result by @oleksii-tumanov in #4356
- perf(github): avoid refetching inline question thread comments by @PeterDaveHello in #4345
- perf: defer unused per-file extended diff token counts by @PeterDaveHello in #4349
- perf(similar_issue): batch indexed issue lookups by @PeterDaveHello in #4339
- perf(gitlab): fetch incremental commits in larger pages by @PeterDaveHello in #4318
- perf(diff): release discarded extended patches before repacking by @PeterDaveHello in #4317
- perf(gitlab): load submodule mappings only for expandable changes by @PeterDaveHello in #4314
- perf(github): reuse revision-pinned configuration tree paths by @PeterDaveHello in #4311
- perf(context): expand repository globs only within the line budget by @PeterDaveHello in #4310
- perf(gitlab): reuse revision-pinned configuration tree paths by @PeterDaveHello in #4270
- perf(similar_issue): defer comments until an issue is indexable by @PeterDaveHello in #4269
- perf(gitlab): cache stable merge request changes by @utsab345 in #4254
- perf(gitlab): stop fetching discussions after finding the target by @PeterDaveHello in #4235
- perf(gitlab): count changed lines without splitting patches by @PeterDaveHello in #4238
- perf(improve): stop scanning comments once the summary is found by @PeterDaveHello in #4240
- perf(config): reuse the request-scoped git provider by @PeterDaveHello in #4243
- perf(review): skip ticket lookups for unchanged incremental reviews by @PeterDaveHello in #4236
- perf(gitlab): avoid redundant project fetches before comparisons by @PeterDaveHello in #4242
- perf(webhooks): release body chunks before processing requests by @PeterDaveHello in #4208
- perf(similar_issue): narrow LanceDB lookups to candidate issue IDs by @PeterDaveHello in #4211
- perf(describe): index file statistics when rendering walkthroughs by @PeterDaveHello in #4213
- perf(help_docs): stop the root README scan before descending by @PeterDaveHello in #4207
- perf(similar_issue): skip unused comments when preparing queries by @PeterDaveHello in #4212
- perf(review): avoid extracting code snippets that are not displayed by @PeterDaveHello in #4210
- perf(similar_issue): batch embeddings before individual retries by @PeterDaveHello in #4189
- perf(diff): normalize excluded extensions once per file batch by @PeterDaveHello in #4187
- perf(github): reduce API calls for paginated lists by @PeterDaveHello in #4184
- perf(github-action): skip unused provider initialization by @PeterDaveHello in #4181
- perf(changelog): skip waits when no follow-up review is needed by @PeterDaveHello in #4185
- perf(gitlab): skip project lookup when fetching a merge request by @PeterDaveHello in #4183
- perf(github): reuse revision-pinned file contents across commands by @PeterDaveHello in #4165
- perf(similar_issue): avoid eager issue pagination during indexing by @PeterDaveHello in #4169
- perf(gitlab): reduce pagination requests for commit messages by @PeterDaveHello in #4164
- perf(gitlab): avoid project fetch before language stats by @PeterDaveHello in #4163
- perf(github): fetch issue sub-issues in one GraphQL request by @PeterDaveHello in #4157
- perf(ask_line): avoid full PR reads for language logging by @PeterDaveHello in #4156
- perf: defer Gitea diff and commit fetches by @utsab345 in #4103
- perf(improve): avoid truncation work for required suggestion chunks by @PeterDaveHello in #4146
- perf(config): reuse remote extra config payloads per request by @PeterDaveHello in #4043
- perf(codecommit): cache completed empty file lists by @oleksii-tumanov in #4127
- perf(bitbucket): avoid unused Server base lookups by @oleksii-tumanov in #4108
- perf: batch LanceDB issue index checks by @utsab345 in #4115
- perf(gitlab): cache verified empty diff results by @PeterDaveHello in #4085
- perf(github): limit thread lookup to root comments by @PeterDaveHello in #4113
- perf(github): filter check-run lookups by name by @PeterDaveHello in #4112
- perf(github): reuse command provider for polling reactions by @PeterDaveHello in #4084
- perf(gitlab): skip fetching MR commits without an incremental anchor by @PeterDaveHello in #4147
📚 Documentation
- docs: clarify setup steps and section hierarchy across guides by @PeterDaveHello in #4342
- docs: clarify the uv version requirement in CONTRIBUTING.md by @PeterDaveHello in #4308
- docs: add review checklist by @utsab345 in #4298
- docs: add "Incorrect API key provided: dummy_key" to the GitHub Action troubleshooting list by @qwist1233-cpu in #4199
- docs: stop examples from repeating the primary model in fallback_models by @utsab345 in #4205
- docs: Scope agent lint fixes to changed files and preserve valid ignores by @PeterDaveHello in #4159
- docs: add API Route configuration example by @DennyHo0917 in #4153
- docs: Align AGENTS.md with repository configuration and test workflows by @PeterDaveHello in #4158
🧹 Maintenance
- chore(deps): Upgrade Langfuse to v4 for continued SDK and server support by @PeterDaveHello in #4343
- chore(docker): refresh pinned Lambda Python 3.14 base image by @PeterDaveHello in #4309
- chore(docker): upgrade Python base image to 3.14.9 by @PeterDaveHello in #4316
- chore: upgrade Ruff to 0.17.2 by @utsab345 in #4304
- chore: run pre-commit through uvx by @utsab345 in #4299
- chore(deps): Upgrade OpenTelemetry and virtualenv by @PeterDaveHello in #4271
- chore: add FURB ruff rules by @even-even in #4216
- chore: add UP ruff rule by @even-even in #4067
- chore(deps): update LiteLLM to 1.105.1 by @PeterDaveHello in #4151
- chore(models): use GPT-6.1 Sol defaults with GPT-6 Luna fallback by @PeterDaveHello in #4088
⬆️ Dependencies
- chore(deps): bump body-parser from 1.20.8 to 1.20.9 in /docs by @dependabot[bot] in #4352
- chore(deps): bump fast-uri from 3.1.8 to 3.1.9 in /docs by @dependabot[bot] in #4351
- chore(deps): bump undici from 7.29.1 to 7.30.1 in /docs by @dependabot[bot] in #4350
- chore(deps): bump launch-editor from 2.14.1 to 2.14.2 in /docs by @dependabot[bot] in #4218
- chore(deps): bump certifi from 2026.7.22 to 2026.10.19 by @dependabot[bot] in #4217
- chore(deps): bump follow-redirects from 1.16.0 to 1.16.1 in /docs by @dependabot[bot] in #4215
- chore(deps): bump the python-minor-and-patch group with 12 updates by @dependabot[bot] in #4192
- chore(ci): bump the actions-minor-and-patch group with 3 updates by @dependabot[bot] in #4191
- chore(deps): bump the docs-minor-and-patch group in /docs with 2 updates by @dependabot[bot] in #4190
Full Changelog: v0.48.0...v0.49.0
AI summary Docker images now run as non-root user
⚠️ Breaking Changes
Warning
This release changes several defaults and makes more settings host-only. Check each item below against your deployment before upgrading.
pip install pr-agentno longer installs the git provider SDKs (#3679): PyGithub, python-gitlab, atlassian-python-api, the Azure DevOps SDKs, boto3, giteapy, the Google Cloud SDKs and a2a-sdk moved to thegithub,gitlab,bitbucket,azure,codecommit,gitea,googleandmosaicoextras. Install the ones you use, for examplepip install "pr-agent[github]", orpr-agent[all]for the previous set. The Docker images already installall.- Docker service images run as a non-root user (#3910): the webhook, app, polling and Mosaico targets run as UID/GID
10001withHOME=/home/pragent. Mounted secrets must be readable by that user, output and database directories must be writable, and home-relative mounts should move to/home/pragent. The GitHub Action, CLI and Lambda images still run as root. - Azure DevOps and Bitbucket Server webhooks require credentials (#3911): with
azure_devops_server.webhook_username/webhook_passwordorbitbucket_server.webhook_secretunset, every webhook is rejected with HTTP 403. Set them on both the sender and PR-Agent before upgrading. - GitLab webhooks backed by a secret provider need a new token format (#3913): when GitLab credentials come from AWS Secrets Manager or Google Cloud Storage, the webhook's Secret Token must be
<secret-name>:<webhook-token>. Name-only tokens are rejected with HTTP 401, so update the webhooks when you deploy. - Namespace-wide settings are off by default (#3908): PR-Agent no longer applies
<namespace>/pr-agent-settingsto every repository automatically. Set the host-onlyconfig.global_settings_repo = "pr-agent-settings"to keep the old behaviour. [tool.pr-agent]inpyproject.tomlis no longer read (#3941): move those settings to.pr_agent.toml.- More settings are host-only (#3840, #3904, #3950, #4001, #4054): a repository's
.pr_agent.tomland comment arguments can no longer set provider endpoints (openai.api_baseand the otherapi_basekeys), keys ending inurl,endpoint,org,key,tokenorsecret, provider auth mode and TLS settings (github.deployment_type,gitlab.auth_type/ssl_verify,bitbucket.auth_type,gitea.skip_ssl_verification/ssl_ca_cert),jira.jira_site/jira_api_email/project_keys, or LiteLLM callbacks. They are ignored with a warning, so set them in host configuration instead. Comment arguments are restricted further as well (#3902). - Gitea and Gerrit read repository settings from the target branch (#3906): Gitea uses the PR base and Gerrit the default branch, so a
.pr_agent.tomlchange inside a PR no longer applies to that PR. - Cross-repository reads need an allowlist (#3922, #3897): GitHub ticket context only reads linked issues and sub-issues from the PR's own repository or same-owner repositories listed in
config.repo_context_sibling_repos.gitlab.expand_submodule_diffsonly expands submodules listed there that sit in the MR's top-level group. - Ignore rules now cover comment commands (#3943):
config.ignore_pr_authors,ignore_pr_labels,ignore_pr_title, the branch rules andignore_repositoriesnow skip manually triggered commands too, not only automatic ones. merge_recommendationvalues were renamed (#4010): withpr_reviewer.require_merge_recommendationon,safe_to_mergeis nowno_concerns_foundandmerge_with_cautionis nowneeds_review.changes_requiredis unchanged. Update anything that parses review output./describecomments no longer repeat the PR description (#4118): withpr_description.publish_description_as_comment = true, the comment leaves out the User Description section even whenadd_original_user_descriptionis on, because the PR body is left untouched.- Smaller behaviour changes: webhook servers reject request bodies over 5 MiB with HTTP 413 (
config.max_webhook_request_body_bytes, #3820). A positiveconfig.max_output_tokensbelow 4096 is raised to 4096 (#4013)./describeand/generate_labelsdrop model labels outside the PR types and enabled custom labels (#3899).
What's Changed
🚀 Features
- feat: show agent run details on /ask, /ask_line, /update_changelog, and /help answers by @ashearin in #4091
- feat(linear): add linked issue context for ticket compliance by @lkshrk in #4078
- Add support for Gemini 4 Argon by @takotakot in #4120
- feat: support CompactifAI provider credentials by @favouradesiyan in #3737
- feat(gitea): support inline key issues by @fbidu in #4131
- feat(ci): post PR-Agent output as the PR Agent GitHub App when configured by @naorpeled in #4051
- feat(ci): enable sponsored descriptions and improvements on PR open by @ofir-frd in #4002
- feat(review): honor human-resolved GitHub key issues by @erezlev13 in #4032
- feat: cache the shared skills prefix across review tools by @utsab345 in #4014
- feat: export PR reviews as JSON by @utsab345 in #4033
- feat(review): honor explicit Azure key-issue dismissals by @erezlev13 in #4025
- feat(review): add opt-in failure modes by @oleksii-tumanov in #4012
- feat(artifacts): choose which end of the file truncation keeps by @Yoel-qin in #3990
- feat(tickets): include native issue references from PR titles by @oleksii-tumanov in #3980
- feat(review): treat human-resolved inline key-issue threads as dismissed by @hkn-wt in #3925
- feat(github): stream chunk progress into in-progress check runs by @Yoel-qin in #3933
- feat(models): add OpenAI GPT-6.1 Sol support by @PeterDaveHello in #3938
- feat(describe): report chunk progress in the progress comment by @Yoel-qin in #3872
- feat(push-outputs): add Telegram channel by @noooooooookro in #3868
- feat(local): support repo context files in the local git provider by @YokoAC in #3863
- feat(gitlab): react to how a comment command ended by @PeterDaveHello in #3852
- feat(otel): export per-command token usage by @utsab345 in #3835
- feat(models): add OpenAI GPT-6 Sol and Luna support by @PeterDaveHello in #3628
- feat: report chunk progress in the progress comment by @utsab345 in #3814
- feat(review): give /review the findings of earlier reviews by @hkn-wt in #3750
🐛 Bug Fixes
- fix(describe)!: skip original user description when published as comment by @maurerle in #4118
- fix(gitlab): retry the first merge request lookup on 404 for new MR webhooks by @jadhavgaurav in #3995
- fix(bedrock): stop sending temperature to Kimi K3 and GLM-5 by default by @ira-at-work in #3752
- fix(security): redact bare provider tokens from logs and artifacts by @Yoel-qin in #4081
- fix(mosaico): consume the Eclipse registry deployment image by @ofir-frd in #4148
- fix(litellm): initialize without the optional google extra by @SzymonNastaly in #4141
- fix(tickets): deduplicate GitHub issue references by identity by @PeterDaveHello in #4072
- fix(settings): redact shared errors and retry transient fetches by @ashearin in #4071
- fix(docs): preserve Azure DevOps dismissal note during regeneration by @PeterDaveHello in #4066
- fix: preserve yaml-prefixed keys in load_yaml by @utsab345 in #4069
- fix: close file handle in bitbucket manifest handler by @utsab345 in #4063
- fix(litellm): observe detached stream cleanup failures by @PeterDaveHello in #4042
- fix: keep quoted command setting values as strings by @utsab345 in #4048
- fix: cap github suggestion body length by @utsab345 in #4053
- fix: restrict LiteLLM callbacks to deployment settings by @utsab345 in #4054
- fix(azure): surface diff collection failures by @utsab345 in #4060
- fix(improve): avoid model fallback for empty analyzable diffs by @PeterDaveHello in #4057
- fix(models): correct Claude Sonnet 4.6 and Opus 4.6 context windows by @PeterDaveHello in #4058
- fix: keep review finding location when end line is empty by @utsab345 in #4036
- fix(ci): read the comment event from GITHUB_EVENT_PATH in PR-Agent authorization by @naorpeled in #4050
- fix: merge extra config keys case-insensitively by @utsab345 in #4037
- fix: tolerate missing effort field in review labels by @utsab345 in #4047
- fix(github): avoid retrying permanent diff collection failures by @PeterDaveHello in #4045
- fix(diff): keep unreadable file notices in chunked diffs by @PeterDaveHello in #4041
- fix(openrouter): attribute model requests to PR-Agent by @PeterDaveHello in #4039
- fix: skip empty insights section in review output by @utsab345 in #4038
- fix(gerrit): skip symlink and git-metadata suggestion paths by @HarshRajSinghania in #3915
- fix: improve skills budget warnings by @karthi040506 in #3865
- fix(gitlab): load host settings before note provider lookup by @PeterDaveHello in #4023
- fix: pass CI artifact context into suggestion self-reflection by @HarshRajSinghania in #4034
- fix: account for CI in merge recommendation by @utsab345 in #4031
- fix: find suggestion fence closers without a lazy scan by @utsab345 in #4028
- fix: redact CI artifact credentials before prompt injection by @jiuyueQ in #3989
- fix(improve): fence a suggestion with more backticks when its code has a fence by @huiq777 in #3791
- fix(security): reject non-public destination address ranges by @PeterDaveHello in #4024
- fix(bitbucket): report request failures before falling back by @PeterDaveHello in #4022
- fix(gitea): keep failed guidance reads out of caches by @oleksii-tumanov in #4016
- fix: report clipped patches as partial input coverage by @oleksii-tumanov in #4019
- fix(litellm): warn on invalid config.max_output_tokens and enforce a 4096 floor by @ALN-web in #4013
- fix(review): keep url-less ticket compliance entries distinct by @utsab345 in #3999
- fix(gerrit): reset local edits after failed patch uploads by @PeterDaveHello in #4021
- fix(bitbucket-server): build line links on the canonical PR URL by @ALN-web in #4015
- fix(review): allow disabling failure comments by @oleksii-tumanov in #4011
- fix(review): render url-less ticket compliance without dead link by @utsab345 in #4000
- fix: create missing AWS secrets by @utsab345 in #3930
- fix(jira): keep jira_site and project_keys host-only by @hkn-wt in #4001
- Allow extra review fields by @utsab345 in #3998
- fix(review): escape HTML, convert newlines to <br>, and render nested YAML in unknown review keys (#3975) by @AnkitaAdvitot in #3976
- fix: mark CI artifact input as untrusted by @sb123sb123 in #3978
- fix: preserve extra instructions in suggestion reflection by @Ai-Eastern in #3987
- fix(github): resolve threads for replies after the first comment page by @oleksii-tumanov in #3979
- fix(litellm): align OpenRouter reasoning clamps and token reserves by @PeterDaveHello in #3981
- fix(bitbucket): verify the webhook JWT before parsing the request body by @Evhye38496 in #3958
- fix(context): prioritize directly linked ticket context by @oleksii-tumanov in #3967
- fix(ask): propagate final reply delivery errors by @oleksii-tumanov in #3970
- fix(gitea): reuse the PR commit snapshot for messages by @oleksii-tumanov in #3971
- fix(review): log all schema validation errors and run require checks (#3973) by @AnkitaAdvitot in #3974
- fix(review): handle non-list can_be_split values by @utsab345 in #3969
- fix: enforce PR ignore policy at the agent boundary by @erezlev13 in #3943
- fix(gitea): read diff file names with the shared parser by @utsab345 in #3964
- fix(bitbucket): handle push events without a pull request by @utsab345 in #3961
- fix(polling): preserve pulls segment in comment URLs by @utsab345 in #3962
- fix(diff): extend zero-length hunks from the right line in extend_patch by @havinash-007 in #3966
- fix(context): avoid duplicate local repository context entries by @oleksii-tumanov in #3968
- fix(local): respect the configured description token budget by @oleksii-tumanov in #3956
- fix: keep provider auth and TLS settings host-only by @1cbyc in #3950
- fix(diff): use fixed context for headerless hunks by @oleksii-tumanov in #3955
- fix(security): reject dunder section/key names in repo settings files by @SpinachDigital in #3947
- fix(bitbucket): align Connect lifecycle and JWT handling (#3877) by @AnkitaAdvitot in #3923
- fix(security): protect provider connection settings by @nightcityblade in #3904
- fix(config): stop loading [tool.pr-agent] from the checkout's pyproject.toml by @utsab345 in #3941
- fix(webhooks): Require Azure and Bitbucket Server credentials by @oleksii-tumanov in #3911
- fix: load repository settings from target refs by @nightcityblade in #3906
- fix(tickets): restrict GitHub issue reads to approved repositories by @oleksii-tumanov in #3922
- fix(gitlab): Verify stored webhook tokens before loading credentials by @oleksii-tumanov in #3913
- fix(docker): Run services as non-root and pin build images by @oleksii-tumanov in #3910
- fix(git_providers): bound HTTP requests that have no timeout by @PeterDaveHello in #3850
- fix: restrict host-only comment arguments by @nightcityblade in #3902
- fix(gerrit): keep line endings and mode when applying a suggestion by @ALN-web in #3876
- fix(tickets): Match full issue URLs on the configured GitHub origin by @oleksii-tumanov in #3907
- fix(gitea): parse PR and issue URLs of an instance served under a subpath by @ALN-web in #3937
- fix(gitea): skip the base-content fetch for added files by @PeterDaveHello in #3936
- fix(review): mark PR title/description/commits/tickets/code as untrusted in reviewer system prompt by @SpinachDigital in #3921
- fix(telemetry): configure delta aggregation temporality for prometheus counter exporter (#3871) by @Fire162 in #3873
- fix(ignore): allow globstar segments to match zero directories by @PeterDaveHello in #3855
- fix: preserve optional provider install hints in context errors by @strawberry-little-bear in #3929
- fix(servers): verify Gitea and GitLab webhooks before parsing by @utsab345 in #3912
- fix(mosaico): limit requests and isolate caller tasks by @oleksii-tumanov in #3926
- fix: propagate recorded tool failures from CLI by @abhinavrastogi2627 in #3919
- fix: restrict generated labels to the enabled vocabulary by @brown-sussy in #3899
- fix(commands): Honor disabled publication in line questions and help by @oleksii-tumanov in #3900
- fix(config): require config.global_settings_repo for namespace settings by @utsab345 in #3908
- fix(litellm): isolate request settings by @utsab345 in #3898
- fix(gitlab): authorize submodule diff targets by @utsab345 in #3897
- fix(git-providers): prevent fork changelog writes by @nightcityblade in #3905
- fix(plain-diff): keep output when stdout cannot encode it by @ALN-web in #3875
- fix(local): write description.md as UTF-8 by @ALN-web in #3874
- fix(improve): name deleted files instead of sending their lines by @utsab345 in #3866
- fix(ask): sanitize echoed question and line-question answers against quick actions (#2629) by @rishiiicreates in #3860
- fix(gitea): reject incomplete changed-file inventories by @oleksii-tumanov in #3857
- fix(ask): require https and bound redirects in image check by @utsab345 in #3847
- fix: close LiteLLM streams without interrupting cancellation by @PeterDaveHello in #3723
- fix(litellm): treat Bedrock ARN overrides as Claude for caching and cost by @utsab345 in #3844
- fix(improve): report unconfirmed persistent suggestion updates by @oleksii-tumanov in #3858
- fix(gitlab): refill ticket context after failed issue lookups by @oleksii-tumanov in #3859
- fix(security): keep provider endpoints host controlled by @sb123sb123 in #3840
- fix(servers): match the whole /ask command token by @utsab345 in #3822
- fix(improve): make the reflection-failure score configurable by @utsab345 in #3833
- fix(webhooks): cap request bodies before parsing by @sb123sb123 in #3820
- fix(litellm): skip same-model retry on length truncation by @utsab345 in #3827
- fix(gitlab): report suggestion publication failures by @teachershuang in #3129
- fix(changelog): preserve confirmed writes after feedback failure by @oleksii-tumanov in #3849
- fix(github): reject file lists collected across PR revisions by @oleksii-tumanov in #3848
- fix(litellm): scope bedrock model_id per model, fix fallback region lookup by @CodeByPeace in #3846
- fix(gerrit): validate refspec before fetching by @sb123sb123 in #3838
- fix(local): return the branch name string from get_pr_branch by @YokoAC in #3841
- fix(gitea): anchor code suggestions to the new file by @utsab345 in #3821
- fix(bitbucket): summarize sensitive webhook payload logs by @sb123sb123 in #3818
- fix(gitea): use the shared slash-command comment gate by @utsab345 in #3784
- fix(deps): declare urllib3 as a direct dependency by @PeterDaveHello in #3811
- fix(file_filter): report skipped and incomplete ignore filtering by @PeterDaveHello in #3801
- fix: include filtered changed filenames in review context by @truongbo17 in #3806
⚡ Performance
- perf(review): avoid repeated JSON serialization of previous findings by @PeterDaveHello in #4142
- perf(yaml): avoid reparsing unchanged failed input by @PeterDaveHello in #4073
- perf(diff): bound tokenization when trimming filename metadata by @PeterDaveHello in #4056
- perf(github): resolve merge base only when needed by @PeterDaveHello in #4044
- perf(routing): count diff hunks only when needed by @PeterDaveHello in #4008
- perf(diff): use set for included-file metadata checks by @PeterDaveHello in #4017
- perf(gerrit): walk the commit diff once per provider instance by @PeterDaveHello in #3935
- perf(context): load instruction files lazily by line budget by @PeterDaveHello in #3985
- perf(diff): reuse patch token counts across packing rounds by @PeterDaveHello in #3986
- perf(git_providers): memoize get_languages() across providers by @PeterDaveHello in #3934
- perf(yaml): use LibYAML for initial response parsing by @PeterDaveHello in #3759
- perf(gitlab): read the default branch once instead of per read by @PeterDaveHello in #3853
- perf(gitlab): stop fetching the project and merge request to react by @PeterDaveHello in #3851
📚 Documentation
- docs: add a Cheaper Inference section to changing_a_model by @aiapienthusiast in #3675
- Document RelaxAI OpenAI-compatible setup by @copilot-swe-agent[bot] in #4076
- docs: use a concrete DemonRoute model in example by @demonroute2 in #4075
- docs: add DemonRoute to changing_a_model by @demonroute2 in #4074
- docs: add Heabsy to changing_a_model by @kafomichev in #3755
- docs(litellm): clarify shared skills and per-tool cache breakpoints by @PeterDaveHello in #4065
- docs: narrow installation permissions by @nightcityblade in #3901
- docs: self-host README images by @utsab345 in #3839
- docs(config): align self-review knobs with the visual-marker-only note by @Yoel-qin in #3809
🧹 Maintenance
- test(aws): prevent false passes in Bedrock fallback region test by @PeterDaveHello in #4090
- chore(deps): update LiteLLM to 1.105.0 by @PeterDaveHello in #4089
- chore: remove unused JSON repair helpers by @utsab345 in #4061
- chore: up html2text to 2025.4.15 by @even-even in #4055
- chore(models): prune retired and obsolete static model entries by @PeterDaveHello in #4026
- chore: remove unused code suggestion parser by @utsab345 in #4035
- chore: rename merge_recommendation values to describe findings by @utsab345 in #4010
- chore: unskip E722 ruff rule and actualize ruff config by @even-even in #3993
- chore: unskip B023 ruff rule by @even-even in #3977
- chore: unskip B904 ruff rule by @even-even in #3951
- chore(deps): update LiteLLM to 1.104.0 by @PeterDaveHello in #3932
- ci: scope docs-ci write to the deploy job and default the other workflows to read-only by @yunaremaia in #3896
- refactor: make provider SDKs optional by @NesrineGharbi77 in #3679
- refactor(outputs): separate sink strategies from dispatch by @erezlev13 in #3854
- chore: unskip B017 ruff rule by @even-even in #3856
- refactor(prompt): standardize on sandboxed Jinja by @sb123sb123 in #3819
- refactor: remove redundant work from output processing by @PeterDaveHello in #3813
- chore(deps): bump oauthlib to 4.0.0 in uv.lock by @PeterDaveHello in #3812
⬆️ Dependencies
- chore(deps): bump the python-major group across 1 directory with 6 updates by @dependabot[bot] in #4126
- chore(docker): bump python from 3.14.7-slim to 3.14.8-slim in /docker by @dependabot[bot] in #4123
- chore(ci): bump the actions-minor-and-patch group with 8 updates by @dependabot[bot] in #4124
- chore(deps): bump the python-minor-and-patch group with 20 updates by @dependabot[bot] in #4125
- chore(deps): bump shell-quote from 1.10.0 to 1.12.0 in /docs by @dependabot[bot] in #3957
- chore(deps): bump multidict from 6.7.1 to 6.9.1 by @dependabot[bot] in #3954
- chore(deps): bump langgraph-sdk from 0.4.2 to 0.4.4 by @dependabot[bot] in #3952
- chore(deps): bump fsspec from 2025.12.0 to 2026.6.0 by @dependabot[bot] in #3953
- chore(deps): bump source-map-js in /docs and make the uv pin a floor for Dependabot by @dependabot[bot] in #3949
- chore(deps): bump proxy-addr from 2.0.7 to 2.0.8 in /docs by @dependabot[bot] in #3946
- chore(ci): bump the actions-minor-and-patch group with 2 updates by @dependabot[bot] in #3940
Full Changelog: v0.47.0...v0.48.0
AI summary Gitea webhooks now require secrets and comment commands need leading slashes
⚠️ Important Changes
- Gitea webhooks now require a secret (#3637): with
gitea.webhook_secretunset, the Gitea app rejects every webhook with HTTP 403 instead of accepting it unsigned. Set the secret on the Gitea webhook and in your config before upgrading. - The GitHub Action fails on tool errors (#3712): a tool failure that used to be logged and swallowed now fails the Action. Set
github_action_config.fail_on_tool_errors = falseto keep the old green behaviour. - Comment commands need a leading
/on GitLab, Bitbucket and Bitbucket Server (#3769): a comment only runs a tool when it starts with a slash command, so plain comments that mention one no longer trigger anything. extra_config_urlis host-only (#3638): a repository's.pr_agent.tomlcan no longer set it. Configure it on the host instead, for example withPR_AGENT_EXTRA_CONFIG_URL.commitable_code_suggestionsis nowcommittable_code_suggestions(#3749): the old spelling still works with a deprecation warning until 1.0.- The Bitbucket Server webhook image runs under gunicorn (#3667): the container now starts multiple workers through the shared
gunicorn_config.pyinstead of a single Python process.
Known issue: Bedrock Kimi K3, new in this release (#3651), still receives a temperature by default, which Bedrock is reported to reject. Until #3752 lands, add the model ids to config.no_temperature_models.
What's Changed
- Run BitBucket Server webhook under gunicorn for worker isolation by @jkratz55 in #3667
- test: pin LiteLLM future Claude fallbacks by @PeterDaveHello in #3660
- test(ai_handlers): add tripwire for guarded private LiteLLM imports by @utsab345 in #3615
- test: use the bundled LiteLLM cost map in local unit runs by @akalongman in #3641
- fix(codecommit): align language classification with diff packing by @oleksii-tumanov in #3625
- refactor(cloud_auth): deduplicate repeated logic by @high-tail in #3607
🚀 Features
- feat(gitlab): distinguish applied and bot-resolved suggestion threads in the improve context by @JokeWaumans in #3774
- feat: add Bedrock Kimi K3 models by @ira-at-work in #3651
- feat: reply to GitLab trigger discussions by @deadpool-mjpatel4444 in #3426
- feat(gitlab): support inline key issues by @utsab345 in #3650
- feat(ai_handlers): surface prompt cache visibility by @utsab345 in #3618
- feat(models): add Claude Opus 5.5 support by @PeterDaveHello in #3629
- feat: validate /describe output against existing model by @taljeon in #3616
🐛 Bug Fixes
- fix(git_providers): log publish and settings errors at quiet verbosity by @PeterDaveHello in #3802
- fix(tickets): cap fetched sub-issues per ticket and order parent before children by @rishiiicreates in #3807
- fix(models): clamp OpenRouter Gemini reasoning disablement by @oleksii-tumanov in #3787
- fix(tools): re-raise any provider incomplete-files error, not just Bitbucket's by @PranavD2905 in #3800
- fix(bitbucket): encode filenames in line links by @kudala-bharani in #3796
- fix(servers): route inline comments to /ask_line only on a leading /ask by @utsab345 in #3797
- fix(review): link a TODO without a usable line number to its file by @Arta-shoja in #3788
- fix: stop caching repo context on a mutable ref by @utsab345 in #3776
- fix(typo): commitable to committable by @even-even in #3749
- fix(action): share GitHub helpers so the Action keeps the #3670 /ask fix by @Yoel-qin in #3785
- fix(github): fetch newest polling comments by @oleksii-tumanov in #3747
- fix(labels): build the label enum when no custom labels are set by @utsab345 in #3773
- fix(tokens): drop dangling bytes when fitting truncated prompt text by @Yoel-qin in #3771
- fix(providers): encode filenames in line links by @oleksii-tumanov in #3782
- fix(changelog): make fence stripping idempotent by @utsab345 in #3783
- fix(gitlab): classify concurrent changelog creation by @oleksii-tumanov in #3786
- fix(bitbucket): reject incomplete aggregate pull request diffs by @oleksii-tumanov in #3743
- fix: stop three silent fallbacks that corrupt review and label output by @utsab345 in #3744
- fix: preserve findings when inline positions cannot be resolved by @strawberry-little-bear in #3753
- fix(changelog): preserve concurrent edits during changelog updates by @oleksii-tumanov in #3751
- fix(azure): apply ignore patterns to slash-prefixed paths by @utsab345 in #3770
- fix(mosaico): honor streaming requirements in health probes by @PeterDaveHello in #3781
- fix(servers): require a leading slash for comment commands by @Yoel-qin in #3769
- fix(bitbucket): apply ignore filters to push commands by @Yoel-qin in #3768
- fix(codecommit): prepare comment bodies in publish_code_suggestions by @truecallerabreham in #3736
- fix(tickets): preserve branch issue order by @oleksii-tumanov in #3766
- fix: detect language for multi-part and uppercase suffixes by @utsab345 in #3767
- fix(gitea): delete every temp comment on cleanup by @utsab345 in #3765
- fix: fail closed on three silent fallbacks by @utsab345 in #3742
- fix(github): invalidate stale non-empty diff caches by @PeterDaveHello in #3724
- fix(github): fetch all direct sub-issues by @oleksii-tumanov in #3746
- fix(azure): do not resolve a comment thread after a swallowed tool failure by @Lesereingrape in #3722
- fix(github_action): fail the Action when a tool records a swallowed failure by @charlieanna in #3712
- fix(gitlab): stop search_line from raising UnboundLocalError by @utsab345 in #3756
- fix(gerrit): reject unsupported reflect webhook action by @oleksii-tumanov in #3748
- fix(improve): match applied entries when capping history by @utsab345 in #3735
- fix(improve): keep generation and reflection chunks aligned by @oleksii-tumanov in #3740
- fix(openrouter): normalize routing variants in capability checks by @PeterDaveHello in #3728
- fix(azure): keep the incremental diff on the source branch by @utsab345 in #3758
- fix(tests): harden Gitea E2E branch naming and timeouts by @PeterDaveHello in #3664
- fix(bitbucket): report line counts in describe by @utsab345 in #3727
- fix(add_docs): report failed inline documentation publication by @oleksii-tumanov in #3745
- fix(add_docs): anchor docstring indentation on a code line by @utsab345 in #3733
- fix(gitea): separate commit messages by @utsab345 in #3729
- fix(github): strip only the leading ask command by @utsab345 in #3732
- fix(agent): treat hash as text in commands by @utsab345 in #3731
- fix: record failures from swallowed auto-command tools by @sb123sb123 in #3710
- fix(codecommit): use the PR URL region for AWS requests by @oleksii-tumanov in #3715
- fix(bitbucket): resolve settings branches to commit hashes by @oleksii-tumanov in #3711
- fix(diff): a deletion-only diff is dropped from the compressed prompt with no bookkeeping by @utsab345 in #3699
- fix(ask): preserve apostrophes in double-quoted questions by @oleksii-tumanov in #3698
- fix(diff): preserve deleted file metadata when pruning by @PeterDaveHello in #3697
- fix(commands): preserve automatic command setting overrides by @oleksii-tumanov in #3696
- fix(gitlab): skip incomplete submodule comparisons by @oleksii-tumanov in #3695
- fix(tokens): avoid a stale cached encoder on concurrent model switch by @utsab345 in #3694
- fix(cli_args): reject forbidden keys hidden in section mapping values by @utsab345 in #3648
- fix(ignore): stop renames bypassing ignore rules on GitLab and Bitbucket by @utsab345 in #3693
- fix(mosaico): parse quoted diff paths by @deadpool-mjpatel4444 in #3441
- fix(litellm): clamp Gemini 3.7/3.8 minimal reasoning by @deadpool-mjpatel4444 in #3434
- fix(gitlab): skip invalid suggestion line ranges by @deadpool-mjpatel4444 in #3433
- fix: preserve nested code fences in review snippets by @kevin-lozada-santos in #3418
- fix(models): pass chat template options in the request body by @oleksii-tumanov in #3682
- fix(github): reuse empty diffs within a command by @PeterDaveHello in #3692
- fix: return text from GCS secret provider by @PeterDaveHello in #3690
- fix(gitlab): expose prior code-suggestion threads to improve by @utsab345 in #3684
- fix(tokens): count via litellm.acount_tokens instead of _calc_claude_tokens by @utsab345 in #3620
- fix(ci): rerun autolabeler on PR title edits by @PeterDaveHello in #3678
- fix(codecommit): keep publishing remaining suggestions after one failure by @utsab345 in #3681
- fix: redact GCS secret retrieval failures from logs by @utsab345 in #3680
- fix(models): avoid replaying rejected model requests by @oleksii-tumanov in #3683
- fix(artifacts): preserve CI context after command settings by @oleksii-tumanov in #3674
- fix: classify retryable model fallback failures by @taljeon in #3631
- fix(gitlab_webhook): degrade to shared secret when the secret provider fails by @utsab345 in #3662
- fix(github): create missing changelog file when pushing updates by @remote-controlled-man in #3639
- fix(github): keep dedup markers when truncating invalid suggestions by @utsab345 in #3668
- fix(similar_issue): re-ingest after an interrupted full ingest by @utsab345 in #3580
- fix(diff): keep all hunks spanned by a line range by @utsab345 in #3671
- fix(diff): place zero-length hunks correctly when reconstructing the base file by @huiq777 in #3673
- fix(bitbucket): update progress comments returned as raw payloads by @jspw in #3653
- fix: preserve whitespace and empty sides in generated diffs by @PeterDaveHello in #3666
- fix(help_docs): fit the dispatched prompt per fallback model by @utsab345 in #3657
- fix(github_app): keep multi-command /ask mobile quotes intact by @utsab345 in #3670
- fix(improve): report files omitted from suggestion coverage by @junnhwan in #3645
- fix(diff): ignore EOF metadata when locating lines by @PeterDaveHello in #3658
- fix(skills): invalidate cached context when the model changes by @oleksii-tumanov in #3672
- fix(describe): report the exact unprocessed-file remainder by @utsab345 in #3669
- fix(github): avoid partial hunk fallback updates by @PeterDaveHello in #3621
- fix(github): narrow broad exception handlers in the GitHub provider by @wfatih in #3524
- fix(improve): fall back to summarized comment when inline publish is exhausted by @utsab345 in #3605
- fix(mosaico): retain A2A context across follow-up tasks by @junnhwan in #3643
- fix(gitea): fail closed when webhook secret is unset by @utsab345 in #3637
- fix(security): make extra_config_url host-only by @utsab345 in #3638
- fix: redact Bitbucket install storage errors by @PeterDaveHello in #3624
- fix: redact botocore credential process refresh logs by @PeterDaveHello in #3622
- fix: validate direct command setting keys by @oleksii-tumanov in #3634
- fix(cli): isolate invocation settings by @oleksii-tumanov in #3635
- fix(gitlab): fall back to full diffs on compare timeout by @oleksii-tumanov in #3636
- fix(github): enable verified inline key issues by @taljeon in #3633
- fix(tokens): skip encoding for non-positive budgets by @PeterDaveHello in #3623
- fix(improve): validate summary anchors before per-file caps by @oleksii-tumanov in #3626
- fix(help): honor tool error propagation by @oleksii-tumanov in #3627
- fix(action): ignore non-command comments by @utsab345 in #3604
- fix: keep changelog wait cooperative by @oleksii-tumanov in #3601
- fix: preserve backslashes in diagram markers by @oleksii-tumanov in #3599
- fix(mosaico): classify diff files by language by @oleksii-tumanov in #3597
- fix(qdrant): batch similar issue uploads by @sajjadlabx in #3559
- fix(review): keep findings with non-numeric line fields by @utsab345 in #3590
- fix(bitbucket): preserve backslashes in rendered suggestions by @PeterDaveHello in #3577
- fix(tokens): count special-token literals as ordinary text by @PeterDaveHello in #3573
⚡ Performance
- perf(diff): stop stalled large-PR packing by @PeterDaveHello in #3763
- perf(tokens): avoid redundant initial prompt counting by @PeterDaveHello in #3762
- perf(gitlab): skip impossible file content reads by @PeterDaveHello in #3761
- perf(diff): skip fuzzy matching for exact patch lines by @PeterDaveHello in #3725
- perf(diff): skip diff generation for identical file contents by @PeterDaveHello in #3688
- perf: avoid repeated prefix copies when rendering diff hunks by @PeterDaveHello in #3661
- perf(diff): avoid materializing lines when stripping metadata by @PeterDaveHello in #3659
- perf(context): optimize markdown fence selection by @PeterDaveHello in #3592
- perf(diff): use set membership when packing remaining files by @PeterDaveHello in #3591
📚 Documentation
- docs: add kapa.ai "Ask AI" widget by @naorpeled in #3777
- docs(github): clarify fork PR checkout and token behavior by @PeterDaveHello in #3691
- docs: add a maintainers page by @naorpeled in #3738
- docs: change Qodo logo width from 300 to 150 by @naorpeled in #3716
- docs: migrate documentation from MkDocs to Docusaurus by @naorpeled in #3713
- docs: fix GitHub suggestion-count configuration examples by @teachershuang in #3337
- docs: add Gerrit and CodeCommit to the features table by @HarshRajSinghania in #3588
🧹 Maintenance
- chore: remove unused date and inline-comment helpers by @PeterDaveHello in #3803
- chore(deps): address urllib3 and virtualenv security advisories by @PeterDaveHello in #3804
- chore(deps): bump PyJWT from 2.13.0 to 2.15.1 for security fixes by @PeterDaveHello in #3805
- chore: remove redundant CLAUDE.md pointer file by @PeterDaveHello in #3760
- chore(docs): apply security patches with
npm audit fixby @PeterDaveHello in #3790 - chore(docs): remove unused direct clsx dependency by @PeterDaveHello in #3789
- fix(action): share GitHub helpers so the Action keeps the #3670 /ask fix by @Yoel-qin in #3785
- chore: fix ruff rule E402 B027 by @even-even in #3772
- chore: clean up LiteLLM compatibility notes for future upgrades by @PeterDaveHello in #3764
- refactor(git-providers): share code suggestion publishing by @OUAO-FRANK in #3726
- chore(deps): Upgrade LiteLLM to the latest stable v1.103.0 by @PeterDaveHello in #3754
- chore(docs): Raise Node.js minimum version from v20 to v22 by @PeterDaveHello in #3730
- chore(deps): Apply npm audit fix to the docs lockfile by @PeterDaveHello in #3734
- chore(ci): bump actions/setup-node from 4.4.0 to 7.0.0 in the actions-major group across 1 directory by @dependabot[bot] in #3720
- chore(ci): bump the actions-minor-and-patch group across 1 directory with 4 updates by @dependabot[bot] in #3719
- refactor(git_providers): share code-suggestion thread context across providers by @bernalalexis-try in #3689
- chore(models): drop retired o1-preview temperature override by @PeterDaveHello in #3677
- chore: fix E501 ruff rule part2 (final) by @even-even in #3606
- chore(models): remove retired OpenAI, Claude, and Gemini entries by @PeterDaveHello in #3665
- refactor(ai_handlers): derive temperature support from litellm metadata and retire NO_SUPPORT_TEMPERATURE_MODELS by @utsab345 in #3619
- chore(deps): Upgrade LiteLLM to the latest stable v1.102.1 by @PeterDaveHello in #3663
- chore(deps): bump litellm to 1.102.0 by @utsab345 in #3617
- chore(deps): upgrade tiktoken to 0.14.0 and refresh uv lockfile by @PeterDaveHello in #3656
- refactor(litellm_ai_handler): deduplicate repeated logic by @high-tail in #3587
- chore(ci): bump the actions-minor-and-patch group with 6 updates by @dependabot[bot] in #3594
- chore(ci): align native test checkout action with v7.0.1 by @PeterDaveHello in #3593
⬆️ Dependencies
- chore(ci): bump actions/setup-node from 4.4.0 to 7.0.0 in the actions-major group across 1 directory by @dependabot[bot] in #3720
- chore(ci): bump the actions-minor-and-patch group across 1 directory with 4 updates by @dependabot[bot] in #3719
- chore(ci): bump the actions-minor-and-patch group with 6 updates by @dependabot[bot] in #3594
Full Changelog: v0.46.0...v0.47.0
AI summary New PR auto-acknowledgment and GitLab ticket fixes
What's Changed
🚀 Features
- feat(status): acknowledge a pull request the moment automatic commands start by @dwin-gharibi in #3091
- feat(gitlab): content-based auto-resolve for fixed inline threads by @Nie1iX in #3478
- feat(tickets): make description issue matching configurable by @utsab345 in #3385
- feat: register Grok 4.3 reasoning effort by @deadpool-mjpatel4444 in #3425
- feat(context): load repo-context files from sibling repos (same namespace/owner) by @utsab345 in #3362
- feat: add typed prompt output models by @utsab345 in #3371
- feat: per-directory .pr_agent.toml for monorepo settings by @utsab345 in #3282
- feat(improve): recover failed chunks with fallback models by @junnhwan in #3324
- feat(jira): add project-key allowlist to skip lookups for key-shaped noise by @Fayupable in #3304
- feat: add Jira ticket-context support by @dellch in #2420
- feat(telemetry): expose a native prometheus scrape endpoint by @utsab345 in #3238
- feat: generalize org-level settings to all providers via get_owning_namespace by @utsab345 in #3143
- feat(models): route small pull requests to a cheaper primary model by @ylcn91 in #3104
- feat(artifacts): read the CI artifact context from the CLI as well by @ylcn91 in #3105
- feat(models): add Claude Fable 5.1 support by @PeterDaveHello in #3101
- feat(models): add OpenAI GPT-6 Astra support by @PeterDaveHello in #3087
- feat(push_outputs): route describe and improve output to the configured sinks by @dwin-gharibi in #3098
- fix(tickets): bound the shorthand issue-number match at six digits, matching the branch pattern by @dwin-gharibi in #3082
- feat(reactions): configurable start and outcome reactions by @dwin-gharibi in #3089
- feat(review): publish sanitized failure reasons by @elijahchancey in #2996
🐛 Bug Fixes
- fix: check pinecone upsert response by @utsab345 in #3561
- fix: preserve quoting in CLI and configured Action commands by @oleksii-tumanov in #3585
- fix(github): send label names to the set-labels endpoint by @utsab345 in #3582
- fix: point shipped docs links at live targets by @utsab345 in #3556
- fix(diff): preserve source lines containing EOF marker text by @PeterDaveHello in #3572
- fix(codecommit): apply ignore rules and read .pr_agent.toml from the destination commit by @PeterDaveHello in #3576
- fix(polling): log worker capacity waits by @PeterDaveHello in #3574
- fix(similar_issue): treat a blank qdrant url as unset by @utsab345 in #3551
- fix(similar_issue): honor max issues scan limit by @mote24405-coder in #3565
- fix(similar_issue): let a second repository join an existing lancedb table by @utsab345 in #3563
- fix(similar_issue): make lancedb search and ingest match the other backends by @utsab345 in #3562
- fix: namespace pinecone similar issue by @utsab345 in #3560
- fix(similar_issue): stop lancedb duplicating the sentinel row by @utsab345 in #3558
- fix(similar_issue): keep the best hit per issue so the comment lists stay aligned by @utsab345 in #3557
- fix(similar_issue): list all lancedb tables instead of the deprecated 10-name call by @utsab345 in #3553
- fix: preserve generated changelog after write failures by @oleksii-tumanov in #3529
- fix(similar_issue): skip null comment bodies before splitting by @utsab345 in #3549
- fix: resolve the PR head SHA through a provider hook (#3431) by @sloemo01 in #3528
- fix: invert lancedb ingest table check by @utsab345 in #3531
- fix(gitlab): narrow broad exception handlers in the GitLab provider by @wfatih in #3525
- fix(gpt5): clamp reasoning_effort 'max' where xhigh is unsupported by @auroraxo in #3273
- fix: redact sensitive AWS Secrets Manager error logs by @PeterDaveHello in #3512
- fix(tests): validate Gitea E2E file writes and tool results by @PeterDaveHello in #3513
- fix: keep tags in reasoning support probe by @utsab345 in #3502
- fix(litellm): support adaptive thinking for profile ARNs by @rajin-khan in #3497
- fix(github-action): propagate command failure status by @Sanchar127 in #3486
- fix(bitbucket): surface source write failures by @oleksii-tumanov in #3500
- fix(suggestions): allow required imports in improvements by @noooooooookro in #3169
- fix: prevent changelog overwrite after read failures by @oleksii-tumanov in #3495
- fix: derive reasoning_effort support from litellm metadata (#3480) by @utsab345 in #3485
- fix(azure): retry renamed files at incremental checkpoint by @oleksii-tumanov in #3489
- fix(gitlab): migrate to paginated merge request diffs (GitLab 15.7 or later) by @oleksii-tumanov in #3491
- fix(codecommit): use merge base for analysis by @oleksii-tumanov in #3493
- fix(bitbucket): split raw diffs at file headers by @oleksii-tumanov in #3492
- fix: redact AWS credential discovery errors from logs by @PeterDaveHello in #3487
- fix(github): surface incomplete file-set errors by @oleksii-tumanov in #3488
- fix(azure): preserve original content for renamed files by @oleksii-tumanov in #3465
- fix(github): pass event=COMMENT to create_review so inline reviews are not left PENDING by @utsab345 in #3482
- fix(config): honor reasoning_effort for OpenAI-compatible endpoints by @utsab345 in #3460
- fix(azure): render /improve suggestions as a diff block by @utsab345 in #3424
- fix(config): fence description_issue_regex as host-only by @utsab345 in #3476
- fix(tests): use Gitea branch API in E2E test by @PeterDaveHello in #3481
- fix(github): apply ignore filters to incremental file views by @PeterDaveHello in #3447
- fix: remove orphaned claude-3-5-sonnet MAX_TOKENS entry by @utsab345 in #3471
- fix(github): reject incomplete pull request file lists by @oleksii-tumanov in #3467
- fix(azure): collect complete pull request changes by @oleksii-tumanov in #3463
- fix(docs): keep persistent_inline_comments meaning in config reference by @TianHengZhuang in #3455
- fix(gitlab): honor --config-branch / PR_AGENT_CONFIG_BRANCH when loading .pr_agent.toml by @JokeWaumans in #3453
- fix(models): ignore empty fallback entries by @deadpool-mjpatel4444 in #3444
- fix(local-git): use new path for renamed files by @deadpool-mjpatel4444 in #3442
- fix(azure): preserve nested source branch names by @deadpool-mjpatel4444 in #3440
- fix(config): detect Git worktree roots by @deadpool-mjpatel4444 in #3437
- fix: remove dead claude-3-5-sonnet model shortcut by @utsab345 in #3458
- fix(review): apply the security label using the same predicate as the review body by @utsab345 in #3419
- fix(providers): url-encode branch names in git provider links by @utsab345 in #3422
- fix: fit final prompts per model attempt by @oleksii-tumanov in #3395
- fix: prepare AWS credentials off the event loop by @PeterDaveHello in #3380
- fix(polling): isolate per-comment settings via request_cycle_context by @utsab345 in #3430
- fix(gitlab): preserve context lines in suggestions by @noooooooookro in #3168
- fix(improve): require complete improved_code without ellipsis by @utsab345 in #3421
- fix(labels): gate get_pr_labels behind get_labels support by @utsab345 in #3420
- fix(github): use committer date for incremental review commit range after rebase by @utsab345 in #3417
- fix: retry only failed chunks in large PR reviews by @utsab345 in #3402
- fix(add_docs): clear the progress comment and report when no documentation was produced by @dwin-gharibi in #2915
- fix(security): scrub provider tokens from cloned repositories by @utsab345 in #3398
- fix(bitbucket): enable inline key issue deduplication by @utsab345 in #3387
- fix: budget diff packing per model attempt by @oleksii-tumanov in #3389
- fix: correct MAX_TOKENS entries understating LiteLLM's context window (#3196) by @MostafaHassanzadeh in #3329
- fix(labels): validate output inside model attempts by @oleksii-tumanov in #3393
- fix(bitbucket): hide review and suggestion identity markers by @utsab345 in #3386
- fix: package help documentation corpus by @oleksii-tumanov in #3351
- fix(security): keep Bitbucket Server bearer tokens out of argv by @utsab345 in #3391
- fix: preserve /help answers with malformed citations by @oleksii-tumanov in #3343
- fix(gitlab): resolve relative submodule URLs and read .gitmodules at the MR head by @JokeWaumans in #3379
- fix(bitbucket): send inline comment ranges with start_to by @MaxFreedomPollard in #3384
- fix(github): report command failures in outcome reactions by @junnhwan in #3171
- fix: validate review model responses by @utsab345 in #3372
- fix: bound and redact the MOSAICO health probe by @PeterDaveHello in #3378
- fix(github-app): add opt-in webhook delivery deduplication by @junnhwan in #3374
- fix(review): retry malformed responses with fallback models by @taljeon in #3359
- fix(reviewer): make the prompt examples agree with the types they declare by @L4XB in #3366
- fix: delete Bitbucket Server comments by @utsab345 in #3376
- fix(cli): report propagated request failures by @oleksii-tumanov in #3368
- fix(improve): don't publish empty suggestions when anchors are unresolved by @utsab345 in #3353
- fix: correct /help project identity by @oleksii-tumanov in #3367
- fix(help_docs): isolate malformed model rows by @oleksii-tumanov in #3365
- fix(bitbucket): load repo PR commands before dispatch by @oleksii-tumanov in #3350
- fix: load repo settings before push automation by @oleksii-tumanov in #3347
- fix(bitbucket): return empty languages when repo has none by @utsab345 in #3341
- fix(ask): keep image blocks for user-message-only models by @utsab345 in #3339
- fix(review): align ticket compliance prompt examples by @oleksii-tumanov in #3326
- fix(algo): skip non-unified hunk headers when anchoring lines by @utsab345 in #3345
- fix: remove dead configuration keys with no reader by @utsab345 in #3279
- fix(review): preserve resolved finding markdown by @be-student in #3092
- fix(azure): return language names from get_languages by @utsab345 in #3334
- fix(reviewer): normalize aware commit dates in incremental review by @utsab345 in #3336
- fix(push_outputs): isolate destination failures by @oleksii-tumanov in #3307
- fix(help): fit prompts for each attempted model by @oleksii-tumanov in #3308
- fix(add_docs): align prompt example field by @oleksii-tumanov in #3325
- fix: build real Bitbucket Server language map and ignore non-numeric language entries by @MostafaHassanzadeh in #2985
- fix(cli): validate output artifact options by @oleksii-tumanov in #3289
- fix: point runtime documentation links to current site by @oleksii-tumanov in #3281
- fix(codecommit): cap comment bodies at the PostCommentForPullRequest limit by @L4XB in #3280
- fix(help): allow question mode without an OpenAI key by @oleksii-tumanov in #3262
- fix: stop dropping the changes walkthrough via dead inline_file_summary by @utsab345 in #3150
- fix(improve): keep fallback suggestions in artifacts by @oleksii-tumanov in #3301
- fix(plain-diff): preserve partial suggestion output by @oleksii-tumanov in #3287
- fix: keep truncated comments within character limit by @oleksii-tumanov in #3258
- fix(providers): make the base persistent comment actually persist by @auroraxo in #3254
- fix: key repo-context cache on the fetched revision by @utsab345 in #3149
- fix: isolate LiteLLM provider credentials per request by @PeterDaveHello in #2999
- fix(gpt5): map reasoning_effort 'max' to 'xhigh' for OpenAI models by @auroraxo in #3259
- fix: drop a sign-off the model adds after the closing fence by @Carlos0196 in #3243
- fix(codecommit): update persistent review comments by @oleksii-tumanov in #3158
- fix(help): try fallback models after completion failures by @oleksii-tumanov in #3266
- fix(tickets): match hyphens and periods in cross-repo issue references by @auroraxo in #3264
- fix(claude): warn when thinking is enabled but no model in the chain matches by @utsab345 in #3235
- fix(similar_issue): port pinecone backend to the current SDK by @utsab345 in #3227
- fix(release): keep uv.lock in sync with version bumps by @PeterDaveHello in #3214
- fix(github): report total inline suggestion fallback failure by @yashaskn8 in #3232
- fix(review): preserve findings after failed chunks by @junnhwan in #3229
- fix(bitbucket): restore persistent comment links by @junnhwan in #3226
- fix(providers): report code-suggestion publication failure by @auroraxo in #3219
- fix(deps): declare certifi as a range per the security-pin policy by @7487 in #3204
- fix(describe): retain successful chunks after partial failure by @oleksii-tumanov in #3163
- fix(polling): bound active workers across polling iterations by @PeterDaveHello in #3063
- fix(bitbucket): align persistent comments with shared implementation by @Sanchar127 in #3155
- fix(mosaico): support A2A task cancellation by @junnhwan in #3166
- fix(bitbucket-server): preserve personal repository context path by @oleksii-tumanov in #3164
- fix(diff): count compressed file wrappers before admission by @oleksii-tumanov in #3162
- fix(gitlab): run the push half when a draft-ready update carries commits by @shaurya703 in #3120
- fix(github): construct the default IncrementalPR per call by @shaurya703 in #3121
- fix(servers): share push-trigger deduplication across five providers by @CunjieLee in #3151
- fix: resolve token limits for legacy GPT-5.x _thinking aliases by @PeterDaveHello in #3054
- fix: enable Azure DevOps thread resolution by @Ricky-7-Yan in #3146
- fix: hide disabled commands from help output by @Tiancheng-Xu in #3142
- fix: honor GitLab /ask_line old-side positions by @Tiancheng-Xu in #3141
- fix(bitbucket): resolve line text in publish_inline_comment like the other providers by @7487 in #3136
- fix(improve): preserve quoted file headings by @oleksii-tumanov in #3134
- fix(bitbucket): align publish_inline_comment signature with GitProvider base by @auroraxo in #3126
- fix(mosaico): parse supplied diff paths containing " b/" by @junnhwan in #3125
- Fix: use logger instead of print() in file_filter exception handler by @Fayupable in #3115
- fix(ask): bound image URL liveness probes by @junnhwan in #3107
- fix(review): keep a finding's line breaks in the resolved section by @dwin-gharibi in #3086
- fix(pr_agent/algo/utils.py): strip a closing fence only when it sits at column 0 by @dwin-gharibi in #2913
- fix(polling): avoid blocking HTTP in notification fallback by @PeterDaveHello in #3064
- fix(diff): compare bad file extensions case-insensitively by @MaxFreedomPollard in #3103
- fix(review): keep the persistent review when the agent identity is unproven by @dwin-gharibi in #3072
- fix(diff): exclude file headers from numbered hunks by @oleksii-tumanov in #3069
- fix: surface description publication failures by @Ricky-7-Yan in #3065
- fix(review): keep the persistent state marker inside its HTML comment by @dwin-gharibi in #3078
- fix(log): attach structured payloads without reformatting the message by @dwin-gharibi in #3074
- fix(changelog): remove a wrapping code fence without stripping backticks by @dwin-gharibi in #3084
- fix(review): flatten chunked findings fields the model returned as a list by @dwin-gharibi in #3080
- fix(github): read ignore_bot_pr from the [github] section where it is set by @bunnysayzz in #3068
- fix(gitea): apply repo-level ignore rules at diff time by @bunnysayzz in #3066
- fix(bitbucket-server): update persistent reviews in place by @oleksii-tumanov in #3052
- fix(pr_agent/agent/pr_agent.py): validating auto command arguments by @dwin-gharibi in #2911
- fix(improve): report exhausted suggestion publication retries by @be-student in #3062
- fix: keep stray braces out of YAML block scalars by @Fnine59 in #3061
- fix(review): avoid publishing empty review output by @oleksii-tumanov in #3030
- fix(pr_agent/algo/ai_handlers/litellm_helpers.py): coercing the repetition penalty by @dwin-gharibi in #2921
- fix(pr_agent/algo/ai_handlers/litellm_helpers.py): raising a retryable error on an empty stream by @dwin-gharibi in #2907
- fix(pr_agent/tools/pr_generate_labels.py): reading a label entry that is not a string by @dwin-gharibi in #2919
- fix(pr_agent/tools/pr_code_suggestions.py): coercing the suggestion score thresholds by @dwin-gharibi in #2917
- fix(pr_agent/algo/utils.py): rendering todo sections returned as free text by @dwin-gharibi in #2901
- fix(pr_agent/algo/utils.py): rendering security concerns returned as a list by @dwin-gharibi in #2899
⚡ Performance
- perf(gitea): skip unused head content fetches by @PeterDaveHello in #3569
- perf(tokens): reuse compiled templates during prompt fitting by @PeterDaveHello in #3570
- perf(gitlab): cache project languages per provider by @PeterDaveHello in #3451
- perf(local): reuse cached diff files by @PeterDaveHello in #3449
- perf(github): skip impossible file content reads by @PeterDaveHello in #3249
- perf(gitlab): fetch only the latest diff version by @PeterDaveHello in #3248
- perf(gitlab): skip unused project metadata during ticket extraction by @junnhwan in #3322
- perf(tickets): fetch Asana task context concurrently by @junnhwan in #3293
- perf(review): reuse prepared diff chunks by @junnhwan in #3291
- perf(gitlab): avoid redundant project fetches for file reads by @PeterDaveHello in #3247
📚 Documentation
- docs: fix features table to match the code by @utsab345 in #3555
- docs: document similar_issue backend re-run behaviour by @utsab345 in #3550
- docs: point blog links at the qodo.ai host by @utsab345 in #3554
- docs: remove dead Google Tag Manager snippets by @deadpool-mjpatel4444 in #3428
- docs: remove unsupported Bitbucket organization settings by @xuu33030 in #3416
- docs: remove unsupported ignore_ticket_labels setting by @keii-2596 in #3369
- docs: drop dead large-PRs link from usage index by @utsab345 in #3342
- docs(review): correct ticket-compliance documentation by @swayamg20 in #3330
- docs: add an Atlas Cloud section to changing_a_model by @binyangzhu000-sudo in #3037
- docs(similar_issue): refresh page with experimental status and backend caveats by @utsab345 in #3277
- docs: document custom CA and self-signed certificate configuration by @utsab345 in #3275
- docs: self-host the documentation images by @auroraxo in #3257
- docs: document GitHub Copilot as a custom model provider by @utsab345 in #3241
- docs: repair four dead outbound links by @auroraxo in #3270
- docs: document the [push_outputs] feature by @utsab345 in #3210
- docs: remove stale best practices guidance by @macjayz in #3202
- docs: correct stale and inaccurate documentation and comments by @PeterDaveHello in #3250
- docs: add a complete configuration reference covering every option by @utsab345 in #3217
- docs: add a documentation page for the MOSAICO A2A server by @utsab345 in #3234
- docs: drop stale README release entries by @Shaisolaris in #3208
- docs: fix automations note to reflect self-hosted deployments by @shashankvarma499 in #3201
- docs: fix Gitlab casing to GitLab in user-facing prose by @PeterDaveHello in #3152
- docs: fix Github casing to GitHub in user-facing prose by @PeterDaveHello in #3070
🧹 Maintenance
- test(litellm_openrouter_controls): fixed broken ut which now is suppo… by @high-tail in #3584
- refactor(algo): extract run reporting to run_output (3/3) (#3511) by @azhar22k in #3522
- chore: fix E501 ruff rule part1 by @even-even in #3517
- test(gitea): cover signed comment webhook dispatch by @PeterDaveHello in #3575
- refactor: lazy-load git provider integrations by @NesrineGharbi77 in #3527
- test(servers): drive all five webhook servers through one filtering contract by @wfatih in #3532
- refactor: extract cloud-credential plumbing into cloud_auth by @utsab345 in #3518
- refactor(algo): extract token arithmetic to token_budget (2/3) (#3511) by @azhar22k in #3521
- chore(deps): update AnyIO to 4.14.2 and GitPython to 3.1.62 by @PeterDaveHello in #3526
- refactor: deduplicate should_process_pr_logic across webhook servers (#3506) by @azhar22k in #3516
- refactor(algo): extract comment identity to dedicated module (1/3) (#3511) by @azhar22k in #3519
- chore(ci): scope Release Drafter permissions by event by @PeterDaveHello in #3520
- test: pin Gemini 3.x ids through the reasoning-effort metadata probe (from #2998) by @utsab345 in #3504
- chore(ci): add Python 3.14 to the native unit-test matrix by @PeterDaveHello in #3514
- chore(ci): migrate Release Drafter v7 config by @PeterDaveHello in #3515
- chore(lambda): bump Python to v3.14 base and mangum to v0.22.0 by @PeterDaveHello in #3505
- refactor: remove 29 unreachable definitions by @rajin-khan in #3499
- chore(ci): migrate Release Drafter to v7 by @PeterDaveHello in #3484
- chore: unskip B011 ruff rule by @even-even in #3456
- ci: pin litellm cost map to local bundle to stabilise tests by @utsab345 in #3475
- chore: up loguru to 0.7.3 by @even-even in #3429
- chore(ci): run the unit suite on Python 3.12 and 3.13 by @7487 in #3209
- chore(deps): Upgrade LiteLLM to the latest stable v1.101.0 by @PeterDaveHello in #3404
- chore: unskip F841 ruff rule by @even-even in #3403
- chore(ci): bump the actions-minor-and-patch group with 3 updates by @dependabot[bot] in #3382
- chore: up dynaconf to 3.3.5 and fixes warns by @even-even in #3300
- test(tools): pin the git-provider capability contract for callers by @AmirF194 in #3361
- ci: smoke-run /describe on a real GitHub PR by @utsab345 in #3358
- refactor(litellm_ai_handler): deduplicate config coercion, API key capture, and AWS region resolution by @high-tail in #3320
- chore(ci): bump the actions-major group with 11 updates by @dependabot[bot] in #3297
- chore(docker): bump python from 3.12.14-slim to 3.14.7-slim in /docker by @dependabot[bot] in #3294
- chore(ci): bump pypa/gh-action-pypi-publish from 1.14.0 to 1.14.2 in the actions-minor-and-patch group by @dependabot[bot] in #3296
- chore(ci): pin release-drafter to the v6.4.0 commit rather than its tag object by @dependabot[bot] in #3298
- chore(ci): add Dependabot version updates by @auroraxo in #3278
- refactor(tickets): select ticket extraction by provider capability by @auroraxo in #3251
- refactor: drop MAX_TOKENS entries that exactly duplicate LiteLLM by @utsab345 in #3220
- test(contract): carry the suggestion outcome invariant in the table by @auroraxo in #3276
- refactor(changelog): select changelog review by provider capability by @auroraxo in #3246
- refactor(describe): select help text by provider capability by @auroraxo in #3244
- chore: burn down the first five rules in the ruff lint.ignore ledger by @utsab345 in #3207
- refactor(similar_issue): select issue indexing by provider capability by @auroraxo in #3253
- test(docs): guard mkdocs and GitBook navs against drift by @Mihailchik in #3231
- chore(github): upgrade PyGithub to 2.x and migrate off deprecated auth classes by @utsab345 in #3240
- chore: optimize list(x.values) -> x.to_list() pandas by @even-even in #3233
- refactor: remove 14 dead functions in the tool layer (#3182) by @utsab345 in #3236
- ci: verify uv.lock freshness by @PeterDaveHello in #3245
- refactor: select PR chat link by provider capability by @auroraxo in #3239
- Harden Dockerfiles for stable and predictable builds by @PeterDaveHello in #3218
- refactor(help): select help rendering by provider capability by @7487 in #3213
- test(providers): enforce capability predicate truth by @auroraxo in #3156
- chore: pin uv 0.12.10 in pyproject.toml by @PeterDaveHello in #3153
- ci: run the pre-commit workflow on pull requests by @utsab345 in #3212
- chore(deps): update yanked Python dependencies by @PeterDaveHello in #3211
- TYP: ship a py.typed marker for PEP 561 compliance by @utsab345 in #3205
- chore: remove dead bandit configuration by @asarakhatun17-lgtm in #3203
- chore(deps): bump pytest to 9.1.1 and clear the parametrize deprecation by @even-even in #3172
- test(github_app): pin ignore_bot_pr's section and the legacy override by @shaurya703 in #3123
- chore(deps): upgrade LiteLLM to v1.100.0 by @PeterDaveHello in #3154
- refactor: remove dead shared rate-limit handlers by @Tiancheng-Xu in #3140
- chore: up uv 0.9.7 to 0.12.10 in dockerfiles by @even-even in #3102
- refactor: centralize primary command descriptions by @Ricky-7-Yan in #3048
- refactor: centralize automatic PR command profiles by @swayamg20 in #3059
⬆️ Dependencies
- chore(ci): bump the actions-minor-and-patch group with 3 updates by @dependabot[bot] in #3382
- chore(ci): bump the actions-major group with 11 updates by @dependabot[bot] in #3297
- chore(docker): bump python from 3.12.14-slim to 3.14.7-slim in /docker by @dependabot[bot] in #3294
- chore(ci): bump pypa/gh-action-pypi-publish from 1.14.0 to 1.14.2 in the actions-minor-and-patch group by @dependabot[bot] in #3296
- chore(ci): pin release-drafter to the v6.4.0 commit rather than its tag object by @dependabot[bot] in #3298
Full Changelog: v0.45.0...v0.46.0
@ Every self-hosted release, weekly
One Monday email with the week's stable releases across the directory.
FAQ
Can the 'Review effort' feedback be calibrated or customized?
Yes, review effort estimates can be customized via the extra_instructions option; effort levels 1-5 are meant as comparative signals rather than exact durations.
Can PR-Agent review draft/offline PRs?
Yes. Draft PRs aren't reviewed automatically by default, but you can enable it with the feedback_on_draft_pr parameter or manually request feedback by commenting.
Will you store my code? Are you using my code to train models?
No. PR-Agent's strict privacy policy ensures code is not stored or used for training purposes.
How can I get more tailored suggestions?
Use the extra_instructions and best_practices configuration options to guide the model toward suggestions that fit the project's needs.
I received an incorrect or irrelevant suggestion. Why?
AI models are improving rapidly but remain imperfect, so suggestions should be critically evaluated; the hierarchical structure helps you quickly decide which suggestions are relevant.
Can PR-Agent serve as a substitute for a human reviewer?
No — it is designed to assist, not replace, human reviewers, with safeguards such as never approving PRs itself and preserving the user's original PR header.
More in Code Review
ProvalSelf-hosted AI code reviewer for GitLab, Forgejo, and GitHub that runs on your own hardware with any LLM you choose, including local models via Ollama or llama.cpp.
Review BoardOpen-source, self-hosted code review platform with advanced diff viewer, document/image review, flexible workflows, and Git/SVN/Perforce integrations.
SonarQubeSelf-hosted, open-source static analysis server: finds bugs, vulnerabilities, code smells and coverage gaps across 21 languages, with quality gates and CI integration.
twinnyOpen-source VS Code extension for AI coding with local models. Code completion, chat, inline edits, and reviews run on your infrastructure. No telemetry or accounts.
WhiteboardSelf-hosted desktop canvas where coding agents draw architecture-level reviews of diffs. Open-source MIT: AST-based semantic diffs, diagrams linked to code.
AI-Git-BotSelf-hosted AI automation for Git repositories that handles PR reviews, test creation, issue improvement, and code generation across major Git platforms.
CodraCodra is a self-hosted, open-source AI code review engine on Cloudflare Workers that posts inline comments on GitHub PRs using configurable LLM providers.
GerritOpen-source, self-hosted code review and Git repository management server: patchset reviews, fine-grained permissions, plugins, REST API and webhooks.
gitbucketA self-hosted, open-source Git platform in Scala: run one war file on Java 17 for repos, issues, pull requests, wiki, LDAP/OIDC logins and GitHub-compatible APIs.
kodusSelf-hosted AI code review for major Git platforms. Bring your own LLM keys with zero markup. AGPL core with enterprise features.
mergeableMergeable is a self-hosted, open-source GitHub PR inbox with customizable search-based sections, local browser storage, and multi-instance support.
MiraSelf-hosted AI code reviewer for GitHub, GitLab, Forgejo with your LLM key. Code indexing, vuln scanning, custom rules, learning loop, dashboard — free.



0 comments