feat: update documentation, lib functions, modules, and packages

docs/packages/README.md

@@ -0,0 +1,53 @@
+# Packages
+
+Documentation for packages in m3ta-nixpkgs. Each package directory may contain a `README.md` with detailed documentation.
+
+## Index
+
+Packages are organized in `pkgs/<name>/`. Add a `README.md` inside a package directory to document it here.
+
+### Local Packages
+
+These packages are built from source in `pkgs/<name>/`:
+
+| Package | Description | Type | Location |
+|---------|-------------|------|----------|
+| `sidecar` | Companion tool for CLI agents with diffs, file trees, and task management | Go | `pkgs/sidecar/` |
+| `td` | Minimalist CLI for tracking tasks across AI coding sessions | Go | `pkgs/td/` |
+| `code2prompt` | Convert code to prompts | Go | `pkgs/code2prompt/` |
+| `eigent` | Eigenvalue tool | Python | `pkgs/eigent/` |
+| `hyprpaper-random` | Random wallpaper setter for Hyprpaper | Shell | `pkgs/hyprpaper-random/` |
+| `kestractl` | CLI for Kestra workflow orchestration | Go | `pkgs/kestractl/` |
+| `launch-webapp` | Launch web applications | Shell | `pkgs/launch-webapp/` |
+| `mem0` | AI memory assistant with vector storage | Python | `pkgs/mem0/` |
+| `msty-studio` | Msty Studio application | Python | `pkgs/msty-studio/` |
+| `n8n` | Workflow automation tool | Node.js | `pkgs/n8n/` |
+| `openshell` | AI shell assistant | Go | `pkgs/openshell/` |
+| `pomodoro-timer` | Pomodoro timer utility | Shell | `pkgs/pomodoro-timer/` |
+| `rofi-project-opener` | Rofi-based project launcher | Shell | `pkgs/rofi-project-opener/` |
+| `stt-ptt` | Push to Talk Speech to Text | Python | `pkgs/stt-ptt/` |
+| `tuxedo-backlight` | Backlight control for Tuxedo laptops | C | `pkgs/tuxedo-backlight/` |
+| `vibetyper` | Typing practice tool | Python | `pkgs/vibetyper/` |
+| `zellij-ps` | Project switcher for Zellij | Rust | `pkgs/zellij-ps/` |
+
+### Pass-Through Packages
+
+These packages are imported directly from flake inputs with minor modifications:
+
+| Package | Source | Modification | Location |
+|---------|--------|-------------|----------|
+| `opencode-desktop` | `inputs.opencode` | Tauri desktop wrapper + Wayland fix | `pkgs/opencode-desktop/` |
+
+## Adding Package Documentation
+
+To document a package in detail, add a `README.md` inside the package directory (e.g., `pkgs/sidecar/README.md`). This guide indexes all packages and provides a quick overview.
+
+## Automated Updates
+
+Packages are automatically updated weekly by the Gitea Actions `nix-update` workflow. See the main README for details.
+
+## Related
+
+- [Adding Packages](../guides/adding-packages.md) - How to add new packages
+- [Architecture](../ARCHITECTURE.md) - Repository structure
+- [Quick Start](../QUICKSTART.md) - Getting started