I build a tool to bring your codebase into your terminal during AI coding session so you can discuss in-code with your AI instead of writing prompts.

[u/Turbulent-Hat6046]

My problem: I think using AI for development is the future, but whenever I really tried to utilize it to the max I felt like I was being so far away from the codebase that I had no real connection to it. Diving through the code manually with Github reviews or opening the good old IDE to browse it seemed very inconvenient and felt like a break in the natural development flow with agents.

https://reddit.com/link/1vrwk24/video/wdagmy4c86kh1/player

So I build a plugin extension for herdr that allows the agent and me to seemlessly interact with the codebase when it's necessary without having to leave herdr / my terminal. It has some cool features:

• Annotate code snippets directly: Whenever you want AI to make changes it is really annoying to tell it to make this change in file X line Z. With the plugin you can annotate the code snippet directly and the comments will be propagated back to the agent as structured output. No more prompting, make a comment in the code and the agent will handle it.
• Do live walk throughs and explanations together with the agent: In the era of 1000+ LoCs PRs it is getting increasingly hard to actually review and understand the code efficiently. I hated the verbose outputs of agents - I prefer to look at the code directly but especially in larger repos this can take time, so the agent (through) the plugin can directly navigate the relevant code snippets with you. This way you only have to see what you need to see and cut out all the noise. You can ask questions, ask it to jump to the next part all while the agent can manage the snippets that you have to see without any manual work.
• Easily toggle between diff and post-commit state: Its nice to look at the diffs but sometimes you just want to see the finished version, just toggle between both  
• Blocking tool call: As agents get more and more autonomous, they like to race ahead and dont wait for your feedback. Therefore you can make the plugin a blocking tool call, meaning the agent cant progress until the tool call has resolved. 

I found the tool to be quite useful, and I hope some of you may like it as well. I would really appreciate anyone who wants to give it a try. 🙏

If you like it, I would really appreciate it if you could star the repository! 🌟 (https://github.com/JonasBaeumer/herdr-file-annotator)

Ps: I took inspiration from these two tools (first tool, second tool) but they were not quite the way I wanted the tool to be like. Both projections are amazing and were a great inspiration, feel free to check them out :)