diff --git a/CHANGELOG.md b/CHANGELOG.md
index b9a2ed4..bab8029 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [5.2.0](https://github.com/instantOS/instantMENU/compare/v5.1.5...v5.2.0) - 2026-10-24
+
+### Added
+
+- add skill command with agent scripting guidance
+- add shortcuts
+- build Alpine apk packages for x86_64 and ARM64
+
+### Fixed
+
+- better font performance
+- make layer configurable, change default
+- hint contrast
+
+### Other
+
+- Merge branch 'main' of github.com:instantOS/instantMENU
+- update key hint design
+- bump stuff
+- Merge branch 'dev' of github.com:instantOS/instantMENU into dev
+- Merge branch 'dev' of ufr:~/stuff/instantMENU into dev
+
 ## [5.1.5](https://github.com/instantOS/instantMENU/compare/v5.1.4...v5.1.5) - 2026-10-05
 
 ### Changed
diff --git a/Cargo.lock b/Cargo.lock
index 5d37208..59321ea 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -340,7 +340,7 @@ dependencies = [
 
 [[package]]
 name = "instantmenu"
-version = "5.1.5"
+version = "5.2.0"
 dependencies = [
  "clap",
  "clap_mangen",
diff --git a/Cargo.toml b/Cargo.toml
index 6e04edb..2edac4d 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "instantmenu"
-version = "5.1.5"
+version = "5.2.0"
 edition = "2021"
 description = "A dynamic menu for X11 and Wayland - Rust port of instantMENU (dmenu fork)"
 license = "MIT"
diff --git a/instantmenu.1 b/instantmenu.1
index 8f508fb..3c74a8d 100644
--- a/instantmenu.1
+++ b/instantmenu.1
@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH instantmenu 1  "instantmenu 5.1.5"
+.TH instantmenu 1  "instantmenu 5.2.0"
 .SH NAME
 instantmenu \- A dynamic menu for X11 and Wayland (instantMENU, Rust port)
 .SH SYNOPSIS
@@ -349,4 +349,4 @@ SLIDE MODE (`slide`):
   click/drag   set the value at the pointer         wheel  step
   middle click reset to the initial value
 .SH VERSION
-v5.1.5
+v5.2.0
diff --git a/packaging/arch-bin/.SRCINFO b/packaging/arch-bin/.SRCINFO
index ca6d901..bf602c3 100644
--- a/packaging/arch-bin/.SRCINFO
+++ b/packaging/arch-bin/.SRCINFO
@@ -1,6 +1,6 @@
 pkgbase = instantmenu-bin
 	pkgdesc = A dynamic menu for X11 and Wayland (prebuilt binary)
-	pkgver = 5.1.5
+	pkgver = 5.2.0
 	pkgrel = 1
 	url = https://github.com/instantOS/instantMENU
 	arch = x86_64
@@ -13,10 +13,10 @@ pkgbase = instantmenu-bin
 	depends = libxkbcommon-x11
 	depends = perl
 	optdepends = i3-wm: launch desktop entries with instantmenu_smartrun desktop
-	provides = instantmenu=5.1.5
+	provides = instantmenu=5.2.0
 	conflicts = instantmenu
-	source = instantMENU-5.1.5.tar.gz
-	source = instantmenu-x86_64-unknown-linux-gnu-v5.1.5.tgz
+	source = instantMENU-5.2.0.tar.gz
+	source = instantmenu-x86_64-unknown-linux-gnu-v5.2.0.tgz
 	sha256sums = SKIP
 	sha256sums = SKIP
 
diff --git a/packaging/arch-bin/PKGBUILD b/packaging/arch-bin/PKGBUILD
index 71126c1..b1cab2f 100644
--- a/packaging/arch-bin/PKGBUILD
+++ b/packaging/arch-bin/PKGBUILD
@@ -1,7 +1,7 @@
 # Maintainer: instantOS <hello@instantos.io>
 pkgname=instantmenu-bin
 _pkgname=instantmenu
-pkgver=5.1.5
+pkgver=5.2.0
 pkgrel=1
 pkgdesc="A dynamic menu for X11 and Wayland (prebuilt binary)"
 arch=('x86_64')
diff --git a/packaging/arch/.SRCINFO b/packaging/arch/.SRCINFO
index 86ae5b4..66aea9f 100644
--- a/packaging/arch/.SRCINFO
+++ b/packaging/arch/.SRCINFO
@@ -1,6 +1,6 @@
 pkgbase = instantmenu
 	pkgdesc = A dynamic menu for X11 and Wayland
-	pkgver = 5.1.5
+	pkgver = 5.2.0
 	pkgrel = 1
 	url = https://github.com/instantOS/instantMENU
 	arch = x86_64
@@ -16,7 +16,7 @@ pkgbase = instantmenu
 	depends = perl
 	optdepends = i3-wm: launch desktop entries with instantmenu_smartrun desktop
 	options = !lto
-	source = instantmenu-5.1.5.tar.gz::https://github.com/instantOS/instantMENU/archive/refs/tags/v5.1.5.tar.gz
+	source = instantmenu-5.2.0.tar.gz::https://github.com/instantOS/instantMENU/archive/refs/tags/v5.2.0.tar.gz
 	sha256sums = SKIP
 
 pkgname = instantmenu
diff --git a/packaging/arch/PKGBUILD b/packaging/arch/PKGBUILD
index f7a7bae..41016ed 100644
--- a/packaging/arch/PKGBUILD
+++ b/packaging/arch/PKGBUILD
@@ -1,6 +1,6 @@
 # Maintainer: instantOS <hello@instantos.io>
 pkgname=instantmenu
-pkgver=5.1.5
+pkgver=5.2.0
 pkgrel=1
 pkgdesc="A dynamic menu for X11 and Wayland"
 arch=('x86_64')