← Back to archive

Repo of the Day

bashovski/reflektor

Published: Nov 21, 2026

Open repository ↗

Code review on steroids

Summary

Reflektor is a skill and review tool for coding agents that turns a branch with changes into a structured report in your browser. It combines code and database analysis with project checks, UI screenshots, and a feedback loop that can return reviewer comments to the agent.

What it is useful for

Reflektor is useful when an engineer wants a deeper review of a feature branch before opening or updating a pull request. The report is technology-agnostic, so it can be applied to projects using different languages, frameworks, and databases.

The generated report can include:

  • The branch diff and a visualization of the request flow from UI to database.
  • Types, interfaces, enums, and constants added, changed, or removed.
  • Database migrations and schema changes.
  • Risks, gaps, and a plan check.
  • Test coverage summaries and suggestions.
  • Screenshots from end-to-end UI tests.

It can also run the project’s own tests, linter, and type checker in the background, with results appearing in the report as they finish. This makes it practical for checking a change across several layers rather than reviewing only the modified files.

Reflektor supports iterative review rounds: generate a report, leave feedback in the browser, and produce another report after another commit. A local daemon keeps reports in one inbox, updates open reports while the agent works, and sends comments back to the agent. Reports can also be shared with a team through Reflektor’s hosted service.

How engineers can use it

You need Node.js 18 or later and Git. Install the skill globally with:

npx skills add bashovski/reflektor#skill -g

The installer asks which coding agents to configure, including Claude Code, Codex, Cursor, Gemini CLI, and GitHub Copilot. Start a new agent session in a repository, switch to a branch containing changes, and run:

  • /reflektor in Claude Code
  • $reflektor in Codex
  • A request for a review report in other supported agents

Review the generated report in your browser and leave comments. If an agent turn has already ended, Codex users can run $reflektor resume to continue with the review feedback. Updates are available through:

npx skills update reflektor

One documented limitation is Codex’s default sandbox: Reflektor needs permission to write under .git/reflektor, .git/objects, and .git/refs/reflektor, write to ~/.reflektor, and bind a local server on 127.0.0.1. The README includes a corresponding permission profile. The full setup guide is available at reflektor.dev/install.