PHPackages                             matesofmate/self-review-extension - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. matesofmate/self-review-extension

ActiveSymfony-ai-mate[Utility & Helpers](/categories/utility)

matesofmate/self-review-extension
=================================

Human-in-the-loop code review extension for symfony/ai-mate

1115PHP

Since Mar 2Pushed 2mo agoCompare

[ Source](https://github.com/MatesOfMate/self-review-extension)[ Packagist](https://packagist.org/packages/matesofmate/self-review-extension)[ RSS](/packages/matesofmate-self-review-extension/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

Self-Review Extension
=====================

[](#self-review-extension)

> **Warning**Experimental development tool. Use at your own risk.

Human-in-the-loop code review extension for [Symfony AI Mate](https://github.com/symfony/ai-mate). AI agents can request code reviews from humans with a non-blocking, two-tool MCP pattern.

Features
--------

[](#features)

- **Two-phase review**: Start returns immediately (non-blocking), then poll for completion
- **Bidirectional chat**: Agent and reviewer can ask questions during review (blocks on responses)
- **Browser UI**: Diff viewer with inline comments and code suggestions
- **Token-efficient**: TOON format reduces output by 40-50%
- **Comment types**: question, issue, suggestion, praise, nitpick, blocker

Installation
------------

[](#installation)

```
composer require matesofmate/self-review-extension
vendor/bin/mate discover
```

Requirements
------------

[](#requirements)

- PHP 8.2+
- ext-pdo\_sqlite
- Git repository

MCP Tools
---------

[](#mcp-tools)

### `self-review-start`

[](#self-review-start)

Starts a review session and opens browser. Returns immediately (non-blocking).

**Parameters:**

- `base_ref` (string): Base git reference, default: `"HEAD"`
- `head_ref` (string): Head git reference, default: `"HEAD"`
- `paths` (array): Optional file paths to filter
- `context` (string): Context message shown to reviewer
- `staged` (bool): Review staged changes instead of refs

**Returns:** Session ID for checking results later

### `self-review-result`

[](#self-review-result)

Checks if review is complete and retrieves results. Polls for events (review submitted or new questions) until timeout.

**Parameters:**

- `session_id` (string): Session ID from `self-review-start`
- `timeout` (int): Max seconds to wait, default: 60

**Returns:** Review results, pending questions, or waiting status

### `self-review-chat`

[](#self-review-chat)

Gets pending questions from reviewer about the code changes.

**Parameters:**

- `session_id` (string): Session ID from `self-review-start`

**Returns:** Questions that need answers

### `self-review-answer`

[](#self-review-answer)

Submits answer to a reviewer question.

**Parameters:**

- `session_id` (string): Session ID
- `question_id` (int): Question ID from `self-review-chat`
- `answer` (string): Your answer

CLI Usage
---------

[](#cli-usage)

Standalone CLI for blocking code review (waits for completion):

```
# Review changes between main and HEAD
bin/self-review --base=main

# Review staged changes
bin/self-review --staged

# Review specific files
bin/self-review --path=src/Auth.php

# With context
bin/self-review --context="Please review the auth changes"
```

Main options: `--base`, `--head`, `--staged`, `--path`, `--context`, `--port`

**Note:** Chat is disabled in CLI mode since no agent is available to answer questions.

Development
-----------

[](#development)

```
composer install  # Install dependencies
composer test     # Run tests
composer lint     # Check quality
composer fix      # Fix code style
```

License
-------

[](#license)

MIT License - see [LICENSE](LICENSE) for details.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance57

Moderate activity, may be stable

Popularity15

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity13

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/e43a10984e8ee1687abaac86c26311c6a607b9560e8a3cc3193f8245751618bc?d=identicon)[wachterjohannes](/maintainers/wachterjohannes)

---

Top Contributors

[![wachterjohannes](https://avatars.githubusercontent.com/u/1464615?v=4)](https://github.com/wachterjohannes "wachterjohannes (5 commits)")

### Embed Badge

![Health badge](/badges/matesofmate-self-review-extension/health.svg)

```
[![Health](https://phpackages.com/badges/matesofmate-self-review-extension/health.svg)](https://phpackages.com/packages/matesofmate-self-review-extension)
```

###  Alternatives

[jjgrainger/wp-crumbs

Simple Wordpress Breadcrumbs.

3910.9k](/packages/jjgrainger-wp-crumbs)[wantp/snowflake

A package for create unique id by snowflake

399.5k1](/packages/wantp-snowflake)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)