feat: add Gitea Actions workflow for automated package updates with nix-update

README.md

@@ -51,7 +51,27 @@ nix run git+https://code.m3ta.dev/m3tam3re/nixpkgs#zellij-ps
 | `tuxedo-backlight` | Backlight control for Tuxedo laptops  |
 | `zellij-ps`        | Project switcher for Zellij           |
 
-## Documentation
+## Automated Package Updates
+
+This repository uses Gitea Actions to automatically update packages using `nix-update`:
+
+**Workflow**: [`.gitea/workflows/nix-update.yml`](./.gitea/workflows/nix-update.yml)
+
+**Schedule**: Runs weekly on Sundays, and can be triggered manually.
+
+**What it does**:
+- Checks all packages in `pkgs/` for updates
+- Updates versions and hashes using `nix-update --flake --commit`
+- Creates a new branch with updates
+- Opens a pull request automatically
+
+**Manual Trigger**:
+Go to **Actions → Update Nix Packages with nix-update → Run workflow** in Gitea UI, then optionally specify a specific package to update.
+
+**Setup Required**:
+1. Create a Personal Access Token in Gitea (Settings → Applications → Generate Token)
+2. Token scopes needed: `user`, `repo`, `write:issue`
+3. Add token as secret: Settings → Secrets → New → `NIX_UPDATE_TOKEN`
 
 For detailed usage, module documentation, package references, and contribution guidelines, see the [full documentation](./docs).