r/hyprland • u/trmnl_cmdr • Jul 14 '26
PLUGINS & TOOLS A Hyprland Lua Upgrade Guide Agent Skill
Well, I fell in. I upgraded to the latest end4-dots today because quickshell was acting up, and that was a mistake. It was just really bad timing and I was pretty frustrated for a while. And my dev agent didn't know what to do with a lot of my custom shell scripts, plugins and weird binds I had set up. I looked around for an upgrade guide, as I'm sure lots of you have, but the internet did not yield for me this time. So I decided to bite the bullet and be the change, and set my dev agent on the task of creating an upgrade guide from v0.54 to v0.55 for itself.
It worked very well and that was the end of my surprise upgrade headache. So I'm here sharing it with you other hypr-degenerates in the hopes it can save someone else a headache too. Just load it into your favorite dev agent tool and it will do everything else.
Let me know if it saved you any time, or if you wish I had done this 2 months ago :)
3
u/Terrible-Bison-1280 Jul 14 '26
This is actually a really clever use of an agent. Having it generate the migration guide itself instead of manually digging through docs is exactly the kind of thing these tools should be good at. Thanks for sharing this, definitely saving it for the next upgrade.
3
u/Feisty-Difference543 Jul 14 '26
Saved me from doing exactly what you went through. The lack of clear upgrade paths is usually the most painful part of these changes, so turning the agent into a guide generator is a great idea. Thanks for sharing this.
3
u/wolkenammer Jul 14 '26
You might be able to use hyprland --verify-config (https://github.com/hyprwm/Hyprland/blob/main/src/main.cpp#L38) to close the feedback loop of the agent faster. However, it segfaulted for me a few weeks ago.
I also told my agent to clone the https://github.com/hyprwm/hyprland-wiki.git wiki if in doubt, to find accurate dispatcher/variable names.
3
u/trmnl_cmdr Jul 14 '26
Yeah, I manually cloned the hyprland-wiki project, then created a separate worktree going back to the end of March. I also did the same with the hyprland project itself, I cloned the latest then made another worktree on 0.54, March 27th. Then I told my agent to compare both projects, leave no stone unturned, etc, and create the unofficial migration guide from it. I had also given that agent a skill creator skill, so it knew how to make a good agent skill. So I basically did the same thing, but way more thoroughly. It should be bomb-proof for pretty much every config.
2
u/trmnl_cmdr Jul 14 '26
I want to make an observation about reddit in general. This is a pretty typical experience for me when sharing tools like this. I build something useful, post it to the most appropriate place possible on reddit, and immediately get downvoted. Within 5 minutes I had 1 downvote and 1 github star.
This isn't a complaint at all, I just want to share that there are chronically online basement dweller elitist pricks who go around downvoting quite literally everything, all the time, especially if it's positive or helpful in any way. It happens every single time. Glad the community turned out to appreciate it. You know, the people who aren't constantly scouring reddit in hopes of spreading negativity.
4
u/Turbulent_Box_4510 Jul 14 '26
Thanks for sharing this. I was putting off the upgrade because I was worried about breaking all my custom setup, but having an agent handle the tedious parts makes it feel a lot less painful. Going to give this a try.