Posting this issue as the CONTRIBUTING docs request before submitting PRs.
Problem
I've been using revdiff with both of the provided plugins with Claude Code for the last week or so along with an additional hook I added to review code changes prior to commits. It's great!
One thing I've noticed though is that, when revdiff auto-opens diffs in a tmux popup, it's not always clear what it changed and why, especially when I click away while claude is working and come back to it after a meeting or something.
Proposal
I was thinking that it would be really nice if the agent had an extra flag in the CLI that it could use to add some description about the diff. This description text (ideally in syntax highlighted markdown) could appear in a pane, potentially at the top, bottom or side of the popup. I'd think you should be able to navigate to the pane and scroll up and down as you can in the code pane and of course be hideable, etc.
Something like this:
revdiff .... --description="....markdown description"
The revdiff skills and plugins could be updated so that it would give concise, yet useful context for the diff you're looking at. Ideally, the agent would describe the changes it made or what kind of feedback its seeking, etc.
The description could be omitted by default or perhaps, show the command that was run to generate the diff as a fallback. I think either would be fine personally.
Would this be something you are interested in? I believe it could be helpful for all users of revdiff.
Posting this issue as the CONTRIBUTING docs request before submitting PRs.
Problem
I've been using revdiff with both of the provided plugins with Claude Code for the last week or so along with an additional hook I added to review code changes prior to commits. It's great!
One thing I've noticed though is that, when revdiff auto-opens diffs in a tmux popup, it's not always clear what it changed and why, especially when I click away while claude is working and come back to it after a meeting or something.
Proposal
I was thinking that it would be really nice if the agent had an extra flag in the CLI that it could use to add some description about the diff. This description text (ideally in syntax highlighted markdown) could appear in a pane, potentially at the top, bottom or side of the popup. I'd think you should be able to navigate to the pane and scroll up and down as you can in the code pane and of course be hideable, etc.
Something like this:
revdiff .... --description="....markdown description"The revdiff skills and plugins could be updated so that it would give concise, yet useful context for the diff you're looking at. Ideally, the agent would describe the changes it made or what kind of feedback its seeking, etc.
The description could be omitted by default or perhaps, show the command that was run to generate the diff as a fallback. I think either would be fine personally.
Would this be something you are interested in? I believe it could be helpful for all users of revdiff.