👁️ reslop

Review AI generated code and plan changes

Turn generated changes into owned changes

Open a change, leave findings and a backlog, and prepare a repair plan for the agent.

Review → Plan → Repair → Verify

Leave feedback, a project backlog, and in-place code proposals as a repair plan
Review uncommitted git diffs, a given commit, a GitHub PR, or a GitLab MR
File-scope review mode: not just diffs, with editor mode
Stage, unstage, or revert each contiguous block of diff lines
Auto-reload local diffs when files change, keeping the current screen
Import GitHub PR and GitLab MR review comments into the local plan for AI
Commits list: brief and full, view a commit's diff, commit, amend, fixup, reword, drop, pull, and push
Branches: checkout, create, rebase, drop, pull, and push
npm scripts and bins: run, edit, and reorder; double-click to run; clean logs older than 5 days
Long lines wrap in the diff view; the editor scrolls horizontally
Reduced test and lint output for agents: failures and a short summary, not passing noise
Review each npm dependency once across package.json and the lockfile
Propose unused removals, npm audit fixes, and outdated updates as diffs
Code highlighting and intra-line diffs: unified, mixed, and side-by-side
Auto-update patch and minor releases; confirm a new major
Work with git, npm and fetch in background

Install

npm i -g reslop

Works on Linux, macOS, and Windows. On Windows use Windows Terminal. Requires Node.js >=18.15.0.

Usage

reslop uncommitted diffs in this repository
reslop path/file show only that path or file
reslop 7ac260c show that commit (read-only)
reslop https://github.com/metarhia/metacom/pull/555 GitHub/GitLab PR/MR
reslop -n start a new review even if the latest is still editing
reslop -r read-only mode
reslop -light light color theme (default dark)
reslop t -- <program> [args] run one program and print a reduced report

Prefix each program in an npm script with reslop t --. Keep && between those wraps, so each program is captured on its own and a failing step does not start the next one:

"lint": "reslop t -- eslint . && reslop t -- prettier -c \"**/*.js\"",
"test": "reslop t -- npm run -s lint && reslop t -- node --test"

The report is Markdown: failures, diagnostics, and a short summary. Passing results are omitted and similar problems are grouped. The same text is saved under .log/. Set RESLOP_OUTPUT=raw to pass the command through unchanged. The review screen runs scripts in raw mode and applies its own filter once.

Run the full check with npm t. Run one or more test files with reslop t -- node --test <files>. New reviews include those two commands in the agent instructions.

Reviews go in .review/YYYY-MM-DD-NN.md with frontmatter status:

editing: still writing the review in reslop
ready: ready for AI to work through the checkboxes
partial: AI started; some items remain
done: all items marked [x]

Future

Import issues from GitHub and GitLab
Search, blame, and file history in the review
Security and code-quality audit; propose a repair plan
Send anonymized code blocks for expert review
Send questions and the repair plan to experts for approval
Ask experts
Apply refactoring skills
Call agents, harnesses, and IDEs to execute prepared plans
Squash, cherry-pick, and interactive rebase
Merge, rename, and conflict resolution

tshemsedinov/reslop