git404hub

what is hyprland-lua-migration fr?

dabstractor/hyprland-lua-migration — explained in plain English

Analysis updated 2026-05-18

7Audience · developerComplexity · 2/5Setup · easy

tl;dr

An AI agent skill that guides converting Hyprland window manager configs from the old hyprlang format to the new Lua format in version 0.55.

vibe map

mindmap
  root((Hyprland Lua migration))
    What it does
      Guides config migration
      Old syntax to Lua
      Agent Skill format
    Tech stack
      Lua
      Hyprland
      Pi agent client
    Use cases
      Convert conf to lua
      Explain breaking changes
      Troubleshoot broken configs
    Audience
      Hyprland users
      AI assistant users
    Content
      SKILL.md walkthrough
      Eight reference docs
      Old to new mapping

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Convert an existing hyprland.conf file into the new hyprland.lua format automatically with an AI assistant.

VIBE 2

Get an explanation of what changed between Hyprland 0.54 and 0.55 configuration syntax.

VIBE 3

Troubleshoot a Hyprland config that broke after upgrading to version 0.55.

VIBE 4

Look up the new Lua equivalent for a specific old dispatcher, bind, or rule.

what's the stack?

LuaHyprland

how it stacks up fr

dabstractor/hyprland-lua-migration0x-shadow/crewtrack0xsv1/ghosttype-bof
Stars777
LanguageC++C
Setup difficultyeasymoderatehard
Complexity2/53/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Needs an Agent Skills-compatible client such as Pi to actually use it.

The README does not state a license.

in plain english

Hyprland is a popular Linux window manager, and version 0.55 changed the way its configuration files are written, switching from a custom format called hyprlang to real Lua code. That is a breaking change with no official guide from the Hyprland project itself, so this repository fills that gap. It is not a script you run, but a structured reference document meant to be read and used by an AI agent. Specifically, this is an Agent Skill, a format made up of one main guide file and a folder of detailed reference documents, designed to be loaded by AI assistants that support this format, such as Pi. Once loaded, the assistant can use it to accurately convert an old style hyprland.conf file into the new hyprland.lua format, explain what changed, and help troubleshoot configs that broke during the upgrade. The reference material is thorough. It covers core syntax and file structure, every configuration variable with notes on what is old, new, or removed, key bindings, every dispatcher command, window and layer rules, monitor and workspace settings, animations and gestures, and events and custom layouts. Each old construct is shown next to its new Lua equivalent, so nothing is left to guesswork. The author built this by comparing the actual source code and documentation of Hyprland versions 0.54 and 0.55 directly, rather than guessing at behavior. This is aimed squarely at Hyprland users doing the version upgrade, and it is most useful when loaded into an AI assistant that understands the Agent Skills format, rather than read as plain documentation on its own.

prompts (copy fr)

prompt 1
Load this Hyprland Lua migration skill and convert my hyprland.conf to hyprland.lua.
prompt 2
Explain what changed in Hyprland 0.55's monitor and workspace configuration.
prompt 3
Use this skill to find the new dispatcher equivalent for my old bind commands.
prompt 4
Help me debug why my Hyprland config broke after upgrading to 0.55.
prompt 5
Show me the new animation and gesture syntax using this migration reference.

Frequently asked questions

what is hyprland-lua-migration fr?

An AI agent skill that guides converting Hyprland window manager configs from the old hyprlang format to the new Lua format in version 0.55.

What license does hyprland-lua-migration use?

The README does not state a license.

How hard is hyprland-lua-migration to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is hyprland-lua-migration for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.