Doramagic Project Pack · Human Manual

codereviewbuddy

Related topics: Entrypoints and Runtime Surface, Architecture Evidence Map, Operations and Verification Boundaries

Repository Overview

Related topics: Entrypoints and Runtime Surface, Architecture Evidence Map, Operations and Verification Boundaries

Section Related Pages

Continue reading this section for the full explanation and source context.

Section Review comment management

Continue reading this section for the full explanation and source context.

Section CI & stack diagnosis

Continue reading this section for the full explanation and source context.

Section Agent experience

Continue reading this section for the full explanation and source context.

Related topics: Entrypoints and Runtime Surface, Architecture Evidence Map, Operations and Verification Boundaries

Repository Overview

This page is generated from repository evidence because the Human Wiki provider was unavailable. It intentionally limits itself to README and file-tree facts.

README Evidence

<!-- mcp-name: io.github.detailobsessed/codereviewbuddy -->

codereviewbuddy

![ci](https://github.com/detailobsessed/codereviewbuddy/actions?query=workflow%3Aci) ![release](https://github.com/detailobsessed/codereviewbuddy/releases) ![documentation](https://detailobsessed.github.io/codereviewbuddy/) ![Python 3.14+](https://www.python.org/downloads/) ![FastMCP v3](https://github.com/jlowin/fastmcp)

An MCP server that helps your AI coding agent manage PR review comments from any AI reviewer that uses GitHub's PR review infrastructure.

Features

Review comment management

  • Triage review commentstriage_review_comments filters to only actionable inline threads and includes direct GitHub URLs for each comment
  • Get thread detailsget_thread fetches full conversation history for any thread by node ID
  • Reply to anything — inline review threads (PRRT_), PR-level reviews (PRR_), and bot issue comments (IC_) all routed to the correct GitHub API

CI & stack diagnosis

  • Diagnose CI failuresdiagnose_ci collapses 3-5 sequential gh commands into one call: finds the failed run, identifies failed jobs/steps, and extracts actionable error lines
  • Stack activity feedstack_activity shows a chronological timeline of pushes, reviews, labels, merges across all PRs in a stack with a settled flag for deciding when to proceed
  • Scan merged PRslist_recent_unresolved catches late review comments on already-merged PRs

Agent experience

  • Recovery-guided errors — every tool handler classifies errors (auth, rate limit, not found, workspace, GraphQL, config) and returns actionable recovery hints so agents self-correct instead of retrying blindly
  • Next-action hints — tool responses include next_steps suggestions guiding agents to the right follow-up tool call
  • Empty result messages — when results are empty, responses explain why and suggest what to try next
  • GUI URLs — triage items include comment_url so agents can link users directly to the comment on GitHub
  • **Tool classification tag

[excerpt truncated]

Selected Source Inventory

FileEvidence roleSize
README.mdREADME/product and usage evidence11281 bytes
pyproject.tomlpackage/runtime metadata9660 bytes
src/codereviewbuddy/__init__.pyimplementation surface23 bytes
src/codereviewbuddy/_instance.pyimplementation surface3810 bytes
src/codereviewbuddy/cache.pyimplementation surface1924 bytes
src/codereviewbuddy/cli.pyimplementation surface5536 bytes
src/codereviewbuddy/config.pyimplementation surface3724 bytes
src/codereviewbuddy/gh.pyimplementation surface8036 bytes
src/codereviewbuddy/github_api.pyimplementation surface13054 bytes
src/codereviewbuddy/install.pyimplementation surface13065 bytes
src/codereviewbuddy/models.pyimplementation surface10590 bytes
src/codereviewbuddy/server.pyimplementation surface30518 bytes

Source: README.md:1-120

Source: https://github.com/detailobsessed/codereviewbuddy / Human Manual

Entrypoints and Runtime Surface

Related topics: Repository Overview, Architecture Evidence Map, Operations and Verification Boundaries

Section Related Pages

Continue reading this section for the full explanation and source context.

Related topics: Repository Overview, Architecture Evidence Map, Operations and Verification Boundaries

Entrypoints and Runtime Surface

The files below are the highest-signal candidates for how the project is installed, started, configured, or embedded. Treat this as an evidence map, not an inferred API contract.

FileEvidence roleSize
README.mdREADME/product and usage evidence11281 bytes
pyproject.tomlpackage/runtime metadata9660 bytes
src/codereviewbuddy/__init__.pyimplementation surface23 bytes
src/codereviewbuddy/_instance.pyimplementation surface3810 bytes
src/codereviewbuddy/cache.pyimplementation surface1924 bytes
src/codereviewbuddy/cli.pyimplementation surface5536 bytes
src/codereviewbuddy/config.pyimplementation surface3724 bytes
src/codereviewbuddy/gh.pyimplementation surface8036 bytes
src/codereviewbuddy/github_api.pyimplementation surface13054 bytes
src/codereviewbuddy/install.pyimplementation surface13065 bytes
src/codereviewbuddy/models.pyimplementation surface10590 bytes
src/codereviewbuddy/server.pyimplementation surface30518 bytes

Source: README.md:1-120

Source: https://github.com/detailobsessed/codereviewbuddy / Human Manual

Architecture Evidence Map

Related topics: Repository Overview, Entrypoints and Runtime Surface, Operations and Verification Boundaries

Section Related Pages

Continue reading this section for the full explanation and source context.

Related topics: Repository Overview, Entrypoints and Runtime Surface, Operations and Verification Boundaries

Architecture Evidence Map

This section maps source paths into likely architectural areas based on repository layout only. Claims that require execution are intentionally not made here.

Source: pyproject.toml:1-120

Source: https://github.com/detailobsessed/codereviewbuddy / Human Manual

Operations and Verification Boundaries

Related topics: Repository Overview, Entrypoints and Runtime Surface, Architecture Evidence Map

Section Related Pages

Continue reading this section for the full explanation and source context.

Related topics: Repository Overview, Entrypoints and Runtime Surface, Architecture Evidence Map

Operations and Verification Boundaries

Operational guidance is limited to files that are present in the repository. Before using this project in an agent workflow, verify install, quickstart, and runtime behavior in a sandbox.

Source: src/codereviewbuddy/__init__.py:1-120

Source: https://github.com/detailobsessed/codereviewbuddy / Human Manual

Doramagic Pitfall Log

Source-linked risks stay visible on the manual page so the preview does not read like a recommendation.

medium README/documentation is current enough for a first validation pass.

The project should not be treated as fully validated until this signal is reviewed.

medium Maintainer activity is unknown

Users cannot judge support quality until recent activity, releases, and issue response are checked.

medium no_demo

The project may affect permissions, credentials, data exposure, or host boundaries.

medium no_demo

The project may affect permissions, credentials, data exposure, or host boundaries.

Doramagic Pitfall Log

Doramagic extracted 6 source-linked risk signals. Review them before installing or handing real data to the project.

1. Capability assumption: README/documentation is current enough for a first validation pass.

  • Severity: medium
  • Finding: README/documentation is current enough for a first validation pass.
  • User impact: The project should not be treated as fully validated until this signal is reviewed.
  • Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
  • Evidence: capability.assumptions | mcp_registry:io.github.detailobsessed/codereviewbuddy:0.37.0 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.detailobsessed%2Fcodereviewbuddy/versions/0.37.0 | README/documentation is current enough for a first validation pass.

2. Maintenance risk: Maintainer activity is unknown

  • Severity: medium
  • Finding: Maintenance risk is backed by a source signal: Maintainer activity is unknown. Treat it as a review item until the current version is checked.
  • User impact: Users cannot judge support quality until recent activity, releases, and issue response are checked.
  • Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
  • Evidence: evidence.maintainer_signals | mcp_registry:io.github.detailobsessed/codereviewbuddy:0.37.0 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.detailobsessed%2Fcodereviewbuddy/versions/0.37.0 | last_activity_observed missing

3. Security or permission risk: no_demo

  • Severity: medium
  • Finding: no_demo
  • User impact: The project may affect permissions, credentials, data exposure, or host boundaries.
  • Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
  • Evidence: downstream_validation.risk_items | mcp_registry:io.github.detailobsessed/codereviewbuddy:0.37.0 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.detailobsessed%2Fcodereviewbuddy/versions/0.37.0 | no_demo; severity=medium

4. Security or permission risk: no_demo

  • Severity: medium
  • Finding: no_demo
  • User impact: The project may affect permissions, credentials, data exposure, or host boundaries.
  • Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
  • Evidence: risks.scoring_risks | mcp_registry:io.github.detailobsessed/codereviewbuddy:0.37.0 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.detailobsessed%2Fcodereviewbuddy/versions/0.37.0 | no_demo; severity=medium

5. Maintenance risk: issue_or_pr_quality=unknown

  • Severity: low
  • Finding: issue_or_pr_quality=unknown。
  • User impact: Users cannot judge support quality until recent activity, releases, and issue response are checked.
  • Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
  • Evidence: evidence.maintainer_signals | mcp_registry:io.github.detailobsessed/codereviewbuddy:0.37.0 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.detailobsessed%2Fcodereviewbuddy/versions/0.37.0 | issue_or_pr_quality=unknown

6. Maintenance risk: release_recency=unknown

  • Severity: low
  • Finding: release_recency=unknown。
  • User impact: Users cannot judge support quality until recent activity, releases, and issue response are checked.
  • Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
  • Evidence: evidence.maintainer_signals | mcp_registry:io.github.detailobsessed/codereviewbuddy:0.37.0 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.detailobsessed%2Fcodereviewbuddy/versions/0.37.0 | release_recency=unknown

Source: Doramagic discovery, validation, and Project Pack records

Community Discussion Evidence

These external discussion links are review inputs, not standalone proof that the project is production-ready.

Sources 9

Count of project-level external discussion links exposed on this manual page.

Use Review before install

Open the linked issues or discussions before treating the pack as ready for your environment.

Community Discussion Evidence

Doramagic exposes project-level community discussion separately from official documentation. Review these links before using codereviewbuddy with real data or production workflows.

Source: Project Pack community evidence and pitfall evidence