Newshot

Show HN: Reflektor – Turn AI PRs into something a human can review

Original text(via HN AI)
license
license

Platform - Documentation - Install - Examples - Report a Bug

Reflektor: the blocks of a report, with types and contracts, the diff, database changes, risks and gaps, and the plan check
Reflektor: the blocks of a report, with types and contracts, the diff, database changes, risks and gaps, and the plan check

Reflektor - code review on steroids

Reflektor is a skill and a powertool for coding agents that turns a branch into a review report in your browser.

Features

Run on your own machine, or in the cloud. Do it solo, or collaborate with your team.

  • Technology-agnostic: Works with any language, framework, or database
  • Review Loops: iterate on your branch, and generate a new report with each commit until perfection
  • Collaboration: share a report with your team on reflektor.dev, and get your changes reviewed
  • Automatic Project Checks: your project's own tests, linter and type checker run in the background while the report is written, and their results show up in the report as they finish
  • E2E UI Testing with Screenshots: Each part of the UI is tested with screenshots, and the results are included in the report
  • How it Works: a visualization of the request flow from UI to database, including the types, interfaces, enums and constants it adds, changes or removes
  • Database Changes: a visualization of the database changes, including migrations and schema changes
  • Test Coverage: a summary of the tests, including metrics and suggestions
  • Hooks: Add pre-action hooks to run pipelines and tasks for report generation
  • Daemon: Reflektor runs as a small local daemon that keeps every review in one inbox, updates open reports live while your agent works, and hands your comments back to the agent

Get Started

Needs Node.js 18 or later and git.


        npx skills add bashovski/reflektor#skill -g
      

It asks which of your agents to install it for: Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot and others. Then start a new session in a repo, on a branch with changes, and run /reflektor in Claude Code or $reflektor in Codex. In other agents, ask for a review report. Reflektor tells you when a new version is out; update with npx skills update reflektor. The full guide is at reflektor.dev/install.

Codex's default sandbox blocks three things reflektor needs:

  • writing to the repo's .git folder: .git/reflektor, .git/objects and .git/refs/reflektor
  • writing to ~/.reflektor
  • running a local server on 127.0.0.1, which serves the review pages

Either run reflektor with full access, or give Codex a permission profile that allows those. This one worked in our tests (Codex CLI 0.169). Put it in the repo's .codex/config.toml and trust the project in Codex first: Codex ignores the config of a project it doesn't trust.


        default_permissions = "reflektor-local"

[features]
network_proxy = true

[permissions.reflektor-local]
extends = ":workspace"

[permissions.reflektor-local.filesystem]
"~/.reflektor" = "write"

[permissions.reflektor-local.filesystem.":workspace_roots"]
".git/reflektor" = "write"
".git/objects" = "write"
".git/refs/reflektor" = "write"

[permissions.reflektor-local.network]
enabled = true
allow_local_binding = true

[permissions.reflektor-local.network.domains]
"127.0.0.1" = "allow"
"localhost" = "allow"
      

While you review in the browser, Codex waits for you in its current turn. If that turn has ended, type $reflektor resume and Codex picks up your comments.

The installer checks the release's signature before installing, and reflektor then updates itself from the review page.


        curl -fsSL https://reflektor.dev/install.sh | sh                                     # Claude Code
curl -fsSL https://reflektor.dev/install.sh | sh -s -- --target agents               # Codex and agents that read ~/.agents/skills
curl -fsSL https://reflektor.dev/install.sh | sh -s -- --target <skills folder>      # any other agent
      

On Windows, in PowerShell:


        irm https://reflektor.dev/install.ps1 | iex
& ([scriptblock]::Create((irm https://reflektor.dev/install.ps1))) -Target agents
      

Docs

The full documentation is at reflektor.dev/docs:

  • Your first report
  • Review rounds
  • reflektor flags
  • Publishing a report to your team

Examples

We've built a large library of examples for you to explore. You can find them in the Examples.

Contributing

Whilst feedback and bug reports are more than welcome, I don't mind external help. Pick any open issues and communicate here on GitHub.

License

Reflektor is licensed under the MIT License. You are free to use, modify, and distribute this software in accordance with the terms of the license.

Author

Anur Basic - anurbasic.com

The text above was extracted automatically from the source page and may miss images, tables or code blocks. The original is authoritative.

Published by HN AI
This site only summarises and aggregates; copyright stays with the original author. Headlines and summaries follow the source — where they differ, the original wins.
Read the original ↗