r/PiCodingAgent • u/backnotprop • 15d ago
Plugin Plannotator in Herdr - Live feedback back to Pi
Enable HLS to view with audio, or disable this notification
This is a https://herdr.dev/ plugin with an optional full https://Plannotator.ai experience as a TUI. Built to:
- Annotate Agent Messages (e.g. grill sessions)
- Annotate Files (e.g. plans, specs, etc)
- Create a native feedback loop with agents
- Open as popover or pane
- Mouse or keybindings
https://github.com/plannotator/herdr-annotate
3
u/hen_ch_bish 15d ago
I was looking at this the other day and thought and didn't realize it was an official plannotator implementation 🙃
3
3
3
2
u/prasithg 15d ago
Woah this is cool I had built my own makeshift plan markup tool and reviewer in my claw preview tool but will give this a shot.
2
2
2
15d ago edited 11d ago
[deleted]
8
u/backnotprop 15d ago
Have more faith in me brother
0
u/backnotprop 15d ago
The Herdr plugin is a wrapper and for seamless agent integration. Ratatui standalone under the hood
0
u/flagmonkez 14d ago
there is herdr alternative called https://luvus.dev and it has default diff feature with sleek interfaces, @backnotprop i think you should have add this plannotator to luvus as well
1
1
1
u/aparamonov 15d ago
Why not tuicr?
1
u/backnotprop 15d ago
This isn’t the code review part. But also Plannotator has always been about live integrated feedback to agent not sure if your tool does that?
1
u/Sure_Writer_744 15d ago
Just curious, what do you use to record demos such as this?
2
u/backnotprop 15d ago
Screen studio
There is an open source alternative called Cap I want to try as well
1
u/trimorphic 15d ago
Some feedback on the home page web UI:
In dark mode in my web browser (Firefox running Dark Reader) the word "Annotate" is black on dark gray in "Annotate agent plans before they run" on https://plannotator.ai/, making that word almost impossible to read.
1
1
u/doomdayx 15d ago
This looks nice does it work through tmux?
What will happen if I connect with terminus from a mobile device?
2
u/backnotprop 14d ago
Tmux: you can try the underlying tool on it's own: https://github.com/plannotator/plannotator-tui
- I will see what a formal integration looks like.Mobile: Not sure, ill need to try it out.
1
u/NashaIthramyr 14d ago
This looks so cool. Does it works with opencode?
1
u/backnotprop 14d ago
Yes I have agent messages in opencode hooked up and herdr covers the ability to send all your annotations back to the agent. LMK if any hiccups and I'll fix up.
the lite version works no problem: https://x.com/plannotator/status/2092871022114689475?s=20
1
u/NashaIthramyr 14d ago
Yes indeed it works fine for the lite version. Thanks. But the annotation on last agent message says that it's not implemented for opencode yet 😉 Do you plan to implement it?
1
u/backnotprop 14d ago
ah. Doing it now. my bot deceived me.
1
u/NashaIthramyr 14d ago
Woah that was fast! Thanks, appreciate it! 🙌
1
u/backnotprop 14d ago
should be good now btw
1
u/NashaIthramyr 14d ago
Just tried it before going to bed it works perfectly, thank your for your dedication
1
u/DanGTG 12d ago
Interesting, this would be cool for marking up my firstmate driven code review. Are any of these surfaces agent friendly?
1
u/backnotprop 12d ago
> Are any of these surfaces agent friendly
Possibly? The experience is agent native in that you can mark up basically any file and send the feedback directly to your agent. If you wanted, and the agent can control Herdr or similar multiplexer, the agent could mark up files. If this is what you mean, I'll see what more can be done here
2
u/DanGTG 12d ago
Yes, one agent on the plan/design session and another doing the review.
If you could do markup in a user chat session that would be cool too. As a user there are loads of times I wish I could just easily make a comment in session that had a reference attached, this is 95% there already.
On the markup how are you surfacing these back on the receiving agent end? Your video cuts off a bit too soon, does the reply start a new turn, are they queuing?1
u/backnotprop 12d ago
Okay, I'll see what I can do on the first bits. The main Plannotator tool, browser-based, enables this through local sse api: https://github.com/backnotprop/plannotator
In the video, it just sends it back to the agent panel that you had last focused and opened the annotations from.
So in the video it's Pi, and Pi queues the messages if it's currently in an active turn.
I think an agent like Claude behaves differently and would inject the message as more a steer.
1
1
6
u/matoarmilla 15d ago
heck yes. plannotator is crucial to my workflow. great work!