n8n: n8n@2.4.5 -> n8n@2.4.6

Diff: https://github.com/n8n-io/n8n/compare/n8n@2.4.5...n8n@2.4.6

Changelog: https://github.com/n8n-io/n8n/releases/tag/n8n@n8n@2.4.6

.beads/.gitignore

@@ -0,0 +1,44 @@
+# SQLite databases
+*.db
+*.db?*
+*.db-journal
+*.db-wal
+*.db-shm
+
+# Daemon runtime files
+daemon.lock
+daemon.log
+daemon.pid
+bd.sock
+sync-state.json
+last-touched
+
+# Local version tracking (prevents upgrade notification spam after git ops)
+.local_version
+
+# Legacy database files
+db.sqlite
+bd.db
+
+# Worktree redirect file (contains relative path to main repo's .beads/)
+# Must not be committed as paths would be wrong in other clones
+redirect
+
+# Merge artifacts (temporary files from 3-way merge)
+beads.base.jsonl
+beads.base.meta.json
+beads.left.jsonl
+beads.left.meta.json
+beads.right.jsonl
+beads.right.meta.json
+
+# Sync state (local-only, per-machine)
+# These files are machine-specific and should not be shared across clones
+.sync.lock
+sync_base.jsonl
+
+# NOTE: Do NOT add negation patterns (e.g., !issues.jsonl) here.
+# They would override fork protection in .git/info/exclude, allowing
+# contributors to accidentally commit upstream issue databases.
+# The JSONL files (issues.jsonl, interactions.jsonl) and config files
+# are tracked by git by default since no pattern above ignores them.

.beads/README.md

@@ -0,0 +1,81 @@
+# Beads - AI-Native Issue Tracking
+
+Welcome to Beads! This repository uses **Beads** for issue tracking - a modern, AI-native tool designed to live directly in your codebase alongside your code.
+
+## What is Beads?
+
+Beads is issue tracking that lives in your repo, making it perfect for AI coding agents and developers who want their issues close to their code. No web UI required - everything works through the CLI and integrates seamlessly with git.
+
+**Learn more:** [github.com/steveyegge/beads](https://github.com/steveyegge/beads)
+
+## Quick Start
+
+### Essential Commands
+
+```bash
+# Create new issues
+bd create "Add user authentication"
+
+# View all issues
+bd list
+
+# View issue details
+bd show <issue-id>
+
+# Update issue status
+bd update <issue-id> --status in_progress
+bd update <issue-id> --status done
+
+# Sync with git remote
+bd sync
+```
+
+### Working with Issues
+
+Issues in Beads are:
+- **Git-native**: Stored in `.beads/issues.jsonl` and synced like code
+- **AI-friendly**: CLI-first design works perfectly with AI coding agents
+- **Branch-aware**: Issues can follow your branch workflow
+- **Always in sync**: Auto-syncs with your commits
+
+## Why Beads?
+
+✨ **AI-Native Design**
+- Built specifically for AI-assisted development workflows
+- CLI-first interface works seamlessly with AI coding agents
+- No context switching to web UIs
+
+🚀 **Developer Focused**
+- Issues live in your repo, right next to your code
+- Works offline, syncs when you push
+- Fast, lightweight, and stays out of your way
+
+🔧 **Git Integration**
+- Automatic sync with git commits
+- Branch-aware issue tracking
+- Intelligent JSONL merge resolution
+
+## Get Started with Beads
+
+Try Beads in your own projects:
+
+```bash
+# Install Beads
+curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
+
+# Initialize in your repo
+bd init
+
+# Create your first issue
+bd create "Try out Beads"
+```
+
+## Learn More
+
+- **Documentation**: [github.com/steveyegge/beads/docs](https://github.com/steveyegge/beads/tree/main/docs)
+- **Quick Start Guide**: Run `bd quickstart`
+- **Examples**: [github.com/steveyegge/beads/examples](https://github.com/steveyegge/beads/tree/main/examples)
+
+---
+
+*Beads: Issue tracking that moves at the speed of thought* ⚡

.beads/config.yaml

@@ -0,0 +1,62 @@
+# Beads Configuration File
+# This file configures default behavior for all bd commands in this repository
+# All settings can also be set via environment variables (BD_* prefix)
+# or overridden with command-line flags
+
+# Issue prefix for this repository (used by bd init)
+# If not set, bd init will auto-detect from directory name
+# Example: issue-prefix: "myproject" creates issues like "myproject-1", "myproject-2", etc.
+# issue-prefix: ""
+
+# Use no-db mode: load from JSONL, no SQLite, write back after each command
+# When true, bd will use .beads/issues.jsonl as the source of truth
+# instead of SQLite database
+# no-db: false
+
+# Disable daemon for RPC communication (forces direct database access)
+# no-daemon: false
+
+# Disable auto-flush of database to JSONL after mutations
+# no-auto-flush: false
+
+# Disable auto-import from JSONL when it's newer than database
+# no-auto-import: false
+
+# Enable JSON output by default
+# json: false
+
+# Default actor for audit trails (overridden by BD_ACTOR or --actor)
+# actor: ""
+
+# Path to database (overridden by BEADS_DB or --db)
+# db: ""
+
+# Auto-start daemon if not running (can also use BEADS_AUTO_START_DAEMON)
+# auto-start-daemon: true
+
+# Debounce interval for auto-flush (can also use BEADS_FLUSH_DEBOUNCE)
+# flush-debounce: "5s"
+
+# Git branch for beads commits (bd sync will commit to this branch)
+# IMPORTANT: Set this for team projects so all clones use the same sync branch.
+# This setting persists across clones (unlike database config which is gitignored).
+# Can also use BEADS_SYNC_BRANCH env var for local override.
+# If not set, bd sync will require you to run 'bd config set sync.branch <branch>'.
+# sync-branch: "beads-sync"
+
+# Multi-repo configuration (experimental - bd-307)
+# Allows hydrating from multiple repositories and routing writes to the correct JSONL
+# repos:
+#   primary: "."  # Primary repo (where this database lives)
+#   additional:   # Additional repos to hydrate from (read-only)
+#     - ~/beads-planning  # Personal planning repo
+#     - ~/work-planning   # Work planning repo
+
+# Integration settings (access with 'bd config get/set')
+# These are stored in the database, not in this file:
+# - jira.url
+# - jira.project
+# - linear.url
+# - linear.api-key
+# - github.org
+# - github.repo

.beads/issues.jsonl

@@ -1,6 +1,20 @@
+{"id":"nixpkgs-1xm","title":"Package Basecamp MCP Server","status":"closed","priority":2,"issue_type":"task","created_at":"2026-01-12T05:01:20.465656454+01:00","created_by":"m3tam3re","updated_at":"2026-01-12T05:01:26.623404603+01:00","closed_at":"2026-01-12T05:01:26.623404603+01:00","close_reason":"Packaged successfully with env file support"}
 {"id":"nixpkgs-3k8","title":"Export project config as environment variable","description":"Export project configuration as home.sessionVariables (similar to zellij-ps pattern). Use JSON format for the env var since projects now have structured data (path + args).","status":"closed","priority":2,"issue_type":"task","created_at":"2026-01-05T12:45:50.803017318+01:00","created_by":"m3tam3re","updated_at":"2026-01-05T12:48:22.968626155+01:00","closed_at":"2026-01-05T12:48:22.968626155+01:00","close_reason":"Added home.sessionVariables.ROFI_PROJECT_OPENER_CONFIG with JSON config","dependencies":[{"issue_id":"nixpkgs-3k8","depends_on_id":"nixpkgs-hrh","type":"parent-child","created_at":"2026-01-05T12:46:03.16885012+01:00","created_by":"m3tam3re"}]}
+{"id":"nixpkgs-3w3","title":"Add authentication command and environment file generation to basecamp-mcp-server","description":"The basecamp-mcp-server package at pkgs/basecamp-mcp-server/default.nix wraps the FastMCP server for Basecamp 3 integration. Currently, there's no convenient way for users to:\n\n1. Set up OAuth 2.0 authentication interactively\n2. Generate a sample environment file with required credentials\n3. Guide users through the Basecamp OAuth flow\n\n## Current State\n\nThe package wraps  but users must:\n- Manually clone the upstream repository\n- Run  to generate  template\n- Edit  with OAuth credentials from https://launchpad.37signals.com/integrations\n- Run  to complete OAuth flow\n- Handle token storage manually\n\n## Required Environment Variables\n\n### OAuth Configuration (Primary)\n-  - OAuth client ID from Basecamp\n-  - OAuth client secret\n-  - Found in Basecamp URL: https://3.basecamp.com/ID/...\n-  - Format: \"App Name (email@domain.com)\"\n-  - http://localhost:8000/auth/callback\n-  - For Flask session security\n\n### Basic Auth (Legacy)\n-  - Email for direct API access\n-  - Password for direct API access\n\n## Proposed Solution\n\nAdd a Nix package wrapper command () that:\n\n1. **Interactive Setup Wizard**\n   - Guides users through OAuth app creation at launchpad.37signals.com\n   - Prompts for credentials (with secure input for secrets)\n   - Validates inputs before proceeding\n\n2. **Environment File Generation**\n   - Creates  or project-local \n   - Includes all required variables with clear documentation\n   - Sets secure permissions (600)\n   - Provides example values\n\n3. **OAuth Flow Handler**\n   - Starts local Flask server on port 8000\n   - Opens browser to initiate OAuth flow\n   - Handles callback and token exchange\n   - Stores tokens securely in \n   - Shows success/failure status\n\n4. **Documentation**\n   - Inline help for all steps\n   - Links to Basecamp integration setup\n   - Account ID discovery instructions\n\n## References\n\n- Upstream repo: https://github.com/georgeantonopoulos/Basecamp-MCP-Server\n- Key files: , , , \n- OAuth endpoints: launchpad.37signals.com/authorization/new\n\n## Subtasks\n\n- [ ] Create auth command wrapper (basecamp-mcp-auth)\n- [ ] Implement interactive OAuth wizard\n- [ ] Generate sample environment file template\n- [ ] Add token storage handling\n- [ ] Update package documentation\n- [ ] Add Home Manager module support (optional)","status":"closed","priority":2,"issue_type":"feature","created_at":"2026-01-12T18:25:50.929926505+01:00","created_by":"m3tam3re","updated_at":"2026-01-12T19:12:57.941267399+01:00","closed_at":"2026-01-12T19:12:57.941267399+01:00","close_reason":"Closed"}
 {"id":"nixpkgs-5ml","title":"Update rofi-project-opener script to pass args to opencode","description":"Modify pkgs/rofi-project-opener script to read the new config format and launch opencode with: 'opencode \u003cdirectory\u003e \u003carguments\u003e' instead of just 'opencode' in the directory.","status":"closed","priority":1,"issue_type":"task","created_at":"2026-01-05T12:45:49.748958951+01:00","created_by":"m3tam3re","updated_at":"2026-01-05T12:49:40.800083615+01:00","closed_at":"2026-01-05T12:49:40.800083615+01:00","close_reason":"Script updated to read JSON config and pass args to opencode","dependencies":[{"issue_id":"nixpkgs-5ml","depends_on_id":"nixpkgs-w3u","type":"parent-child","created_at":"2026-01-05T12:46:02.338350208+01:00","created_by":"m3tam3re"},{"issue_id":"nixpkgs-5ml","depends_on_id":"nixpkgs-sys","type":"blocks","created_at":"2026-01-05T12:46:04.966269033+01:00","created_by":"m3tam3re"}]}
+{"id":"nixpkgs-61l","title":"Update documentation to reflect latest changes","status":"closed","priority":3,"issue_type":"task","created_at":"2026-01-10T18:48:19.599467206+01:00","created_by":"m3tam3re","updated_at":"2026-01-10T19:12:26.294895563+01:00","closed_at":"2026-01-10T19:12:26.294895563+01:00","close_reason":"Documentation updated: Added stt-ptt language support docs, rofi-project-opener module docs, and updated zellij-ps docs"}
+{"id":"nixpkgs-69z","title":"n8n overlay -\u003e pkgs","description":"Create a full package definition in pkgs/n8n/default.nix that mirrors nixpkgs-unstable's n8n package but with version 2.4.1 and updated hashes from overlays/mods/n8n.nix. Register the new package in pkgs/default.nix. The overlay overrides: src (n8n-io/n8n@2.4.1) and pnpmDeps hash. Reference nixpkgs-unstable for the base package structure, then apply the version/hash modifications.","status":"closed","priority":2,"issue_type":"chore","owner":"p@m3ta.dev","created_at":"2026-01-13T19:42:35.643928163+01:00","created_by":"m3tm3re","updated_at":"2026-01-13T20:25:53.712987689+01:00","closed_at":"2026-01-13T20:25:53.712987689+01:00","close_reason":"Packages created successfully: pkgs/n8n/default.nix, pkgs/beads/default.nix, pkgs/opencode/default.nix. All packages build successfully."}
+{"id":"nixpkgs-7ez","title":"Add authentication command for basecamp-mcp-server","description":"Add a command for the basecamp-mcp-server that will guide the user through the authentication flow and create a sample environment file with the necessary values. This involves researching the original basecamp-mcp-server repository for authentication details and implementing a user-friendly authentication workflow.","status":"tombstone","priority":0,"issue_type":"feature","created_at":"2026-01-12T18:20:55.665717166+01:00","created_by":"m3tam3re","updated_at":"2026-01-13T19:46:32.112562429+01:00","dependencies":[{"issue_id":"nixpkgs-7ez","depends_on_id":"nixpkgs-3w3","type":"blocks","created_at":"2026-01-12T18:48:31.806330931+01:00","created_by":"m3tam3re"}],"deleted_at":"2026-01-13T19:46:32.112562429+01:00","deleted_by":"daemon","delete_reason":"delete","original_type":"feature"}
+{"id":"nixpkgs-8jw","title":"fix: self-hosted nixos runner missing node in PATH for Gitea Actions","description":"The nix-update workflow fails on self-hosted nixos runner because node is not available in PATH. Error: Cannot find: node in PATH. Root cause: actions/checkout@v4 requires Node.js to execute post-checkout steps. The self-hosted nixos runner does not have node installed or not in PATH. Possible solutions: 1) Add Node.js to the nixos runner environment, 2) Use container-based runner instead of bare nixos, 3) Use a different checkout action that does not require node, 4) Configure PATH to include node installation. Impact: Automated package updates are completely blocked.","status":"closed","priority":1,"issue_type":"bug","owner":"p@m3ta.dev","created_at":"2026-01-14T20:50:59.153145341+01:00","created_by":"m3tm3re","updated_at":"2026-01-18T18:36:50.926416564+01:00","closed_at":"2026-01-17T09:49:26.658187402+01:00"}
+{"id":"nixpkgs-8ng","title":"fix: Add nix-update arguments for opencode subpackage","description":"The Gitea workflow does not work correctly on the opencode package because opencode uses a subpackage. To fix this, nix-update needs to be run with additional arguments to adjust the output hash of the subpackage.\n\n**Solution:**\nRun nix-update with the following arguments:\n$ nix-instantiate --eval --json --strict /nix/store/ybiynv89drnshjdlb089r3i687c5k878-nix-update-1.14.0/lib/python3.13/site-packages/nix_update/eval.nix --argstr importPath /home/m3tam3re/p/NIX/nixpkgs --argstr attribute '[\"opencode\"]' --arg isFlake true --arg sanitizePositions true\nfetch https://github.com/anomalyco/opencode/releases.atom\nNot updating version, already 1.1.25\nUpdating subpackage node_modules\n$ nix-instantiate --eval --json --strict /nix/store/ybiynv89drnshjdlb089r3i687c5k878-nix-update-1.14.0/lib/python3.13/site-packages/nix_update/eval.nix --argstr importPath /home/m3tam3re/p/NIX/nixpkgs --argstr attribute '[\"opencode\", \"node_modules\"]' --arg isFlake true --arg sanitizePositions true\n$ nix-build --expr 'let src = (let flake = builtins.getFlake \"/home/m3tam3re/p/NIX/nixpkgs\"; in flake.packages.${builtins.currentSystem}.\"opencode\".\"node_modules\" or flake.\"opencode\".\"node_modules\").src; in (src.overrideAttrs or (f: src // f src)) (_: { outputHash = \"\"; outputHashAlgo = \"sha256\"; })' --extra-experimental-features 'flakes nix-command'\n$ nix-build --expr 'let src = (let flake = builtins.getFlake \"/home/m3tam3re/p/NIX/nixpkgs\"; in flake.packages.${builtins.currentSystem}.\"opencode\".\"node_modules\" or flake.\"opencode\".\"node_modules\"); in (src.overrideAttrs or (f: src // f src)) (_: { outputHash = \"\"; outputHashAlgo = \"sha256\"; })' --extra-experimental-features 'flakes nix-command'\nPackage maintainers:\n  - Thierry Delafontaine (@delafthi)\n$ git -C /home/m3tam3re/p/NIX/nixpkgs diff -- /home/m3tam3re/p/NIX/nixpkgs/pkgs/opencode\n\nThe workflow file needs to be updated to pass these arguments when updating the opencode package.","status":"closed","priority":2,"issue_type":"bug","owner":"p@m3ta.dev","created_at":"2026-01-17T09:47:55.750805329+01:00","created_by":"m3tm3re","updated_at":"2026-01-18T10:38:06.536530593+01:00","closed_at":"2026-01-18T10:38:06.536530593+01:00","close_reason":"Closed"}
+{"id":"nixpkgs-98j","title":"beads overlay -\u003e pkgs","description":"Create a full package definition in pkgs/beads/default.nix that mirrors nixpkgs-unstable's beads package but with version 0.47.1 and updated hashes from overlays/mods/beads.nix. Register the new package in pkgs/default.nix. The overlay overrides: src (steveyegge/beads@v0.47.1), vendorHash, and disables tests (doCheck = false). Reference nixpkgs-unstable for the base package structure, then apply the version/hash modifications.","status":"closed","priority":2,"issue_type":"chore","owner":"p@m3ta.dev","created_at":"2026-01-13T19:43:35.645275221+01:00","created_by":"m3tm3re","updated_at":"2026-01-13T20:25:53.715613545+01:00","closed_at":"2026-01-13T20:25:53.715613545+01:00","close_reason":"Packages created successfully: pkgs/n8n/default.nix, pkgs/beads/default.nix, pkgs/opencode/default.nix. All packages build successfully."}
+{"id":"nixpkgs-bqc","title":"opencode overlay -\u003e pkgs","description":"Create a full package definition in pkgs/opencode/default.nix that mirrors nixpkgs-unstable's opencode package but with version 1.1.18 and updated hashes from overlays/mods/opencode.nix. Register the new package in pkgs/default.nix. The overlay overrides: src (anomalyco/opencode@v1.1.18) and node_modules hash. Reference nixpkgs-unstable for the base package structure, then apply the version/hash modifications.","status":"closed","priority":2,"issue_type":"chore","owner":"p@m3ta.dev","created_at":"2026-01-13T19:43:36.450930004+01:00","created_by":"m3tm3re","updated_at":"2026-01-13T20:25:53.717928297+01:00","closed_at":"2026-01-13T20:25:53.717928297+01:00","close_reason":"Packages created successfully: pkgs/n8n/default.nix, pkgs/beads/default.nix, pkgs/opencode/default.nix. All packages build successfully."}
 {"id":"nixpkgs-e2u","title":"Change projectDirs from list to attrset with path and args","description":"Change projectDirs option type from 'types.listOf types.str' to an attrset like:\n\nprojectDirs = {\n  nixpkgs = { path = \"~/p/NIX/nixpkgs\"; args = \"--agent Planner-Sisyphus\"; };\n  myproject = { path = \"~/dev/myproject\"; };  # args optional\n};\n\nMust maintain backward compatibility consideration.","status":"closed","priority":1,"issue_type":"task","created_at":"2026-01-05T12:45:48.6992807+01:00","created_by":"m3tam3re","updated_at":"2026-01-05T12:48:12.178120719+01:00","closed_at":"2026-01-05T12:48:12.178120719+01:00","close_reason":"Changed projectDirs from listOf str to attrsOf submodule with path+args","dependencies":[{"issue_id":"nixpkgs-e2u","depends_on_id":"nixpkgs-w3u","type":"parent-child","created_at":"2026-01-05T12:46:00.515400521+01:00","created_by":"m3tam3re"}]}
+{"id":"nixpkgs-fka","title":"Ensure docs are staged and committed","status":"closed","priority":3,"issue_type":"task","created_at":"2026-01-10T18:48:18.05472995+01:00","created_by":"m3tam3re","updated_at":"2026-01-10T19:12:26.306880401+01:00","closed_at":"2026-01-10T19:12:26.306880401+01:00","close_reason":"Documentation staged and ready for commit"}
 {"id":"nixpkgs-hrh","title":"projectDirs on rofi-project-switcher should be exported to users home-manager environment","status":"closed","priority":2,"issue_type":"feature","created_at":"2026-01-05T11:46:43.640224459+01:00","created_by":"m3tam3re","updated_at":"2026-01-05T12:49:43.584087541+01:00","closed_at":"2026-01-05T12:49:43.584087541+01:00","close_reason":"Feature complete: config exported as ROFI_PROJECT_OPENER_CONFIG env var","dependencies":[{"issue_id":"nixpkgs-hrh","depends_on_id":"nixpkgs-w3u","type":"blocks","created_at":"2026-01-05T12:46:05.867959608+01:00","created_by":"m3tam3re"}]}
+{"id":"nixpkgs-p79","title":"feat: Add auto-language detection support to stt-ptt package","description":"## Current State\n- **Package**: `/home/m3tam3re/p/NIX/nixpkgs/pkgs/stt-ptt/default.nix`\n- **Module**: `/home/m3tam3re/p/NIX/nixpkgs/modules/home-manager/cli/stt-ptt.nix`\n- **Current whisper-cli call** (line 55): `\"$WHISPER\" -m \"$STT_MODEL\" -f \"$AUDIO\" -np -nt 2\u003e/dev/null`\n- **Missing**: Language configuration option and auto-detection\n\n## Required Changes\n\n### 1. Update Package (`pkgs/stt-ptt/default.nix`)\nAdd support for language configuration:\n- Add `STT_LANGUAGE` environment variable (default: \"auto\" for auto-detection)\n- Modify whisper-cli call to use `-l \"$STT_LANGUAGE\"` flag\n- Support the special value \"auto\" for automatic language detection\n- Update help text to document the new environment variable\n\n### 2. Update Home Manager Module (`modules/home-manager/cli/stt-ptt.nix`)\nAdd new `language` option:\n- Add `language` option with type `types.enum [\"auto\" \"en\" \"es\" \"fr\" \"de\" \"it\" \"pt\" \"ru\" \"zh\" \"ja\" \"ko\" ...]`\n- Default should be \"auto\" (auto-detect)\n- Set `STT_LANGUAGE` environment variable in `home.sessionVariables`\n- Add documentation describing available languages and auto-detection behavior\n- Consider using `types.nullOr(types.str)` with \"auto\" as default for more flexibility\n\n### 3. Technical Details\nFrom whisper.cpp CLI documentation:\n- `-l LANG, --language LANG [en] spoken language ('auto' for auto-detect)`\n- Auto-detection analyzes audio to determine spoken language automatically\n- Specifying a language can improve accuracy if you know the language\n- Language codes follow ISO 639-1 standard (2-letter codes)\n\n## Implementation Plan\n\n### Package Changes:\n```nix\n# Add to environment variables section:\nSTT_LANGUAGE=\"${STT_LANGUAGE:-auto}\"\n\n# Modify whisper call:\n\"$WHISPER\" -m \"$STT_MODEL\" -f \"$AUDIO\" -l \"$STT_LANGUAGE\" -np -nt 2\u003e/dev/null\n\n# Update help text:\necho \"  STT_LANGUAGE       - Language code or 'auto' for auto-detection (default: auto)\"\n```\n\n### Module Changes:\n```nix\nlanguage = mkOption {\n  type = types.enum [\"auto\" \"en\" \"es\" \"fr\" \"de\" \"it\" \"pt\" \"ru\" \"zh\" \"ja\" \"ko\"];\n  default = \"auto\";\n  description = ''\n    Language for speech recognition. Use \"auto\" for automatic language detection,\n    or specify a language code (e.g., \"en\", \"es\", \"fr\") for better accuracy.\n    Auto-detection analyzes the audio to determine the spoken language.\n  '';\n};\n\nhome.sessionVariables = {\n  STT_LANGUAGE = cfg.language;\n  # ... existing variables\n};\n```\n\n## Benefits\n- **Multilingual support**: Users can speak in any language\n- **Convenience**: Auto-detection eliminates need to specify language\n- **Accuracy**: Explicit language selection improves transcription accuracy\n- **Backward compatible**: Default behavior (auto) matches current functionality\n\n## Testing Considerations\n1. Test auto-detection with multiple languages\n2. Test explicit language selection\n3. Test fallback behavior when auto-detection fails\n4. Test with different Whisper models\n\n## Related\n- whisper.cpp supports 100+ languages\n- Language codes follow ISO 639-1 standard\n- Auto-detection adds slight processing overhead","status":"closed","priority":2,"issue_type":"feature","created_at":"2026-01-10T08:40:51.478869019+01:00","created_by":"m3tam3re","updated_at":"2026-01-10T09:35:49.421572334+01:00","closed_at":"2026-01-10T09:35:49.421572334+01:00","close_reason":"Implemented auto-language detection support: Added STT_LANGUAGE environment variable to package, modified whisper-cli call to use -l flag, updated help text, and added language option to HM module with enum support for 23 common languages plus 'auto'."}
+{"id":"nixpkgs-r3u","title":"Add a Gitea action for nix-update to automatically update packages","description":"Create a Gitea action that runs nix-update to automatically update packages in this repository. My Gitea instance runs on NixOS (hostname: m3-atlas). Check the Gitea configuration in /home/m3tam3re/p/NIX/nixos-config for reference on how to set up actions. The action should target the packages directory and create PRs with updates when nix-update finds newer versions.","status":"closed","priority":2,"issue_type":"task","owner":"p@m3ta.dev","created_at":"2026-01-13T19:50:22.953433727+01:00","created_by":"m3tm3re","updated_at":"2026-01-18T18:36:50.936219311+01:00","closed_at":"2026-01-17T09:49:05.573319795+01:00","dependencies":[{"issue_id":"nixpkgs-r3u","depends_on_id":"nixpkgs-69z","type":"discovered-from","created_at":"2026-01-13T19:52:40.98774707+01:00","created_by":"m3tm3re"},{"issue_id":"nixpkgs-r3u","depends_on_id":"nixpkgs-98j","type":"discovered-from","created_at":"2026-01-13T19:52:41.501620297+01:00","created_by":"m3tm3re"},{"issue_id":"nixpkgs-r3u","depends_on_id":"nixpkgs-bqc","type":"discovered-from","created_at":"2026-01-13T19:52:42.010721971+01:00","created_by":"m3tm3re"}]}
 {"id":"nixpkgs-sys","title":"Update config file format to include args per project","description":"Update the config file at ~/.config/rofi-project-opener/config to support per-project args. Change from PROJECT_DIRS to a format that encodes both path and args, e.g. JSON or structured text.","status":"closed","priority":1,"issue_type":"task","created_at":"2026-01-05T12:45:51.793810575+01:00","created_by":"m3tam3re","updated_at":"2026-01-05T12:48:21.75755315+01:00","closed_at":"2026-01-05T12:48:21.75755315+01:00","close_reason":"Config file now writes JSON (projects.json) with per-project path and args","dependencies":[{"issue_id":"nixpkgs-sys","depends_on_id":"nixpkgs-w3u","type":"parent-child","created_at":"2026-01-05T12:46:01.400263722+01:00","created_by":"m3tam3re"},{"issue_id":"nixpkgs-sys","depends_on_id":"nixpkgs-e2u","type":"blocks","created_at":"2026-01-05T12:46:04.055948778+01:00","created_by":"m3tam3re"}]}
+{"id":"nixpkgs-tsh","title":"Prevent verification of ignored packages in nix-update workflow","status":"closed","priority":2,"issue_type":"task","owner":"p@m3ta.dev","created_at":"2026-01-18T10:36:45.393068138+01:00","created_by":"m3tm3re","updated_at":"2026-01-18T10:37:31.686158451+01:00","closed_at":"2026-01-18T10:37:31.686158451+01:00","close_reason":"Fixed by changing return 0 to return 1 for ignored packages"}
 {"id":"nixpkgs-w3u","title":"projectDirs should support args, for example --agent \u003cagentname\u003e","description":"This means project directories need to be an attribute set and we also need to change the launch command to \"opencode \u003cdirectory name\u003e \u003carguments\u003e\".\n","status":"closed","priority":2,"issue_type":"feature","created_at":"2026-01-05T11:56:13.844735432+01:00","created_by":"m3tam3re","updated_at":"2026-01-05T12:49:42.34144046+01:00","closed_at":"2026-01-05T12:49:42.34144046+01:00","close_reason":"Feature complete: projectDirs now supports args per directory"}
+{"id":"nixpkgs-xi7","title":"There is a bug in the basecamp-mcp server","description":"OSError: [Errno 30] Read-only file system when trying to write log file.\n\nTraceback:\nFile: /nix/store/708ksr7z3484bj8faysd7djwpa8xvw12-basecamp-mcp-server-0.0.1-unstable/lib/basecamp-mcp-server/basecamp_fastmcp.py, line 35\nError: logging.FileHandler(LOG_FILE_PATH) - attempting to write to read-only Nix store location: /nix/store/708ksr7z3484bj8faysd7djwpa8xvw12-basecamp-mcp-server-0.0.1-unstable/lib/basecamp-mcp-server/basecamp_fastmcp.log\n\nThe package needs to use a writable directory (e.g., XDG_DATA_HOME or /tmp) for log files instead of the Nix store.","status":"closed","priority":2,"issue_type":"bug","created_at":"2026-01-12T18:16:37.597147907+01:00","created_by":"m3tam3re","updated_at":"2026-01-12T19:12:57.91076765+01:00","closed_at":"2026-01-12T19:12:57.91076765+01:00","close_reason":"Closed"}

.beads/sync_base.jsonl

@@ -0,0 +1,18 @@
+{"id":"nixpkgs-1xm","title":"Package Basecamp MCP Server","status":"closed","priority":2,"issue_type":"task","created_at":"2026-01-12T05:01:20.465656454+01:00","created_by":"m3tam3re","updated_at":"2026-01-12T05:01:26.623404603+01:00","closed_at":"2026-01-12T05:01:26.623404603+01:00","close_reason":"Packaged successfully with env file support"}
+{"id":"nixpkgs-3k8","title":"Export project config as environment variable","description":"Export project configuration as home.sessionVariables (similar to zellij-ps pattern). Use JSON format for the env var since projects now have structured data (path + args).","status":"closed","priority":2,"issue_type":"task","created_at":"2026-01-05T12:45:50.803017318+01:00","created_by":"m3tam3re","updated_at":"2026-01-05T12:48:22.968626155+01:00","closed_at":"2026-01-05T12:48:22.968626155+01:00","close_reason":"Added home.sessionVariables.ROFI_PROJECT_OPENER_CONFIG with JSON config","dependencies":[{"issue_id":"nixpkgs-3k8","depends_on_id":"nixpkgs-hrh","type":"parent-child","created_at":"2026-01-05T12:46:03.16885012+01:00","created_by":"m3tam3re"}]}
+{"id":"nixpkgs-3w3","title":"Add authentication command and environment file generation to basecamp-mcp-server","description":"The basecamp-mcp-server package at pkgs/basecamp-mcp-server/default.nix wraps the FastMCP server for Basecamp 3 integration. Currently, there's no convenient way for users to:\n\n1. Set up OAuth 2.0 authentication interactively\n2. Generate a sample environment file with required credentials\n3. Guide users through the Basecamp OAuth flow\n\n## Current State\n\nThe package wraps  but users must:\n- Manually clone the upstream repository\n- Run  to generate  template\n- Edit  with OAuth credentials from https://launchpad.37signals.com/integrations\n- Run  to complete OAuth flow\n- Handle token storage manually\n\n## Required Environment Variables\n\n### OAuth Configuration (Primary)\n-  - OAuth client ID from Basecamp\n-  - OAuth client secret\n-  - Found in Basecamp URL: https://3.basecamp.com/ID/...\n-  - Format: \"App Name (email@domain.com)\"\n-  - http://localhost:8000/auth/callback\n-  - For Flask session security\n\n### Basic Auth (Legacy)\n-  - Email for direct API access\n-  - Password for direct API access\n\n## Proposed Solution\n\nAdd a Nix package wrapper command () that:\n\n1. **Interactive Setup Wizard**\n   - Guides users through OAuth app creation at launchpad.37signals.com\n   - Prompts for credentials (with secure input for secrets)\n   - Validates inputs before proceeding\n\n2. **Environment File Generation**\n   - Creates  or project-local \n   - Includes all required variables with clear documentation\n   - Sets secure permissions (600)\n   - Provides example values\n\n3. **OAuth Flow Handler**\n   - Starts local Flask server on port 8000\n   - Opens browser to initiate OAuth flow\n   - Handles callback and token exchange\n   - Stores tokens securely in \n   - Shows success/failure status\n\n4. **Documentation**\n   - Inline help for all steps\n   - Links to Basecamp integration setup\n   - Account ID discovery instructions\n\n## References\n\n- Upstream repo: https://github.com/georgeantonopoulos/Basecamp-MCP-Server\n- Key files: , , , \n- OAuth endpoints: launchpad.37signals.com/authorization/new\n\n## Subtasks\n\n- [ ] Create auth command wrapper (basecamp-mcp-auth)\n- [ ] Implement interactive OAuth wizard\n- [ ] Generate sample environment file template\n- [ ] Add token storage handling\n- [ ] Update package documentation\n- [ ] Add Home Manager module support (optional)","status":"closed","priority":2,"issue_type":"feature","created_at":"2026-01-12T18:25:50.929926505+01:00","created_by":"m3tam3re","updated_at":"2026-01-12T19:12:57.941267399+01:00","closed_at":"2026-01-12T19:12:57.941267399+01:00","close_reason":"Closed"}
+{"id":"nixpkgs-5ml","title":"Update rofi-project-opener script to pass args to opencode","description":"Modify pkgs/rofi-project-opener script to read the new config format and launch opencode with: 'opencode <directory> <arguments>' instead of just 'opencode' in the directory.","status":"closed","priority":1,"issue_type":"task","created_at":"2026-01-05T12:45:49.748958951+01:00","created_by":"m3tam3re","updated_at":"2026-01-05T12:49:40.800083615+01:00","closed_at":"2026-01-05T12:49:40.800083615+01:00","close_reason":"Script updated to read JSON config and pass args to opencode","dependencies":[{"issue_id":"nixpkgs-5ml","depends_on_id":"nixpkgs-w3u","type":"parent-child","created_at":"2026-01-05T12:46:02.338350208+01:00","created_by":"m3tam3re"},{"issue_id":"nixpkgs-5ml","depends_on_id":"nixpkgs-sys","type":"blocks","created_at":"2026-01-05T12:46:04.966269033+01:00","created_by":"m3tam3re"}]}
+{"id":"nixpkgs-61l","title":"Update documentation to reflect latest changes","status":"closed","priority":3,"issue_type":"task","created_at":"2026-01-10T18:48:19.599467206+01:00","created_by":"m3tam3re","updated_at":"2026-01-10T19:12:26.294895563+01:00","closed_at":"2026-01-10T19:12:26.294895563+01:00","close_reason":"Documentation updated: Added stt-ptt language support docs, rofi-project-opener module docs, and updated zellij-ps docs"}
+{"id":"nixpkgs-69z","title":"n8n overlay -> pkgs","description":"Create a full package definition in pkgs/n8n/default.nix that mirrors nixpkgs-unstable's n8n package but with version 2.4.1 and updated hashes from overlays/mods/n8n.nix. Register the new package in pkgs/default.nix. The overlay overrides: src (n8n-io/n8n@2.4.1) and pnpmDeps hash. Reference nixpkgs-unstable for the base package structure, then apply the version/hash modifications.","status":"closed","priority":2,"issue_type":"chore","owner":"p@m3ta.dev","created_at":"2026-01-13T19:42:35.643928163+01:00","created_by":"m3tm3re","updated_at":"2026-01-13T20:25:53.712987689+01:00","closed_at":"2026-01-13T20:25:53.712987689+01:00","close_reason":"Packages created successfully: pkgs/n8n/default.nix, pkgs/beads/default.nix, pkgs/opencode/default.nix. All packages build successfully."}
+{"id":"nixpkgs-7ez","title":"Add authentication command for basecamp-mcp-server","description":"Add a command for the basecamp-mcp-server that will guide the user through the authentication flow and create a sample environment file with the necessary values. This involves researching the original basecamp-mcp-server repository for authentication details and implementing a user-friendly authentication workflow.","status":"tombstone","priority":0,"issue_type":"feature","created_at":"2026-01-12T18:20:55.665717166+01:00","created_by":"m3tam3re","updated_at":"2026-01-13T19:46:32.112562429+01:00","dependencies":[{"issue_id":"nixpkgs-7ez","depends_on_id":"nixpkgs-3w3","type":"blocks","created_at":"2026-01-12T18:48:31.806330931+01:00","created_by":"m3tam3re"}],"deleted_at":"2026-01-13T19:46:32.112562429+01:00","deleted_by":"daemon","delete_reason":"delete","original_type":"feature"}
+{"id":"nixpkgs-8jw","title":"fix: self-hosted nixos runner missing node in PATH for Gitea Actions","description":"The nix-update workflow fails on self-hosted nixos runner because node is not available in PATH. Error: Cannot find: node in PATH. Root cause: actions/checkout@v4 requires Node.js to execute post-checkout steps. The self-hosted nixos runner does not have node installed or not in PATH. Possible solutions: 1) Add Node.js to the nixos runner environment, 2) Use container-based runner instead of bare nixos, 3) Use a different checkout action that does not require node, 4) Configure PATH to include node installation. Impact: Automated package updates are completely blocked.","status":"open","priority":1,"issue_type":"bug","owner":"p@m3ta.dev","created_at":"2026-01-14T20:50:59.153145341+01:00","created_by":"m3tm3re","updated_at":"2026-01-14T20:51:34.044954071+01:00"}
+{"id":"nixpkgs-98j","title":"beads overlay -> pkgs","description":"Create a full package definition in pkgs/beads/default.nix that mirrors nixpkgs-unstable's beads package but with version 0.47.1 and updated hashes from overlays/mods/beads.nix. Register the new package in pkgs/default.nix. The overlay overrides: src (steveyegge/beads@v0.47.1), vendorHash, and disables tests (doCheck = false). Reference nixpkgs-unstable for the base package structure, then apply the version/hash modifications.","status":"closed","priority":2,"issue_type":"chore","owner":"p@m3ta.dev","created_at":"2026-01-13T19:43:35.645275221+01:00","created_by":"m3tm3re","updated_at":"2026-01-13T20:25:53.715613545+01:00","closed_at":"2026-01-13T20:25:53.715613545+01:00","close_reason":"Packages created successfully: pkgs/n8n/default.nix, pkgs/beads/default.nix, pkgs/opencode/default.nix. All packages build successfully."}
+{"id":"nixpkgs-bqc","title":"opencode overlay -> pkgs","description":"Create a full package definition in pkgs/opencode/default.nix that mirrors nixpkgs-unstable's opencode package but with version 1.1.18 and updated hashes from overlays/mods/opencode.nix. Register the new package in pkgs/default.nix. The overlay overrides: src (anomalyco/opencode@v1.1.18) and node_modules hash. Reference nixpkgs-unstable for the base package structure, then apply the version/hash modifications.","status":"closed","priority":2,"issue_type":"chore","owner":"p@m3ta.dev","created_at":"2026-01-13T19:43:36.450930004+01:00","created_by":"m3tm3re","updated_at":"2026-01-13T20:25:53.717928297+01:00","closed_at":"2026-01-13T20:25:53.717928297+01:00","close_reason":"Packages created successfully: pkgs/n8n/default.nix, pkgs/beads/default.nix, pkgs/opencode/default.nix. All packages build successfully."}
+{"id":"nixpkgs-e2u","title":"Change projectDirs from list to attrset with path and args","description":"Change projectDirs option type from 'types.listOf types.str' to an attrset like:\n\nprojectDirs = {\n  nixpkgs = { path = \"~/p/NIX/nixpkgs\"; args = \"--agent Planner-Sisyphus\"; };\n  myproject = { path = \"~/dev/myproject\"; };  # args optional\n};\n\nMust maintain backward compatibility consideration.","status":"closed","priority":1,"issue_type":"task","created_at":"2026-01-05T12:45:48.6992807+01:00","created_by":"m3tam3re","updated_at":"2026-01-05T12:48:12.178120719+01:00","closed_at":"2026-01-05T12:48:12.178120719+01:00","close_reason":"Changed projectDirs from listOf str to attrsOf submodule with path+args","dependencies":[{"issue_id":"nixpkgs-e2u","depends_on_id":"nixpkgs-w3u","type":"parent-child","created_at":"2026-01-05T12:46:00.515400521+01:00","created_by":"m3tam3re"}]}
+{"id":"nixpkgs-fka","title":"Ensure docs are staged and committed","status":"closed","priority":3,"issue_type":"task","created_at":"2026-01-10T18:48:18.05472995+01:00","created_by":"m3tam3re","updated_at":"2026-01-10T19:12:26.306880401+01:00","closed_at":"2026-01-10T19:12:26.306880401+01:00","close_reason":"Documentation staged and ready for commit"}
+{"id":"nixpkgs-hrh","title":"projectDirs on rofi-project-switcher should be exported to users home-manager environment","status":"closed","priority":2,"issue_type":"feature","created_at":"2026-01-05T11:46:43.640224459+01:00","created_by":"m3tam3re","updated_at":"2026-01-05T12:49:43.584087541+01:00","closed_at":"2026-01-05T12:49:43.584087541+01:00","close_reason":"Feature complete: config exported as ROFI_PROJECT_OPENER_CONFIG env var","dependencies":[{"issue_id":"nixpkgs-hrh","depends_on_id":"nixpkgs-w3u","type":"blocks","created_at":"2026-01-05T12:46:05.867959608+01:00","created_by":"m3tam3re"}]}
+{"id":"nixpkgs-p79","title":"feat: Add auto-language detection support to stt-ptt package","description":"## Current State\n- **Package**: `/home/m3tam3re/p/NIX/nixpkgs/pkgs/stt-ptt/default.nix`\n- **Module**: `/home/m3tam3re/p/NIX/nixpkgs/modules/home-manager/cli/stt-ptt.nix`\n- **Current whisper-cli call** (line 55): `\"$WHISPER\" -m \"$STT_MODEL\" -f \"$AUDIO\" -np -nt 2>/dev/null`\n- **Missing**: Language configuration option and auto-detection\n\n## Required Changes\n\n### 1. Update Package (`pkgs/stt-ptt/default.nix`)\nAdd support for language configuration:\n- Add `STT_LANGUAGE` environment variable (default: \"auto\" for auto-detection)\n- Modify whisper-cli call to use `-l \"$STT_LANGUAGE\"` flag\n- Support the special value \"auto\" for automatic language detection\n- Update help text to document the new environment variable\n\n### 2. Update Home Manager Module (`modules/home-manager/cli/stt-ptt.nix`)\nAdd new `language` option:\n- Add `language` option with type `types.enum [\"auto\" \"en\" \"es\" \"fr\" \"de\" \"it\" \"pt\" \"ru\" \"zh\" \"ja\" \"ko\" ...]`\n- Default should be \"auto\" (auto-detect)\n- Set `STT_LANGUAGE` environment variable in `home.sessionVariables`\n- Add documentation describing available languages and auto-detection behavior\n- Consider using `types.nullOr(types.str)` with \"auto\" as default for more flexibility\n\n### 3. Technical Details\nFrom whisper.cpp CLI documentation:\n- `-l LANG, --language LANG [en] spoken language ('auto' for auto-detect)`\n- Auto-detection analyzes audio to determine spoken language automatically\n- Specifying a language can improve accuracy if you know the language\n- Language codes follow ISO 639-1 standard (2-letter codes)\n\n## Implementation Plan\n\n### Package Changes:\n```nix\n# Add to environment variables section:\nSTT_LANGUAGE=\"${STT_LANGUAGE:-auto}\"\n\n# Modify whisper call:\n\"$WHISPER\" -m \"$STT_MODEL\" -f \"$AUDIO\" -l \"$STT_LANGUAGE\" -np -nt 2>/dev/null\n\n# Update help text:\necho \"  STT_LANGUAGE       - Language code or 'auto' for auto-detection (default: auto)\"\n```\n\n### Module Changes:\n```nix\nlanguage = mkOption {\n  type = types.enum [\"auto\" \"en\" \"es\" \"fr\" \"de\" \"it\" \"pt\" \"ru\" \"zh\" \"ja\" \"ko\"];\n  default = \"auto\";\n  description = ''\n    Language for speech recognition. Use \"auto\" for automatic language detection,\n    or specify a language code (e.g., \"en\", \"es\", \"fr\") for better accuracy.\n    Auto-detection analyzes the audio to determine the spoken language.\n  '';\n};\n\nhome.sessionVariables = {\n  STT_LANGUAGE = cfg.language;\n  # ... existing variables\n};\n```\n\n## Benefits\n- **Multilingual support**: Users can speak in any language\n- **Convenience**: Auto-detection eliminates need to specify language\n- **Accuracy**: Explicit language selection improves transcription accuracy\n- **Backward compatible**: Default behavior (auto) matches current functionality\n\n## Testing Considerations\n1. Test auto-detection with multiple languages\n2. Test explicit language selection\n3. Test fallback behavior when auto-detection fails\n4. Test with different Whisper models\n\n## Related\n- whisper.cpp supports 100+ languages\n- Language codes follow ISO 639-1 standard\n- Auto-detection adds slight processing overhead","status":"closed","priority":2,"issue_type":"feature","created_at":"2026-01-10T08:40:51.478869019+01:00","created_by":"m3tam3re","updated_at":"2026-01-10T09:35:49.421572334+01:00","closed_at":"2026-01-10T09:35:49.421572334+01:00","close_reason":"Implemented auto-language detection support: Added STT_LANGUAGE environment variable to package, modified whisper-cli call to use -l flag, updated help text, and added language option to HM module with enum support for 23 common languages plus 'auto'."}
+{"id":"nixpkgs-r3u","title":"Add a Gitea action for nix-update to automatically update packages","description":"Create a Gitea action that runs nix-update to automatically update packages in this repository. My Gitea instance runs on NixOS (hostname: m3-atlas). Check the Gitea configuration in /home/m3tam3re/p/NIX/nixos-config for reference on how to set up actions. The action should target the packages directory and create PRs with updates when nix-update finds newer versions.","status":"open","priority":2,"issue_type":"task","owner":"p@m3ta.dev","created_at":"2026-01-13T19:50:22.953433727+01:00","created_by":"m3tm3re","updated_at":"2026-01-13T19:52:40.071361668+01:00","dependencies":[{"issue_id":"nixpkgs-r3u","depends_on_id":"nixpkgs-69z","type":"discovered-from","created_at":"2026-01-13T19:52:40.98774707+01:00","created_by":"m3tm3re"},{"issue_id":"nixpkgs-r3u","depends_on_id":"nixpkgs-98j","type":"discovered-from","created_at":"2026-01-13T19:52:41.501620297+01:00","created_by":"m3tm3re"},{"issue_id":"nixpkgs-r3u","depends_on_id":"nixpkgs-bqc","type":"discovered-from","created_at":"2026-01-13T19:52:42.010721971+01:00","created_by":"m3tm3re"}]}
+{"id":"nixpkgs-sys","title":"Update config file format to include args per project","description":"Update the config file at ~/.config/rofi-project-opener/config to support per-project args. Change from PROJECT_DIRS to a format that encodes both path and args, e.g. JSON or structured text.","status":"closed","priority":1,"issue_type":"task","created_at":"2026-01-05T12:45:51.793810575+01:00","created_by":"m3tam3re","updated_at":"2026-01-05T12:48:21.75755315+01:00","closed_at":"2026-01-05T12:48:21.75755315+01:00","close_reason":"Config file now writes JSON (projects.json) with per-project path and args","dependencies":[{"issue_id":"nixpkgs-sys","depends_on_id":"nixpkgs-w3u","type":"parent-child","created_at":"2026-01-05T12:46:01.400263722+01:00","created_by":"m3tam3re"},{"issue_id":"nixpkgs-sys","depends_on_id":"nixpkgs-e2u","type":"blocks","created_at":"2026-01-05T12:46:04.055948778+01:00","created_by":"m3tam3re"}]}
+{"id":"nixpkgs-w3u","title":"projectDirs should support args, for example --agent <agentname>","description":"This means project directories need to be an attribute set and we also need to change the launch command to \"opencode <directory name> <arguments>\".\n","status":"closed","priority":2,"issue_type":"feature","created_at":"2026-01-05T11:56:13.844735432+01:00","created_by":"m3tam3re","updated_at":"2026-01-05T12:49:42.34144046+01:00","closed_at":"2026-01-05T12:49:42.34144046+01:00","close_reason":"Feature complete: projectDirs now supports args per directory"}
+{"id":"nixpkgs-xi7","title":"There is a bug in the basecamp-mcp server","description":"OSError: [Errno 30] Read-only file system when trying to write log file.\n\nTraceback:\nFile: /nix/store/708ksr7z3484bj8faysd7djwpa8xvw12-basecamp-mcp-server-0.0.1-unstable/lib/basecamp-mcp-server/basecamp_fastmcp.py, line 35\nError: logging.FileHandler(LOG_FILE_PATH) - attempting to write to read-only Nix store location: /nix/store/708ksr7z3484bj8faysd7djwpa8xvw12-basecamp-mcp-server-0.0.1-unstable/lib/basecamp-mcp-server/basecamp_fastmcp.log\n\nThe package needs to use a writable directory (e.g., XDG_DATA_HOME or /tmp) for log files instead of the Nix store.","status":"closed","priority":2,"issue_type":"bug","created_at":"2026-01-12T18:16:37.597147907+01:00","created_by":"m3tam3re","updated_at":"2026-01-12T19:12:57.91076765+01:00","closed_at":"2026-01-12T19:12:57.91076765+01:00","close_reason":"Closed"}

.gitattributes

@@ -0,0 +1,3 @@
+
+# Use bd merge for beads JSONL files
+.beads/issues.jsonl merge=beads

.gitea/workflows/nix-update.yml

@@ -0,0 +1,423 @@
+name: Update Nix Packages with nix-update
+
+on:
+  schedule:
+    - cron: "0 2,14 * * *" # Every 12 hours at 2 AM and 2 PM
+  workflow_dispatch:
+    inputs:
+      package:
+        description: "Specific package to update (optional)"
+        required: false
+        type: string
+
+concurrency:
+  group: nix-update-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  GIT_AUTHOR_NAME: "nix-update bot"
+  GIT_AUTHOR_EMAIL: "bot@m3ta.dev"
+  GIT_COMMITTER_NAME: "nix-update bot"
+  GIT_COMMITTER_EMAIL: "bot@m3ta.dev"
+  REPO_DIR: "/tmp/nixpkgs"
+
+  # Nix configuration
+  NIX_PATH: "nixpkgs=channel:nixos-unstable"
+  NIX_CONFIG: "experimental-features = nix-command flakes"
+
+  # Non-interactive mode
+  DEBIAN_FRONTEND: "noninteractive"
+  GIT_TERMINAL_PROMPT: "0"
+
+jobs:
+  nix-update:
+    runs-on: nixos
+    timeout-minutes: 180
+    steps:
+      - name: Setup Environment and Authenticate
+        run: |
+          if [ -d "$REPO_DIR" ]; then rm -rf "$REPO_DIR"; fi
+
+          git config --global credential.helper store
+          echo "https://m3tam3re:${{ secrets.NIX_UPDATE_TOKEN }}@code.m3ta.dev" > ~/.git-credentials
+          chmod 600 ~/.git-credentials
+
+          git config --global user.name "$GIT_AUTHOR_NAME"
+          git config --global user.email "$GIT_AUTHOR_EMAIL"
+          git config --global init.defaultBranch master
+
+      - name: Checkout Repository
+        run: |
+          git clone --no-single-branch \
+            "https://m3tam3re@code.m3ta.dev/m3tam3re/nixpkgs.git" \
+            "$REPO_DIR"
+
+      - name: Update opencode Flake Input
+        id: update-opencode
+        run: |
+          cd "$REPO_DIR"
+
+          echo "::group::Checking for opencode updates"
+
+          # Get latest release from GitHub API (strip v prefix for comparison)
+          LATEST_RELEASE=$(curl -s "https://api.github.com/repos/anomalyco/opencode/releases/latest" | jq -r '.tag_name' | sed 's/^v//')
+
+          # Extract current version from flake.nix
+          CURRENT_VERSION=$(grep -oP 'opencode\.url = "github:anomalyco/opencode/v\K[^"]+' flake.nix)
+
+          echo "Current opencode version: $CURRENT_VERSION"
+          echo "Latest opencode version: $LATEST_RELEASE"
+
+          # Check if update is needed
+          if [ "$LATEST_RELEASE" != "$CURRENT_VERSION" ]; then
+            echo "🔄 Updating opencode from $CURRENT_VERSION to $LATEST_RELEASE"
+
+            # Update flake.nix with new version
+            sed -i 's|opencode\.url = "github:anomalyco/opencode/v.*"|opencode.url = "github:anomalyco/opencode/v'"$LATEST_RELEASE"'"|' flake.nix
+
+            # Update flake lock to fetch new revision
+            nix flake update opencode
+
+            # Format with alejandra
+            nix fmt flake.nix
+
+            # Verify the update
+            echo "::endgroup::"
+            echo "::group::Verifying opencode update"
+
+            # Run flake check
+            if ! nix flake check; then
+              echo "❌ Flake check failed after opencode update"
+              git checkout flake.nix flake.lock
+              exit 1
+            fi
+
+            # Build opencode package
+            if ! nix build .#opencode 2>&1 | tee /tmp/opencode-build.log; then
+              echo "❌ Build failed for opencode"
+              git checkout flake.nix flake.lock
+              exit 1
+            fi
+
+            echo "✅ Flake check passed"
+            echo "✅ Build successful for opencode"
+            echo "::endgroup::"
+
+            # Commit the change
+            echo "::group::Committing opencode update"
+            git add flake.nix flake.lock
+            git commit -m "chore: update opencode flake input to $LATEST_RELEASE"
+
+            echo "opencode_update=true" >> $GITHUB_OUTPUT
+            echo "opencode_version=${LATEST_RELEASE}" >> $GITHUB_OUTPUT
+            echo "::endgroup::"
+
+            echo "✅ Updated opencode to $LATEST_RELEASE"
+          else
+            echo "✓ opencode is already up to date"
+            echo "opencode_update=false" >> $GITHUB_OUTPUT
+            echo "opencode_version=${CURRENT_VERSION}" >> $GITHUB_OUTPUT
+            echo "::endgroup::"
+          fi
+
+      - name: Check Prerequisites
+        id: check
+        run: |
+          cd "$REPO_DIR"
+          if [ ! -d "pkgs" ]; then
+             echo "❌ Error: 'pkgs' directory not found."
+             exit 1
+          fi
+
+          if [ -f "flake.nix" ]; then
+            echo "has_flake=true" >> $GITHUB_OUTPUT
+          else
+            echo "has_flake=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Update Packages
+        id: update
+        run: |
+          cd "$REPO_DIR"
+          set -e
+
+          git checkout master
+
+          UPDATES_FOUND=false
+          UPDATED_PACKAGES=""
+
+          check_commit() {
+             [ "$1" != "$(git rev-parse HEAD)" ] && echo "true" || echo "false"
+          }
+
+          has_update_script() {
+             local pkg=$1
+             # Check if package has passthru.updateScript attribute
+             nix eval .#${pkg}.passthru.updateScript --json >/dev/null 2>&1
+          }
+
+          run_update() {
+              local pkg=$1
+              local before_hash=$(git rev-parse HEAD)
+
+              echo "::group::Updating $pkg"
+
+              local args=("--flake" "--commit" "--use-github-releases")
+
+              args+=("$pkg")
+
+             if nix-update "${args[@]}" 2>&1 | tee /tmp/update-${pkg}.log; then
+                if [ "$(check_commit "$before_hash")" = "true" ]; then
+                   echo "✅ Updated $pkg"
+                   echo "::endgroup::"
+                   return 0
+                fi
+             fi
+             echo "::endgroup::"
+
+             if ! grep -q "already up to date\|No new version found" /tmp/update-${pkg}.log; then
+                echo "⚠️ Update failed for $pkg"
+             fi
+             return 1
+          }
+
+          if [ -n "${{ inputs.package }}" ]; then
+            pkg="${{ inputs.package }}"
+            if [ -d "pkgs/$pkg" ]; then
+               if run_update "$pkg"; then
+                  UPDATES_FOUND=true
+                  UPDATED_PACKAGES="$pkg"
+               fi
+            else
+               echo "❌ Package 'pkgs/$pkg' not found"
+            fi
+          else
+            # Dynamically discover packages with updateScript attribute
+            echo "🔍 Discovering packages with passthru.updateScript..."
+
+            # Get all packages and filter those with updateScript
+            ALL_PACKAGES=$(find pkgs -mindepth 1 -maxdepth 1 -type d -exec basename {} \; 2>/dev/null | sort)
+            UPDATABLE_PACKAGES=""
+
+            if [ -z "$ALL_PACKAGES" ]; then
+              echo "No packages found in pkgs/"
+              exit 0
+            fi
+
+            for pkg in $ALL_PACKAGES; do
+              if has_update_script "$pkg"; then
+                echo "  ✓ $pkg (has updateScript)"
+                UPDATABLE_PACKAGES="$UPDATABLE_PACKAGES $pkg"
+              else
+                echo "  ⊘ $pkg (no updateScript - skipping)"
+              fi
+            done
+
+            if [ -z "$UPDATABLE_PACKAGES" ]; then
+              echo "ℹ️ No packages with updateScript found."
+              exit 0
+            fi
+
+            echo ""
+            echo "📦 Found $(echo $UPDATABLE_PACKAGES | wc -w) updatable packages"
+            echo ""
+
+            # Parallel updates with 4 concurrent jobs
+            MAX_JOBS=4
+            JOB_COUNT=0
+            SUCCESS_LIST=()
+
+            for pkg in $UPDATABLE_PACKAGES; do
+              (run_update "$pkg" && echo "$pkg" >> /tmp/success.txt || true) &
+
+              JOB_COUNT=$((JOB_COUNT + 1))
+
+              # Wait if we hit max concurrent jobs
+              if [ $JOB_COUNT -ge $MAX_JOBS ]; then
+                wait
+                JOB_COUNT=0
+              fi
+            done
+
+            # Wait for remaining jobs
+            wait
+
+            # Parse results
+            if [ -f /tmp/success.txt ]; then
+              SUCCESS_LIST=$(cat /tmp/success.txt | tr '\n' ' ')
+              UPDATED_PACKAGES=$(echo "$SUCCESS_LIST" | sed 's/ /, /g' | sed 's/, $//')
+              UPDATES_FOUND=true
+            fi
+
+            rm -f /tmp/success.txt
+          fi
+
+          COMMIT_COUNT=$(git rev-list --count origin/master..HEAD)
+
+          if [ "$COMMIT_COUNT" -gt 0 ]; then
+            echo "✅ $COMMIT_COUNT updates committed locally."
+            echo "has_updates=true" >> $GITHUB_OUTPUT
+            echo "updated_packages=${UPDATED_PACKAGES}" >> $GITHUB_OUTPUT
+          else
+            echo "ℹ️ No updates found."
+            echo "has_updates=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Verify Builds
+        if: steps.update.outputs.has_updates == 'true' || steps.update-opencode.outputs.opencode_update == 'true'
+        run: |
+          cd "$REPO_DIR"
+
+          echo "::group::Running flake check"
+          if ! nix flake check; then
+            echo "❌ Flake check failed"
+            exit 1
+          fi
+          echo "✅ Flake check passed"
+          echo "::endgroup::"
+
+          IFS=', ' read -ra PKGS <<< "${{ steps.update.outputs.updated_packages }}"
+
+          FAILED_PACKAGES=()
+          SUCCESSFUL_PACKAGES=()
+
+          for pkg in "${PKGS[@]}"; do
+            echo "::group::Building $pkg"
+            if nix build .#$pkg 2>&1 | tee /tmp/build-${pkg}.log; then
+              echo "✅ Build successful for $pkg"
+              SUCCESSFUL_PACKAGES+=("$pkg")
+            else
+              echo "❌ Build failed for $pkg"
+              FAILED_PACKAGES+=("$pkg")
+            fi
+            echo "::endgroup::"
+          done
+
+          if [ ${#FAILED_PACKAGES[@]} -gt 0 ]; then
+            echo ""
+            echo "❌ Failed packages: ${FAILED_PACKAGES[*]}"
+            echo "✅ Successful packages: ${SUCCESSFUL_PACKAGES[*]}"
+            echo ""
+
+            # Upload logs as artifacts for debugging
+            echo "## Build Failure Logs" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            for pkg in "${FAILED_PACKAGES[@]}"; do
+              echo "### $pkg" >> $GITHUB_STEP_SUMMARY
+              echo '```bash' >> $GITHUB_STEP_SUMMARY
+              cat /tmp/build-${pkg}.log >> $GITHUB_STEP_SUMMARY
+              echo '```' >> $GITHUB_STEP_SUMMARY
+            done
+
+            exit 1
+          fi
+
+          echo ""
+          echo "✅ All packages built successfully: ${SUCCESSFUL_PACKAGES[*]}"
+
+      - name: Push Changes
+        if: steps.update.outputs.has_updates == 'true' || steps.update-opencode.outputs.opencode_update == 'true'
+        run: |
+          cd "$REPO_DIR"
+          PACKAGES="${{ steps.update.outputs.updated_packages }}"
+
+          # Add opencode to packages list if it was updated
+          if [ "${{ steps.update-opencode.outputs.opencode_update }}" = "true" ]; then
+            if [ -n "$PACKAGES" ]; then
+              PACKAGES="$PACKAGES, opencode"
+            else
+              PACKAGES="opencode"
+            fi
+          fi
+
+          echo "::group::Git Operations"
+          echo "Current commit: $(git rev-parse HEAD)"
+          echo "Pending commits: $(git rev-list --count origin/master..HEAD)"
+
+          echo ""
+          echo "Pulling latest changes (rebase)..."
+          if git pull --rebase origin master; then
+            echo "✅ Rebase successful"
+          else
+            echo "⚠️ Rebase failed, attempting force push..."
+            git reset --hard origin/master
+            git push --force-with-lease origin master
+            echo "✓ Force push completed"
+            exit 0
+          fi
+
+          echo ""
+          echo "Pushing changes to master..."
+          git push origin master
+
+          echo ""
+          echo "✅ Successfully pushed updates for: $PACKAGES"
+          echo "::endgroup::"
+
+      - name: Upload Build Logs
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-logs-${{ github.run_number }}
+          path: |
+            /tmp/update-*.log
+            /tmp/build-*.log
+            /tmp/opencode-build.log
+          retention-days: 7
+
+      - name: Cleanup
+        if: always()
+        run: |
+          # Remove git credentials securely
+          rm -f ~/.git-credentials
+          git config --global --unset credential.helper 2>/dev/null || true
+
+          # Remove temporary directory
+          rm -rf "$REPO_DIR"
+
+          # Remove all log files
+          rm -f /tmp/update-*.log /tmp/build-*.log /tmp/opencode-build.log /tmp/update-log.txt /tmp/success-packages.txt
+
+          # Clear sensitive environment variables
+          unset GIT_AUTHOR_EMAIL GIT_COMMITTER_EMAIL
+
+      - name: Summary
+        if: always()
+        run: |
+          HAS_UPDATES="false"
+
+          if [ "${{ steps.update.outputs.has_updates }}" = "true" ]; then
+            HAS_UPDATES="true"
+            echo "# ✅ Update Summary" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "## Updated Packages" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "\`${{ steps.update.outputs.updated_packages }}\`" >> $GITHUB_STEP_SUMMARY
+          fi
+
+          if [ "${{ steps.update-opencode.outputs.opencode_update }}" = "true" ]; then
+            HAS_UPDATES="true"
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "## Updated Flake Input" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "- **opencode**: \`v${{ steps.update-opencode.outputs.opencode_version }}\`" >> $GITHUB_STEP_SUMMARY
+          fi
+
+          if [ "$HAS_UPDATES" = "true" ]; then
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "## Status" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "- ✅ All updates validated with \`nix flake check\`" >> $GITHUB_STEP_SUMMARY
+            echo "- ✅ All builds successful" >> $GITHUB_STEP_SUMMARY
+            echo "- ✅ Changes pushed to master" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "## Workflow Performance" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "- Started: ${{ github.event.head_commit.timestamp }}" >> $GITHUB_STEP_SUMMARY
+            echo "- Completed: $(date -u +'%Y-%m-%d %H:%M:%S UTC')" >> $GITHUB_STEP_SUMMARY
+            echo "- Workflow Run: [#${{ github.run_number }}](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }})" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "# ℹ️ No Updates Required" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "No updates found this run. All packages and flake inputs are up to date." >> $GITHUB_STEP_SUMMARY
+          fi

AGENTS.md

@@ -1,7 +1,7 @@
 # m3ta-nixpkgs Knowledge Base
 
-**Generated:** 2025-12-30
-**Commit:** c5e1610
+**Generated:** 2026-01-13
+**Commit:** 366af12
 **Branch:** master
 
 ## OVERVIEW
@@ -21,30 +21,34 @@ Personal Nix flake: custom packages, overlays, NixOS/Home Manager modules, dev s
 ├── shells/                # Dev environments (default, python, devops)
 ├── overlays/mods/         # Package modifications (n8n version bump)
 ├── templates/             # Boilerplate for new packages/modules
-└── examples/              # Usage examples
+├── examples/              # Usage examples
+└── .gitea/workflows/     # CI/CD workflows (nix-update automation)
 ```
 
 ## WHERE TO LOOK
 
 | Task                 | Location                           | Notes                                 |
-|------|----------|-------|
+| -------------------- | ---------------------------------- | ------------------------------------- |
 | Add package          | `pkgs/<name>/default.nix`          | Register in `pkgs/default.nix`        |
 | Add NixOS module     | `modules/nixos/<name>.nix`         | Import in `modules/nixos/default.nix` |
 | Add HM module        | `modules/home-manager/<category>/` | Category: cli, coding, or root        |
 | Override nixpkgs pkg | `overlays/mods/<name>.nix`         | Import in `overlays/mods/default.nix` |
 | Add dev shell        | `shells/<name>.nix`                | Register in `shells/default.nix`      |
 | Use port management  | `config.m3ta.ports.get "service"`  | Host-specific via `hostOverrides`     |
+| CI/CD workflows      | `.gitea/workflows/<name>.yml`      | Automated package updates (nix-update) |
 
 ## CONVENTIONS
 
 **Formatter**: `nix fmt` before commit (alejandra)
 
 **Naming**:
+
 - Packages: `lowercase-hyphen` (e.g., `hyprpaper-random`)
 - Variables: `camelCase` (e.g., `portHelpers`)
 - Module options: `m3ta.*` namespace
 
 **Imports**: Multi-line, trailing commas:
+
 ```nix
 {
   lib,
@@ -54,6 +58,7 @@ Personal Nix flake: custom packages, overlays, NixOS/Home Manager modules, dev s
 ```
 
 **Modules**: Standard pattern:
+
 ```nix
 { config, lib, pkgs, ... }:
 with lib; let
@@ -67,6 +72,7 @@ in {
 ```
 
 **Meta**: Always include all fields:
+
 ```nix
 meta = with lib; {
   description = "...";
@@ -120,7 +126,7 @@ deadnix .                    # Find dead code
 ## ANTI-PATTERNS
 
 | Don't                     | Do Instead                                                          |
-|-------|------------|
+| ------------------------- | ------------------------------------------------------------------- |
 | `lib.fakeHash` in commits | Get real hash: `nix build`, copy from error                         |
 | Flat module files         | Organize by category (`cli/`, `coding/`)                            |
 | Hardcode ports            | Use `m3ta.ports` module                                             |
@@ -142,29 +148,18 @@ Types: `feat`, `fix`, `docs`, `style`, `refactor`, `chore`
 - **Ports module**: Different for NixOS vs HM (HM adds `generateEnvVars` option)
 - **Overlays**: `modifications` overlay uses `{prev}:` pattern, not `{final, prev}:`
 - **Dev shell tools**: `statix`, `deadnix` only available inside `nix develop`
+- **Automated package updates**: Packages are automatically updated weekly via Gitea Actions using `nix-update`. Review PRs from the automation before merging. For urgent updates, manually run the workflow or update manually.
 
-## Landing the Plane (Session Completion)
+## Issue Tracking
 
-**When ending a work session**, you MUST complete ALL steps below. Work is NOT complete until `git push` succeeds.
+This project uses **bd (beads)** for issue tracking.
+Run `bd prime` for workflow context, or install hooks (`bd hooks install`) for auto-injection.
 
-**MANDATORY WORKFLOW:**
+**Quick reference:**
 
-1. **File issues for remaining work** - Create issues for anything that needs follow-up
-2. **Run quality gates** (if code changed) - Tests, linters, builds
-3. **Update issue status** - Close finished work, update in-progress items
-4. **PUSH TO REMOTE** - This is MANDATORY:
-   ```bash
-   git pull --rebase
-   bd sync
-   git push
-   git status  # MUST show "up to date with origin"
-   ```
-5. **Clean up** - Clear stashes, prune remote branches
-6. **Verify** - All changes committed AND pushed
-7. **Hand off** - Provide context for next session
+- `bd ready` - Find unblocked work
+- `bd create "Title" --type task --priority 2` - Create issue
+- `bd close <id>` - Complete work
+- `bd sync` - Sync with git (run at session end)
 
-**CRITICAL RULES:**
-- Work is NOT complete until `git push` succeeds
-- NEVER stop before pushing - that leaves work stranded locally
-- NEVER say "ready to push when you are" - YOU must push
-- If push fails, resolve and retry until it succeeds
+For full workflow details: `bd prime`

README.md

@@ -40,18 +40,41 @@ nix run git+https://code.m3ta.dev/m3tam3re/nixpkgs#zellij-ps
 
 | Package            | Description                           |
 | ------------------ | ------------------------------------- |
+| `beads`            | Lightweight memory system for AI coding agents with graph-based issue tracking |
 | `code2prompt`      | Convert code to prompts               |
 | `hyprpaper-random` | Random wallpaper setter for Hyprpaper |
 | `launch-webapp`    | Launch web applications               |
 | `mem0`             | AI memory assistant with vector storage |
 | `msty-studio`      | Msty Studio application               |
+| `n8n`              | Free and source-available fair-code licensed workflow automation tool |
+| `opencode`         | AI coding agent built for the terminal |
 | `pomodoro-timer`   | Pomodoro timer utility                |
 | `rofi-project-opener` | Rofi-based project launcher        |
 | `stt-ptt`          | Push to Talk Speech to Text           |
 | `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).
 

docs/CONTRIBUTING.md

@@ -110,6 +110,8 @@ in {
 
 See [Adding Packages Guide](./guides/adding-packages.md) for detailed instructions.
 
+**Note**: Package versions are automatically updated weekly via Gitea Actions using `nix-update`. You don't need to worry about keeping versions current - the automation will create PRs for updates. Just focus on ensuring the package builds and works correctly.
+
 ### Package Testing
 
 ```bash
@@ -270,6 +272,17 @@ nix flake show
 6. [ ] Documentation updated if needed
 7. [ ] Commit messages follow convention
 
+### Handling Automated Update PRs
+
+The repository has automated package updates via Gitea Actions (see main README for details). When reviewing automated update PRs:
+
+1. **Build and test**: Verify the updated package builds successfully
+2. **Check changelinks**: Review upstream release notes for breaking changes
+3. **Test functionality**: Ensure the package still works as expected
+4. **Review package definition**: Check if any manual adjustments are needed
+
+For urgent updates, you can manually trigger the workflow from the Gitea UI or update the package manually.
+
 ### PR Description
 
 Include:

docs/README.md

@@ -28,11 +28,14 @@ Step-by-step guides for common tasks:
 
 Documentation for all custom packages:
 
+- [beads](./packages/beads.md) - Lightweight memory system for AI coding agents with graph-based issue tracking
 - [code2prompt](./packages/code2prompt.md) - Convert code to prompts
 - [hyprpaper-random](./packages/hyprpaper-random.md) - Random wallpaper setter for Hyprpaper
 - [launch-webapp](./packages/launch-webapp.md) - Launch web applications
 - [mem0](./packages/mem0.md) - AI memory assistant with vector storage
 - [msty-studio](./packages/msty-studio.md) - Msty Studio application
+- [n8n](./packages/n8n.md) - Free and source-available fair-code licensed workflow automation tool
+- [opencode](./packages/opencode.md) - AI coding agent built for terminal
 - [pomodoro-timer](./packages/pomodoro-timer.md) - Pomodoro timer utility
 - [rofi-project-opener](./packages/rofi-project-opener.md) - Rofi-based project launcher with custom args
 - [stt-ptt](./packages/stt-ptt.md) - Push to Talk Speech to Text using Whisper

docs/guides/adding-packages.md

@@ -18,6 +18,17 @@ nix flake init -t .#package my-new-package
 
 This creates a template structure in `templates/package/` that you can copy.
 
+### Automatic Updates
+
+**Important**: This repository uses automated package updates via Gitea Actions and `nix-update`. When adding a new package:
+
+- Use any stable, working version for the initial package
+- You don't need to use the absolute latest version
+- The automation will keep the package updated automatically on a weekly basis
+- Review and merge automated update PRs as they come in
+
+See the main README.md for more details on the automated update workflow.
+
 ### Manual Setup
 
 1. Create directory: `pkgs/your-package/`

docs/guides/getting-started.md

@@ -246,7 +246,7 @@ home-manager switch
     m3ta-nixpkgs.homeManagerModules.default
   ];
 
-  m3ta.cli.zellij-ps = {
+  cli.zellij-ps = {
     enable = true;
   };
 

docs/guides/using-modules.md

@@ -170,12 +170,12 @@ m3ta.ports = {
 
 **Documentation**: [Port Management Guide](./port-management.md)
 
-#### `m3ta.cli.zellij-ps`
+#### `cli.zellij-ps`
 
 Zellij project switcher for quickly navigating between project folders.
 
 ```nix
-m3ta.cli.zellij-ps = {
+cli.zellij-ps = {
   enable = true;
   package = pkgs.zellij-ps;
 };
@@ -183,7 +183,7 @@ m3ta.cli.zellij-ps = {
 
 **Documentation**: [zellij-ps Module](../modules/home-manager/cli/zellij-ps.md)
 
-#### `m3ta.coding.editors`
+#### `coding.editors`
 
 Editor configurations.
 
@@ -395,12 +395,12 @@ config = mkIf cfg.enable {
   };
 
   # CLI tools
-  m3ta.cli.zellij-ps = {
+  cli.zellij-ps = {
     enable = true;
   };
 
   # Coding tools
-  m3ta.coding.editors = {
+  coding.editors = {
     enable = true;
     neovim.enable = true;
   };

docs/modules/home-manager/cli/rofi-project-opener.md

@@ -0,0 +1,219 @@
+# rofi-project-opener Module
+
+Home Manager module for configuring the rofi-project-opener package.
+
+## Overview
+
+This module provides declarative configuration for rofi-project-opener, a Rofi-based project launcher. It generates the necessary configuration files and installs the package.
+
+## Quick Start
+
+```nix
+{config, pkgs, ...}: {
+  cli.rofi-project-opener = {
+    enable = true;
+    projectDirs = {
+      dev = { path = "~/dev"; };
+      work = { path = "~/work"; args = "--agent work-assistant"; };
+    };
+  };
+}
+```
+
+## Options
+
+### `cli.rofi-project-opener.enable`
+
+Whether to enable rofi-project-opener.
+
+**Type:** `boolean`
+**Default:** `false`
+
+### `cli.rofi-project-opener.projectDirs`
+
+Attribute set of base directories to scan for project subdirectories.
+
+**Type:** `attrsOf (submodule)`
+
+Each entry is a submodule with:
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `path` | `str` | required | Base directory path (supports `~`) |
+| `args` | `str` | `""` | Arguments to pass to command |
+
+**Default:**
+```nix
+{
+  dev = { path = "~/dev"; };
+  projects = { path = "~/projects"; };
+}
+```
+
+**Example:**
+```nix
+projectDirs = {
+  nixpkgs = { path = "~/p/NIX"; args = "--agent nix-expert"; };
+  chat = { path = "~/p/CHAT"; args = "--agent chiron"; };
+  dev = { path = "~/dev"; };
+  work = { path = "~/work"; args = "--profile work"; };
+};
+```
+
+### `cli.rofi-project-opener.terminal`
+
+Terminal emulator to use for launching projects.
+
+**Type:** `either str package`
+**Default:** `"kitty"`
+
+**Examples:**
+```nix
+# Using a package
+terminal = pkgs.kitty;
+terminal = pkgs.alacritty;
+
+# Using a string (must be in PATH)
+terminal = "kitty";
+terminal = "wezterm";
+```
+
+### `cli.rofi-project-opener.terminalCommand`
+
+Command to run in the terminal after navigating to the project directory.
+
+**Type:** `str`
+**Default:** `""` (runs `opencode` with args)
+
+**Placeholders:**
+- `%s` - Project path
+- `%a` - Project args (from `projectDirs.<name>.args`)
+
+**Examples:**
+```nix
+# Default behavior - run opencode with project args
+terminalCommand = "";
+
+# Explicit opencode with args
+terminalCommand = "opencode %a";
+
+# Different editor
+terminalCommand = "nvim";
+
+# VSCode with path
+terminalCommand = "code %s";
+
+# Custom application
+terminalCommand = "my-dev-tool --project %s %a";
+```
+
+### `cli.rofi-project-opener.rofiPrompt`
+
+Prompt text displayed in the Rofi menu.
+
+**Type:** `str`
+**Default:** `"Select project"`
+
+### `cli.rofi-project-opener.rofiArgs`
+
+Arguments to pass to Rofi.
+
+**Type:** `listOf str`
+**Default:** `["-dmenu" "-i"]`
+
+**Example:**
+```nix
+rofiArgs = ["-dmenu" "-i" "-theme" "gruvbox" "-width" "50"];
+```
+
+## Generated Files
+
+The module generates these configuration files:
+
+### `~/.config/rofi-project-opener/projects.json`
+
+JSON file containing project directories:
+
+```json
+{
+  "dev": {"path": "~/dev", "args": ""},
+  "work": {"path": "~/work", "args": "--agent work-assistant"}
+}
+```
+
+### `~/.config/rofi-project-opener/config`
+
+Shell configuration file:
+
+```bash
+TERMINAL="/nix/store/.../bin/kitty"
+TERMINAL_CMD="opencode %a"
+ROFI_PROMPT="Select project"
+ROFI_ARGS="-dmenu -i"
+```
+
+## Full Example
+
+```nix
+{config, pkgs, ...}: {
+  imports = [m3ta-nixpkgs.homeManagerModules.default];
+
+  cli.rofi-project-opener = {
+    enable = true;
+
+    # Project directories with optional args
+    projectDirs = {
+      nixpkgs = {
+        path = "~/p/NIX";
+        args = "";
+      };
+      chat = {
+        path = "~/p/CHAT";
+        args = "--agent chiron";
+      };
+      dev = {
+        path = "~/dev";
+        args = "";
+      };
+    };
+
+    # Terminal configuration
+    terminal = pkgs.kitty;
+    terminalCommand = "opencode %a";
+
+    # Rofi configuration
+    rofiPrompt = "Open Project";
+    rofiArgs = ["-dmenu" "-i" "-theme" "nord"];
+  };
+}
+```
+
+## Usage
+
+After enabling, run:
+
+```bash
+rofi-project-opener
+```
+
+Or bind to a keyboard shortcut in your window manager:
+
+**Hyprland:**
+```nix
+wayland.windowManager.hyprland.settings.bind = [
+  "$mod, P, exec, rofi-project-opener"
+];
+```
+
+**Sway:**
+```nix
+wayland.windowManager.sway.config.keybindings = {
+  "${modifier}+p" = "exec rofi-project-opener";
+};
+```
+
+## Related
+
+- [rofi-project-opener Package](../../../packages/rofi-project-opener.md) - Package documentation
+- [zellij-ps Module](./zellij-ps.md) - Similar project switcher for Zellij
+- [Home Manager Overview](../overview.md) - All Home Manager modules

docs/modules/home-manager/cli/stt-ptt.md

@@ -104,6 +104,42 @@ Notification timeout in milliseconds for the recording indicator.
 - Default: `3000`
 - Example: `5000` (5 seconds), `0` (persistent)
 
+### `cli.stt-ptt.language`
+
+Language for speech recognition. Use "auto" for automatic language detection, or specify a language code for better accuracy.
+
+- Type: `enum ["auto", "en", "es", "fr", "de", "it", "pt", "ru", "zh", "ja", "ko", "ar", "hi", "tr", "pl", "nl", "sv", "da", "fi", "no", "vi", "th", "id", "uk", "cs"]`
+- Default: `"auto"`
+
+**Auto-detection**: When set to "auto", whisper.cpp analyzes the audio to determine the spoken language automatically.
+
+**Language specification**: Specifying a language code improves transcription accuracy if you know the language in advance.
+
+```nix
+# Automatic language detection (default)
+language = "auto";
+
+# Force English transcription
+language = "en";
+
+# Spanish transcription
+language = "es";
+```
+
+**Common language codes:**
+
+| Code | Language |
+|------|----------|
+| `en` | English |
+| `es` | Spanish |
+| `fr` | French |
+| `de` | German |
+| `zh` | Chinese |
+| `ja` | Japanese |
+| `ko` | Korean |
+
+whisper.cpp supports 100+ languages. See whisper.cpp documentation for the full list.
+
 ## Usage
 
 After enabling, bind `stt-ptt start` and `stt-ptt stop` to a key:
@@ -166,6 +202,16 @@ cli.stt-ptt = {
 };
 ```
 
+### Language-Specific Transcription
+
+```nix
+cli.stt-ptt = {
+  enable = true;
+  model = "ggml-large-v3-turbo";
+  language = "es";  # Force Spanish transcription
+};
+```
+
 ### High Quality with NVIDIA GPU
 
 ```nix
@@ -221,6 +267,7 @@ The module sets these automatically:
 | Variable | Value |
 |----------|-------|
 | `STT_MODEL` | `~/.local/share/stt-ptt/models/<model>.bin` |
+| `STT_LANGUAGE` | Configured language ("auto" by default) |
 | `STT_NOTIFY_TIMEOUT` | Configured timeout in ms |
 
 ## Requirements

docs/modules/home-manager/cli/zellij-ps.md

@@ -12,7 +12,7 @@ This module configures the zellij-ps tool, a Fish script that provides a fast, i
 {config, ...}: {
   imports = [m3ta-nixpkgs.homeManagerModules.default];
 
-  m3ta.cli.zellij-ps = {
+  cli.zellij-ps = {
     enable = true;
   };
 }
@@ -20,14 +20,14 @@ This module configures the zellij-ps tool, a Fish script that provides a fast, i
 
 ## Module Options
 
-### `m3ta.cli.zellij-ps.enable`
+### `cli.zellij-ps.enable`
 
 Enable zellij-ps module.
 
 - Type: `boolean`
 - Default: `false`
 
-### `m3ta.cli.zellij-ps.package`
+### `cli.zellij-ps.package`
 
 Custom package to use.
 
@@ -60,7 +60,7 @@ zellij-ps ~/projects/my-project
 Use a custom or modified package:
 
 ```nix
-m3ta.cli.zellij-ps = {
+cli.zellij-ps = {
   enable = true;
   package = pkgs.callPackage ./my-zellij-ps {};
 };

docs/modules/home-manager/overview.md

@@ -62,12 +62,12 @@ m3ta.ports = {
 };
 
 # CLI tools
-m3ta.cli.zellij-ps = {
+cli.zellij-ps = {
   enable = true;
 };
 
 # Coding tools
-m3ta.coding.editors = {
+coding.editors = {
   enable = true;
   neovim.enable = true;
 };
@@ -137,11 +137,11 @@ Development tools and configurations:
     currentHost = "desktop";
   };
 
-  m3ta.cli.zellij-ps = {
+  cli.zellij-ps = {
     enable = true;
   };
 
-  m3ta.coding.editors = {
+  coding.editors = {
     enable = true;
     neovim.enable = true;
   };

docs/packages/beads.md

@@ -0,0 +1,220 @@
+# beads
+
+Lightweight memory system for AI coding agents with graph-based issue tracking.
+
+## Description
+
+beads is a command-line tool designed to provide persistent memory and issue tracking for AI coding agents. It features a graph-based system for managing issues, dependencies, and discovered work across development sessions.
+
+## Features
+
+- 🧠 **Persistent Memory**: Store and retrieve context across AI sessions
+- 📊 **Graph-Based Issue Tracking**: Manage issues with dependency relationships
+- 🔄 **Discovered Work**: Track work discovered during development
+- 🎯 **Multi-Session Continuity**: Resume work from previous sessions
+- 📝 **Git Integration**: Seamless integration with git workflows
+- 🐚 **Shell Completions**: Bash, Fish, and Zsh completions included
+
+## Installation
+
+### Via Overlay
+
+```nix
+{pkgs, ...}: {
+  environment.systemPackages = with pkgs; [
+    beads
+  ];
+}
+```
+
+### Direct Reference
+
+```nix
+{pkgs, ...}: {
+  environment.systemPackages = with pkgs; [
+    inputs.m3ta-nixpkgs.packages.${pkgs.system}.beads
+  ];
+}
+```
+
+### Run Directly
+
+```bash
+nix run git+https://code.m3ta.dev/m3tam3re/nixpkgs#beads
+```
+
+## Usage
+
+### Basic Commands
+
+```bash
+# Show available issues ready to work on
+bd ready
+
+# Create a new issue
+bd create "Fix authentication bug" --type bug --priority 2
+
+# Show issue details
+bd show beads-123
+
+# Update issue status
+bd update beads-123 --status in_progress
+
+# Close completed issues
+bd close beads-123
+
+# Sync with git remote
+bd sync
+```
+
+### Issue Types
+
+- `task`: General tasks
+- `bug`: Bug fixes
+- `feature`: New features
+- `epic`: Large-scale initiatives
+
+### Priority Levels
+
+- `0` (P0): Critical
+- `1` (P1): High
+- `2` (P2): Medium
+- `3` (P3): Low
+- `4` (P4): Backlog
+
+### Dependency Management
+
+```bash
+# Add dependency (beads-123 depends on beads-456)
+bd dep add beads-123 beads-456
+
+# Show blocked issues
+bd blocked
+
+# Show what blocks an issue
+bd show beads-123 --blocked-by
+```
+
+## Advanced Usage
+
+### Finding Work
+
+```bash
+# Show ready tasks (no blockers)
+bd ready
+
+# Show all open issues
+bd list --status open
+
+# Show in-progress work
+bd list --status in_progress
+```
+
+### Assignment
+
+```bash
+# Assign issue to yourself
+bd update beads-123 --assignee username
+
+# Create assigned issue
+bd create "Review PR" --assignee reviewer
+```
+
+### Bulk Operations
+
+```bash
+# Close multiple issues at once
+bd close beads-123 beads-456 beads-789
+
+# Close with reason
+bd close beads-123 --reason "Completed in v1.2.0"
+```
+
+### Hooks
+
+```bash
+# Install git hooks for automatic sync
+bd hooks install
+
+# Remove hooks
+bd hooks uninstall
+```
+
+## Configuration
+
+### Environment Variables
+
+- `BEADS_DATA_DIR`: Custom directory for beads data (default: `.beads/`)
+- `BEADS_CONFIG`: Custom configuration file path
+- `BEADS_EDITOR`: Default editor for editing issues
+
+### Git Integration
+
+beads integrates with git for version-controlled issue tracking:
+
+- Automatic sync before commits (via hooks)
+- Issue references in commit messages
+- Branch name tracking
+- Git-aware issue states
+
+## Workflow Integration
+
+### Typical Development Workflow
+
+1. **Start session**: `bd prime` or check `bd ready`
+2. **Claim work**: `bd update beads-123 --status in_progress`
+3. **Work on task**: Implement changes
+4. **Discover new work**: `bd create "Discovered subtask"` as needed
+5. **Complete task**: `bd close beads-123`
+6. **Sync**: `bd sync` (automatic via hooks)
+
+### Team Collaboration
+
+```bash
+# Create issue and assign
+bd create "Implement feature X" --assignee dev1
+
+# Review assigned work
+bd list --assignee yourname
+
+# Close with review notes
+bd close beads-123 --reason "Reviewed and approved"
+```
+
+## Shell Completions
+
+beads provides shell completions for bash, fish, and zsh:
+
+```bash
+# Bash completions are auto-loaded
+source <(bd completion bash)
+
+# Fish completions
+bd completion fish | source
+
+# Zsh completions
+bd completion zsh > ~/.zfunc/_bd
+```
+
+## Build Information
+
+- **Version**: 0.47.1
+- **Language**: Go
+- **License**: MIT
+- **Source**: [GitHub](https://github.com/steveyegge/beads)
+
+## Platform Support
+
+- Linux
+- macOS
+
+## Notes
+
+- Tests are disabled in the Nix package due to git worktree operations that fail in the sandbox
+- Security tests on Darwin are skipped due to `/etc/passwd` unavailability in sandbox
+- Shell completions are installed for platforms that can execute the build target
+
+## Related
+
+- [Adding Packages](../guides/adding-packages.md) - How to add new packages
+- [Quick Start](../QUICKSTART.md) - Getting started guide

docs/packages/n8n.md

@@ -0,0 +1,310 @@
+# n8n
+
+Free and source-available fair-code licensed workflow automation tool. Easily automate tasks across different services.
+
+## Description
+
+n8n (pronounced "n-eight-n") is a workflow automation tool that helps you connect different services and automate tasks without writing code. It features a visual node-based editor for creating workflows with hundreds of integrations.
+
+## Features
+
+- 🎨 **Visual Workflow Editor**: Drag-and-drop interface for creating workflows
+- 🔗 **Hundreds of Integrations**: Connect to popular services (Slack, GitHub, Google, etc.)
+- 🔄 **Webhook Support**: Trigger workflows via HTTP requests
+- 📝 **Code Node**: Execute JavaScript/TypeScript code within workflows
+- 🚀 **Cloud & Self-Hosted**: Use n8n Cloud or self-host on your own infrastructure
+- 📊 **Data Transformation**: Map and transform data between services
+- ⏰ **Scheduling**: Run workflows on schedules (cron-like)
+- 🔒 **Security**: Credential management and secure data handling
+- 🎯 **Fair-Code License**: Source available with usage restrictions for commercial use
+
+## Installation
+
+### Via Overlay
+
+```nix
+{pkgs, ...}: {
+  environment.systemPackages = with pkgs; [
+    n8n
+  ];
+}
+```
+
+### Direct Reference
+
+```nix
+{pkgs, ...}: {
+  environment.systemPackages = with pkgs; [
+    inputs.m3ta-nixpkgs.packages.${pkgs.system}.n8n
+  ];
+}
+```
+
+### Run Directly
+
+```bash
+nix run git+https://code.m3ta.dev/m3tam3re/nixpkgs#n8n
+```
+
+## Usage
+
+### Basic Usage
+
+```bash
+# Start n8n (default configuration)
+n8n start
+
+# Start with custom configuration file
+n8n start --config /path/to/config
+
+# Run in worker mode (for production with queue)
+n8n worker
+
+# Execute a workflow from file
+n8n execute /path/to/workflow.json
+```
+
+### Development Mode
+
+```bash
+# Start with tunnel (external access)
+n8n start --tunnel
+
+# Disable telemetry
+n8n start --no-telemetry
+
+# Specify workflow directory
+n8n start --workflows /path/to/workflows
+
+# Enable/disable features
+n8n start --enable-editor
+n8n start --disable-metrics
+```
+
+### Workflow Management
+
+```bash
+# Export workflow to file
+n8n export:workflow --id=123 --output=workflow.json
+
+# Import workflow from file
+n8n import:workflow --input=workflow.json
+
+# Execute workflow
+n8n execute:workflow --id=123
+```
+
+## Configuration
+
+### Environment Variables
+
+- `N8N_BASIC_AUTH_ACTIVE`: Enable basic authentication (default: false)
+- `N8N_BASIC_AUTH_USER`: Basic auth username
+- `N8N_BASIC_AUTH_PASSWORD`: Basic auth password
+- `N8N_ENCRYPTION_KEY`: Encryption key for credentials
+- `N8N_HOST`: Host URL for web UI (default: localhost)
+- `N8N_PORT`: Port for web UI (default: 5678)
+- `N8N_PROTOCOL`: Protocol (http or https)
+- `N8N_PATH`: Path to mount n8n (default: /)
+- `N8N_EDITOR_BASE_URL`: Base URL for editor
+- `N8N_WEBHOOK_URL`: URL for webhook endpoints
+- `N8N_TIMEZONE`: Timezone for execution (default: UTC)
+- `N8N_LOG_LEVEL`: Logging level (output, warn, error, verbose)
+- `N8N_LOG_OUTPUT`: Log output destination (console, file)
+- `N8N_METRICS`: Enable metrics collection (default: true)
+- `DB_TYPE`: Database type (sqlite3db, postgresdb, mysqldb)
+- `DB_SQLITE_VACUUM_ON_STARTUP`: Vacuum SQLite on startup
+
+### Database Configuration
+
+By default, n8n uses SQLite for simplicity. For production, use PostgreSQL or MySQL:
+
+```bash
+# PostgreSQL
+export DB_TYPE=postgresdb
+export DB_POSTGRESDB_HOST=localhost
+export DB_POSTGRESDB_PORT=5432
+export DB_POSTGRESDB_DATABASE=n8n
+export DB_POSTGRESDB_USER=n8n
+export DB_POSTGRESDB_PASSWORD=yourpassword
+
+# MySQL/MariaDB
+export DB_TYPE=mysqldb
+export DB_MYSQLDB_HOST=localhost
+export DB_MYSQLDB_PORT=3306
+export DB_MYSQLDB_DATABASE=n8n
+export DB_MYSQLDB_USER=n8n
+export DB_MYSQLDB_PASSWORD=yourpassword
+```
+
+### Security
+
+Set up encryption for credentials:
+
+```bash
+# Generate encryption key
+export N8N_ENCRYPTION_KEY=$(openssl rand -base64 32)
+
+# Use in production
+export N8N_ENCRYPTION_KEY="your-32-char-encryption-key"
+```
+
+## NixOS Module
+
+For NixOS, use the n8n module from nixpkgs for a complete service configuration:
+
+```nix
+services.n8n = {
+  enable = true;
+  settings = {
+    host = "0.0.0.0";
+    port = 5678;
+    timezone = "UTC";
+  };
+  environment = {
+    N8N_ENCRYPTION_KEY = "your-encryption-key";
+    DB_TYPE = "postgresdb";
+    DB_POSTGRESDB_HOST = "/var/run/postgresql";
+    DB_POSTGRESDB_DATABASE = "n8n";
+  };
+};
+```
+
+## Use Cases
+
+### Webhook Automation
+
+Trigger workflows via HTTP requests:
+
+```bash
+# Start n8n with tunnel for public URL
+n8n start --tunnel
+
+# Create webhook workflow in UI
+# Workflow receives data from external service
+# Process and send to another service
+```
+
+### Scheduled Tasks
+
+Run tasks on a schedule:
+
+```javascript
+// In workflow editor, use Schedule Trigger
+// Set cron expression: "0 9 * * *" (daily at 9 AM)
+// Connect to nodes that perform tasks
+```
+
+### Data Sync Between Services
+
+Keep data synchronized:
+
+```bash
+# Create workflow with:
+# 1. Webhook trigger (service A)
+# 2. Data transformation node
+# 3. HTTP request node (service B)
+# 4. Response back to service A
+```
+
+### Automated Reporting
+
+Generate and send reports:
+
+```javascript
+// Workflow steps:
+// 1. Schedule trigger (daily/weekly)
+// 2. Database query node
+// 3. Data formatting
+// 4. Email or Slack notification
+```
+
+## Integration Examples
+
+### Slack Integration
+
+```javascript
+// Create Slack notification workflow
+// 1. Trigger (webhook or schedule)
+// 2. Process data
+// 3. Send message to Slack channel
+```
+
+### GitHub Integration
+
+```javascript
+// GitHub repository automation
+// 1. GitHub webhook trigger (push, PR, issue)
+// 2. Conditional logic
+// 3. Actions (create issue, comment, etc.)
+```
+
+### Email Automation
+
+```javascript
+// Email processing workflow
+// 1. Email trigger (IMAP)
+// 2. Parse email content
+// 3. Process data
+// 4. Send response or forward
+```
+
+## Performance Optimization
+
+### Production Tips
+
+- Use PostgreSQL or MySQL instead of SQLite
+- Enable queue mode with Redis
+- Use worker nodes for scaling
+- Configure proper resource limits
+- Set up load balancing for web UI
+
+### Queue Mode
+
+```bash
+# Start main n8n process
+export QUEUE_BULL_REDIS_HOST=redis-server
+export QUEUE_BULL_REDIS_PORT=6379
+n8n start
+
+# Start worker processes
+n8n worker
+```
+
+## Build Information
+
+- **Version**: 2.4.1
+- **Language**: TypeScript/JavaScript (Node.js)
+- **Package Manager**: pnpm
+- **License**: Sustainable Use (Fair-Code)
+- **Source**: [GitHub](https://github.com/n8n-io/n8n)
+
+## Dependencies
+
+- `nodejs` - JavaScript runtime
+- `pnpm` - Package manager (build-time)
+- `python3` - Required for SQLite bindings
+- `node-gyp` - Node.js native addon build tool
+- `libkrb5` - Kerberos authentication
+- `libmongocrypt` - MongoDB encryption
+- `libpq` - PostgreSQL client library
+
+## Platform Support
+
+- Linux
+- macOS
+
+## Notes
+
+- Package has ~80,000 files, so stripping and ELF patching are disabled for performance
+- SQLite3 bindings are rebuilt during build phase
+- TypeScript files and source maps are removed in preInstall phase
+- Non-deterministic files (.turbo, .modules.yaml, types) are removed
+- Node modules are pruned to production dependencies only
+
+## Related
+
+- [Adding Packages](../guides/adding-packages.md) - How to add new packages
+- [Quick Start](../QUICKSTART.md) - Getting started guide
+- [n8n Documentation](https://docs.n8n.io) - Official documentation
+- [n8n Community](https://community.n8n.io) - Community forum

docs/packages/opencode.md

@@ -0,0 +1,346 @@
+# opencode
+
+AI coding agent built for the terminal that can build anything. Combines a TypeScript/JavaScript core with a Go-based TUI for an interactive AI coding experience.
+
+## Description
+
+OpenCode is a terminal-based AI coding agent designed for power users. It provides a comprehensive development environment with AI assistance, code generation, refactoring, and project management capabilities. The tool features a sophisticated TUI (Terminal User Interface) built with Go, while the core functionality is implemented in TypeScript/JavaScript.
+
+## Features
+
+- 🤖 **AI-Powered Coding**: Generate, refactor, and optimize code with AI assistance
+- 🖥️ **Modern TUI**: Beautiful terminal interface built with Go
+- 🔍 **Code Understanding**: Parse and understand existing codebases
+- 🌳 **Tree-Sitter Integration**: Accurate syntax highlighting and code structure analysis
+- 📁 **Project Management**: Navigate and manage projects efficiently
+- 🧠 **Multi-LLM Support**: Works with various language models (OpenAI, Anthropic, etc.)
+- 📝 **Code Generation**: Create new files and features from natural language
+- 🔄 **Refactoring**: Intelligent code refactoring with AI
+- 🐛 **Bug Detection**: Find and fix bugs automatically
+- 📚 **Context Awareness**: Maintains context across editing sessions
+- 🎯 **Task Orchestration**: Break down and execute complex tasks
+- 💾 **Local Development**: Runs entirely on your machine
+
+## Installation
+
+### Via Overlay
+
+```nix
+{pkgs, ...}: {
+  environment.systemPackages = with pkgs; [
+    opencode
+  ];
+}
+```
+
+### Direct Reference
+
+```nix
+{pkgs, ...}: {
+  environment.systemPackages = with pkgs; [
+    inputs.m3ta-nixpkgs.packages.${pkgs.system}.opencode
+  ];
+}
+```
+
+### Run Directly
+
+```bash
+nix run git+https://code.m3ta.dev/m3tam3re/nixpkgs#opencode
+```
+
+## Usage
+
+### Basic Usage
+
+```bash
+# Start OpenCode in current directory
+opencode
+
+# Open specific project
+opencode /path/to/project
+
+# Start with specific task description
+opencode "Fix the login bug"
+
+# Show help
+opencode --help
+
+# Show version
+opencode --version
+```
+
+### Interactive Commands
+
+OpenCode provides an interactive TUI with various commands:
+
+- **Navigation**: Arrow keys to move, Enter to select
+- **Search**: `/` to search files, `?` for help
+- **Edit**: `e` to edit selected file
+- **Command Palette**: `Ctrl+p` to access commands
+- **AI Chat**: `Ctrl+c` to open AI chat
+- **Exit**: `q` or `Ctrl+d` to quit
+
+### AI Chat Mode
+
+```bash
+# Start OpenCode
+opencode
+
+# Enter AI chat mode (Ctrl+c)
+# Ask questions, request code changes, etc.
+# Examples:
+# - "Generate a REST API endpoint for user management"
+# - "Refactor this function to use async/await"
+# - "Find and fix potential memory leaks"
+# - "Add unit tests for this module"
+```
+
+### Task Management
+
+```bash
+# Ask OpenCode to work on a specific task
+opencode "Implement authentication with JWT tokens"
+
+# The agent will:
+# 1. Understand the codebase
+# 2. Plan the implementation
+# 3. Generate necessary code
+# 4. Make the changes
+# 5. Verify the implementation
+```
+
+## Configuration
+
+### Environment Variables
+
+- `OPENCODE_API_KEY`: API key for LLM provider
+- `OPENCODE_MODEL`: Default model to use (e.g., gpt-4, claude-3-opus)
+- `OPENCODE_PROVIDER`: LLM provider (openai, anthropic, etc.)
+- `OPENCODE_MAX_TOKENS`: Maximum tokens for responses
+- `OPENCODE_TEMPERATURE`: Sampling temperature (0-1)
+- `OPENCODE_CONFIG`: Path to configuration file
+
+### Configuration File
+
+Create `~/.opencode/config.json`:
+
+```json
+{
+  "model": "gpt-4",
+  "provider": "openai",
+  "maxTokens": 4096,
+  "temperature": 0.7,
+  "systemPrompt": "You are a helpful coding assistant"
+}
+```
+
+### Project-Specific Config
+
+Create `.opencode.json` in your project:
+
+```json
+{
+  "include": ["src/**/*.ts", "tests/**/*.ts"],
+  "exclude": ["node_modules", "dist", "*.test.ts"],
+  "systemPrompt": "You are a TypeScript expert"
+}
+```
+
+## Advanced Usage
+
+### Code Refactoring
+
+```bash
+# Ask for refactoring suggestions
+opencode "Review and refactor src/utils.ts for better performance"
+
+# Apply refactoring automatically
+opencode "Optimize the database queries in src/db/*.ts"
+```
+
+### Bug Fixing
+
+```bash
+# Describe the bug
+opencode "Fix the race condition in the payment processing module"
+
+# OpenCode will:
+# 1. Analyze the code
+# 2. Identify the issue
+# 3. Propose and implement fixes
+# 4. Verify the solution
+```
+
+### Feature Implementation
+
+```bash
+# Request new features
+opencode "Add support for OAuth2 authentication"
+
+# Be specific about requirements
+opencode "Create a REST API with these endpoints: GET /users, POST /users, PUT /users/:id, DELETE /users/:id"
+```
+
+### Code Review
+
+```bash
+# Get code review
+opencode "Review src/api/*.ts for security vulnerabilities"
+
+# Check for best practices
+opencode "Review the entire codebase and suggest improvements following SOLID principles"
+```
+
+### Documentation Generation
+
+```bash
+# Generate documentation
+opencode "Add JSDoc comments to all functions in src/utils.ts"
+
+# Create README
+opencode "Generate a comprehensive README.md for this project"
+```
+
+## Integration with Editors
+
+### VS Code
+
+OpenCode can work alongside your editor:
+
+```bash
+# Keep VS Code running for editing
+code .
+
+# Use OpenCode for AI assistance in another terminal
+opencode
+
+# Switch between them as needed
+```
+
+### Vim/Neovim
+
+```bash
+# Use Vim/Neovim as your editor
+vim src/main.ts
+
+# Use OpenCode for complex tasks
+opencode "Refactor the authentication module"
+```
+
+## Use Cases
+
+### Learning New Codebases
+
+```bash
+# OpenCode will:
+# 1. Analyze the code structure
+# 2. Explain how components work
+# 3. Answer questions about the code
+opencode "Explain how this project handles user authentication"
+```
+
+### Porting Code
+
+```bash
+# Port from one language to another
+opencode "Port this Python function to TypeScript"
+```
+
+### Writing Tests
+
+```bash
+# Generate unit tests
+opencode "Add comprehensive unit tests for src/utils.ts with 100% coverage"
+```
+
+### Debugging
+
+```bash
+# Get help with debugging
+opencode "I'm getting a null pointer exception in src/api/users.ts. Help me debug it"
+```
+
+## Keyboard Shortcuts
+
+### Global
+
+- `Ctrl+p` - Open command palette
+- `Ctrl+c` - Open AI chat
+- `Ctrl+s` - Save current file
+- `Ctrl+q` - Quit
+- `?` - Show help
+
+### Navigation
+
+- `j` / `k` - Down / Up
+- `h` / `l` - Left / Right
+- `gg` - Go to top
+- `G` - Go to bottom
+- `/` - Search
+- `n` - Next search result
+- `N` - Previous search result
+
+### File Operations
+
+- `e` - Edit file
+- `o` - Open in external editor
+- `d` - Delete file (with confirmation)
+- `y` - Yank (copy)
+- `p` - Paste
+
+## Build Information
+
+- **Version**: 1.1.18
+- **Language**: TypeScript/JavaScript (core), Go (TUI)
+- **Runtime**: Bun
+- **License**: MIT
+- **Source**: [GitHub](https://github.com/anomalyco/opencode)
+
+## Dependencies
+
+- `bun` - JavaScript runtime and package manager
+- `fzf` - Fuzzy finder for file selection
+- `ripgrep` - Fast text search
+- `models-dev` - Model definitions and schemas
+
+## Platform Support
+
+- Linux (aarch64, x86_64)
+- macOS (aarch64, x86_64)
+
+## Notes
+
+- Includes a patch to relax Bun version check (changed to warning instead of error)
+- Shell completions are installed for supported platforms (excludes x86_64-darwin)
+- Tree-sitter WASM files are patched to use absolute store paths
+- JSON schema is generated and installed to `$out/share/opencode/schema.json`
+
+## Tips and Best Practices
+
+### Getting Started
+
+1. **Start Small**: Begin with simple tasks to get familiar with the interface
+2. **Provide Context**: Give clear, detailed descriptions of what you want
+3. **Iterate**: Work with OpenCode iteratively, refining requests as needed
+4. **Review Changes**: Always review AI-generated code before committing
+
+### Effective Prompts
+
+- Be specific about requirements
+- Provide examples of expected behavior
+- Mention constraints or preferences
+- Break complex tasks into smaller steps
+
+### Project Structure
+
+- Keep your project well-organized
+- Use consistent naming conventions
+- Add clear comments to complex logic
+- Maintain a clean git history
+
+## Related
+
+- [Adding Packages](../guides/adding-packages.md) - How to add new packages
+- [Quick Start](../QUICKSTART.md) - Getting started guide
+- [OpenCode Documentation](https://github.com/anomalyco/opencode) - Official repository and documentation

docs/packages/rofi-project-opener.md

@@ -0,0 +1,245 @@
+# rofi-project-opener
+
+A Rofi-based project directory launcher for quickly opening projects in your terminal with custom commands.
+
+## Description
+
+rofi-project-opener scans configured base directories for project subdirectories and presents them in a Rofi menu. When a project is selected, it opens a terminal, navigates to the project directory, and runs a configurable command (defaults to `opencode`).
+
+Key features:
+- JSON-based configuration for project directories
+- Per-directory custom arguments (e.g., `--agent chiron` for AI coding assistants)
+- Placeholder support (`%s` for path, `%a` for args) in custom commands
+- Works with any terminal emulator
+
+## Installation
+
+### Via Overlay
+
+```nix
+{pkgs, ...}: {
+  environment.systemPackages = with pkgs; [
+    rofi-project-opener
+  ];
+}
+```
+
+### Direct Reference
+
+```nix
+{pkgs, ...}: {
+  environment.systemPackages = with pkgs; [
+    inputs.m3ta-nixpkgs.packages.${pkgs.system}.rofi-project-opener
+  ];
+}
+```
+
+### Run Directly
+
+```bash
+nix run git+https://code.m3ta.dev/m3tam3re/nixpkgs#rofi-project-opener
+```
+
+## Usage
+
+### Basic Usage
+
+```bash
+# Launch rofi project selector
+rofi-project-opener
+```
+
+This will:
+
+1. Read project directories from `~/.config/rofi-project-opener/projects.json`
+2. Scan each directory for subdirectories (non-hidden)
+3. Display projects in Rofi for fuzzy selection
+4. Open terminal, cd to project, and run the configured command
+
+### Configuration Files
+
+The script uses two configuration files in `~/.config/rofi-project-opener/`:
+
+**projects.json** - Project directories with optional args:
+```json
+{
+  "nixpkgs": {"path": "~/p/NIX", "args": ""},
+  "chat": {"path": "~/p/CHAT", "args": "--agent chiron"},
+  "dev": {"path": "~/dev", "args": ""}
+}
+```
+
+**config** - Terminal and Rofi settings:
+```bash
+TERMINAL="/path/to/kitty"
+TERMINAL_CMD="opencode %a"
+ROFI_PROMPT="Select project"
+ROFI_ARGS="-dmenu -i"
+```
+
+### Placeholders
+
+When using `terminalCommand`, these placeholders are available:
+
+| Placeholder | Description |
+|-------------|-------------|
+| `%s` | Full path to selected project |
+| `%a` | Args from projectDirs config |
+
+**Examples:**
+```nix
+terminalCommand = "opencode %a";           # opencode with project args
+terminalCommand = "nvim";                  # just nvim, no args
+terminalCommand = "code %s";               # vscode with explicit path
+terminalCommand = "myapp --dir %s %a";     # custom app with both
+```
+
+## Home Manager Module
+
+### Enable Module
+
+```nix
+{config, pkgs, ...}: {
+  imports = [m3ta-nixpkgs.homeManagerModules.default];
+
+  cli.rofi-project-opener = {
+    enable = true;
+    projectDirs = {
+      nixpkgs = { path = "~/p/NIX"; };
+      chat = { path = "~/p/CHAT"; args = "--agent chiron"; };
+      dev = { path = "~/dev"; };
+    };
+    terminal = pkgs.kitty;
+    terminalCommand = "opencode %a";
+  };
+}
+```
+
+### Module Options
+
+#### `cli.rofi-project-opener.enable`
+
+Enable the rofi-project-opener module.
+
+- Type: `boolean`
+- Default: `false`
+
+#### `cli.rofi-project-opener.projectDirs`
+
+Attribute set of base directories to scan for projects.
+
+- Type: `attrsOf (submodule { path, args })`
+- Default: `{ dev = { path = "~/dev"; }; projects = { path = "~/projects"; }; }`
+
+Each entry supports:
+- `path` (required): Base directory path
+- `args` (optional): Arguments to pass to the command
+
+#### `cli.rofi-project-opener.terminal`
+
+Terminal emulator to use.
+
+- Type: `either str package`
+- Default: `"kitty"`
+
+#### `cli.rofi-project-opener.terminalCommand`
+
+Command to run in the terminal. Supports `%s` (path) and `%a` (args) placeholders.
+
+- Type: `str`
+- Default: `""` (runs `opencode %a`)
+
+#### `cli.rofi-project-opener.rofiPrompt`
+
+Prompt text displayed in Rofi.
+
+- Type: `str`
+- Default: `"Select project"`
+
+#### `cli.rofi-project-opener.rofiArgs`
+
+Arguments to pass to Rofi.
+
+- Type: `listOf str`
+- Default: `["-dmenu" "-i"]`
+
+## Requirements
+
+### System Requirements
+
+- Linux with Rofi installed
+- A terminal emulator (kitty, alacritty, etc.)
+- jq (included as dependency)
+
+### Runtime Dependencies
+
+These are automatically included:
+- rofi
+- jq
+- coreutils
+- gnugrep
+- gnused
+- libnotify
+
+## Platform Support
+
+- Linux (primary)
+- macOS (not tested)
+- Windows (not supported)
+
+## Build Information
+
+- **Type**: Bash script
+- **License**: MIT
+
+## Troubleshooting
+
+### No Projects Found
+
+Check that your project directories exist and contain subdirectories:
+
+```bash
+cat ~/.config/rofi-project-opener/projects.json
+ls ~/p/NIX  # Should show subdirectories
+```
+
+### Args Not Being Passed
+
+Make sure you're using `%a` placeholder in your `terminalCommand`:
+
+```nix
+# Wrong - args not passed
+terminalCommand = "opencode";
+
+# Correct - args passed via placeholder
+terminalCommand = "opencode %a";
+
+# Also correct - empty uses default behavior with args
+terminalCommand = "";
+```
+
+### Rofi Not Showing
+
+Ensure Rofi is installed and working:
+
+```bash
+echo -e "item1\nitem2" | rofi -dmenu
+```
+
+### Terminal Not Opening
+
+Check terminal configuration:
+
+```nix
+# Using package
+terminal = pkgs.kitty;
+
+# Using string (must be in PATH)
+terminal = "kitty";
+```
+
+## Related
+
+- [rofi-project-opener Module](../modules/home-manager/cli/rofi-project-opener.md) - Home Manager module documentation
+- [zellij-ps](./zellij-ps.md) - Similar project switcher for Zellij
+- [Using Modules](../guides/using-modules.md) - How to use modules

docs/packages/zellij-ps.md

@@ -78,7 +78,7 @@ Folders should be delimited by `:` and can include `~` for home directory.
 {config, ...}: {
   imports = [m3ta-nixpkgs.homeManagerModules.default];
 
-  m3ta.cli.zellij-ps = {
+  cli.zellij-ps = {
     enable = true;
   };
 }
@@ -86,14 +86,14 @@ Folders should be delimited by `:` and can include `~` for home directory.
 
 ### Module Options
 
-#### `m3ta.cli.zellij-ps.enable`
+#### `cli.zellij-ps.enable`
 
 Enable the zellij-ps module.
 
 - Type: `boolean`
 - Default: `false`
 
-#### `m3ta.cli.zellij-ps.package`
+#### `cli.zellij-ps.package`
 
 Custom package to use.
 

docs/reference/patterns.md

@@ -169,8 +169,8 @@ nix build .#your-package
   };
 
   config = mkMerge [
-    (mkIf config.m3ta.cli.tool1.enable {...})
-    (mkIf config.m3ta.cli.tool2.enable {...})
+    (mkIf config.cli.tool1.enable {...})
+    (mkIf config.cli.tool2.enable {...})
     # ... many more
   ];
 }
@@ -380,18 +380,18 @@ port-helpers   # Bad
 
 ### Module Options
 
-**Good**: `m3ta.*` namespace
+**Good**: `m3ta.*` namespace for m3ta modules, `cli.*` namespace for CLI modules
 
 ```nix
 m3ta.ports.enable = true;
-m3ta.cli.zellij-ps.enable = true;
+cli.zellij-ps.enable = true;
 ```
 
 **Bad**: Flat namespace
 
 ```nix
 ports.enable = true;  # Potential conflict
-cli.zellij-ps.enable = true;  # Hard to find
+zellij-ps.enable = true;  # Hard to find
 ```
 
 ## Performance

flake.lock

@@ -2,11 +2,11 @@
   "nodes": {
     "nixpkgs": {
       "locked": {
-        "lastModified": 1766309749,
-        "narHash": "sha256-3xY8CZ4rSnQ0NqGhMKAy5vgC+2IVK0NoVEzDoOh4DA4=",
+        "lastModified": 1768127708,
+        "narHash": "sha256-1Sm77VfZh3mU0F5OqKABNLWxOuDeHIlcFjsXeeiPazs=",
         "owner": "NixOS",
         "repo": "nixpkgs",
-        "rev": "a6531044f6d0bef691ea18d4d4ce44d0daa6e816",
+        "rev": "ffbc9f8cbaacfb331b6017d5a5abb21a492c9a38",
         "type": "github"
       },
       "original": {
@@ -16,9 +16,45 @@
         "type": "github"
       }
     },
+    "nixpkgs_2": {
+      "locked": {
+        "lastModified": 1768393167,
+        "narHash": "sha256-n2063BRjHde6DqAz2zavhOOiLUwA3qXt7jQYHyETjX8=",
+        "owner": "NixOS",
+        "repo": "nixpkgs",
+        "rev": "2f594d5af95d4fdac67fba60376ec11e482041cb",
+        "type": "github"
+      },
+      "original": {
+        "owner": "NixOS",
+        "ref": "nixpkgs-unstable",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "opencode": {
+      "inputs": {
+        "nixpkgs": "nixpkgs_2"
+      },
+      "locked": {
+        "lastModified": 1769153255,
+        "narHash": "sha256-ardM8zEJWvTvsFMQZWivjGPB2uIqFw6QPAzrRjAHQKY=",
+        "owner": "anomalyco",
+        "repo": "opencode",
+        "rev": "c130dd425a32fe1c1cd3747ea6565b0e6bf50100",
+        "type": "github"
+      },
+      "original": {
+        "owner": "anomalyco",
+        "ref": "v1.1.34",
+        "repo": "opencode",
+        "type": "github"
+      }
+    },
     "root": {
       "inputs": {
-        "nixpkgs": "nixpkgs"
+        "nixpkgs": "nixpkgs",
+        "opencode": "opencode"
       }
     }
   },

flake.nix

@@ -3,6 +3,7 @@
 
   inputs = {
     nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
+    opencode.url = "github:anomalyco/opencode/v1.1.34";
 
     # Optional: Add stable channel if needed
     # nixpkgs-stable.url = "github:NixOS/nixpkgs/nixos-24.05";
@@ -21,7 +22,7 @@
       "aarch64-darwin"
     ];
 
-    # Helper function to generate an attrset for each system
+    # Helper function to generate an attrset for each of the systems
     forAllSystems = nixpkgs.lib.genAttrs systems;
 
     # Helper to create pkgs for a given system
@@ -36,18 +37,24 @@
       system: let
         pkgs = pkgsFor system;
       in
-        import ./pkgs {inherit pkgs;}
+        import ./pkgs {inherit pkgs inputs;}
     );
 
     # Overlays - can be imported in your system configuration
     overlays = {
       # Default overlay: adds all custom packages
       default = final: prev:
-        import ./pkgs {pkgs = final;};
+        import ./pkgs {
+          pkgs = final;
+          inputs = inputs;
+        };
 
       # Individual overlays for more granular control
       additions = final: prev:
-        import ./pkgs {pkgs = final;};
+        import ./pkgs {
+          pkgs = final;
+          inputs = inputs;
+        };
 
       modifications = final: prev:
         import ./overlays/mods {inherit prev;};

modules/home-manager/cli/rofi-project-opener.nix

@@ -29,7 +29,8 @@ with lib; let
     mapAttrs (name: value: {
       path = value.path;
       args = value.args;
-    }) cfg.projectDirs
+    })
+    cfg.projectDirs
   );
 in {
   options.cli.rofi-project-opener = {
@@ -120,7 +121,11 @@ in {
     # Write shell config file for other settings
     xdg.configFile."rofi-project-opener/config".text = ''
       # rofi-project-opener configuration
-      TERMINAL="${if isDerivation cfg.terminal then "${cfg.terminal}/bin/${cfg.terminal.pname or (builtins.baseNameOf (toString cfg.terminal))}" else cfg.terminal}"
+      TERMINAL="${
+        if isDerivation cfg.terminal
+        then "${cfg.terminal}/bin/${cfg.terminal.pname or (builtins.baseNameOf (toString cfg.terminal))}"
+        else cfg.terminal
+      }"
       ${optionalString (cfg.terminalCommand != "") ''TERMINAL_CMD="${cfg.terminalCommand}"''}
       ROFI_PROMPT="${cfg.rofiPrompt}"
       ROFI_ARGS="${escapeShellArgs cfg.rofiArgs}"

modules/home-manager/cli/stt-ptt.nix

@@ -77,6 +77,56 @@ in {
       '';
       example = 5000;
     };
+
+    language = mkOption {
+      type = types.enum [
+        "auto"
+        "en"
+        "es"
+        "fr"
+        "de"
+        "it"
+        "pt"
+        "ru"
+        "zh"
+        "ja"
+        "ko"
+        "ar"
+        "hi"
+        "tr"
+        "pl"
+        "nl"
+        "sv"
+        "da"
+        "fi"
+        "no"
+        "vi"
+        "th"
+        "id"
+        "uk"
+        "cs"
+      ];
+      default = "auto";
+      description = ''
+        Language for speech recognition. Use "auto" for automatic language detection,
+        or specify a language code (ISO 639-1 standard) for better accuracy.
+
+        Auto-detection analyzes the audio to determine the spoken language automatically.
+        Specifying a language can improve accuracy if you know the language in advance.
+
+        Common language codes:
+        - en: English
+        - es: Spanish
+        - fr: French
+        - de: German
+        - zh: Chinese
+        - ja: Japanese
+        - ko: Korean
+
+        whisper.cpp supports 100+ languages. See whisper.cpp documentation for the full list.
+      '';
+      example = "en";
+    };
   };
 
   config = mkIf cfg.enable {
@@ -84,6 +134,7 @@ in {
 
     home.sessionVariables = {
       STT_MODEL = modelPath;
+      STT_LANGUAGE = cfg.language;
       STT_NOTIFY_TIMEOUT = toString cfg.notifyTimeout;
     };
 

overlays/mods/beads.nix

@@ -1,13 +1,16 @@
 {prev}:
 prev.beads.overrideAttrs (oldAttrs: rec {
-  version = "0.43.0";
+  version = "0.47.1";
 
   src = prev.fetchFromGitHub {
     owner = "steveyegge";
     repo = "beads";
     tag = "v${version}";
-    hash = "sha256-uc+3IK6CKmXx82WobEnb4Lin2EG2VLcbIJdq0H5U3Xc=";
+    hash = "sha256-DwIR/r1TJnpVd/CT1E2OTkAjU7k9/KHbcVwg5zziFVg=";
   };
 
-  vendorHash = "sha256-BpACCjVk0V5oQ5YyZRv9wC/RfHw4iikc2yrejZzD1YU=";
+  vendorHash = "sha256-pY5m5ODRgqghyELRwwxOr+xlW41gtJWLXaW53GlLaFw=";
+
+  # Tests require git worktree operations that fail in Nix sandbox
+  doCheck = false;
 })

overlays/mods/default.nix

@@ -2,9 +2,8 @@
   # Package modifications
   # This overlay contains package overrides and modifications
 
-  n8n = import ./n8n.nix {inherit prev;};
-  opencode = import ./opencode.nix {inherit prev;};
-  beads = import ./beads.nix {inherit prev;};
+  # n8n = import ./n8n.nix {inherit prev;};
+  # beads = import ./beads.nix {inherit prev;};
 
   # Add more modifications here as needed
   # example-package = prev.example-package.override { ... };

overlays/mods/n8n.nix

@@ -1,18 +1,18 @@
 {prev}:
 prev.n8n.overrideAttrs (oldAttrs: rec {
-  version = "2.1.2";
+  version = "2.4.1";
 
   src = prev.fetchFromGitHub {
     owner = "n8n-io";
     repo = "n8n";
     rev = "n8n@${version}";
-    hash = "sha256-8hwtVO09ulqsFrlM6a0o+suqSx/LAKi/2zV1B364uHU=";
+    hash = "sha256-EQP9ZI8kt30SUYE1+/UUpxQXpavzKqDu8qE24zsNifg=";
   };
 
   pnpmDeps = prev.pnpm_10.fetchDeps {
     pname = oldAttrs.pname;
     inherit version src;
     fetcherVersion = 1;
-    hash = "sha256-IJN7f6EaKprEetv9NGdcAIgFn9uwfOjL4WQopQ19D0A=";
+    hash = "sha256-Q30IuFEQD3896Hg0HCLd38YE2i8fJn74JY0o95LKJis=";
   };
 })

overlays/mods/opencode.nix

@@ -1,16 +0,0 @@
-{prev}:
-prev.opencode.overrideAttrs (oldAttrs: rec {
-  version = "1.0.223";
-
-  src = prev.fetchFromGitHub {
-    owner = "anomalyco";
-    repo = "opencode";
-    tag = "v${version}";
-    hash = "sha256-CzbWv48UySgXfNgtWdIdFBcqx8GHT4rSJNDdpn39b0c=";
-  };
-
-  node_modules = oldAttrs.node_modules.overrideAttrs (old: {
-    inherit version src;
-    outputHash = "sha256-+HEd3I11VqejTi7cikbTL5+DmNGyvUC4Cm4ysfujwes=";
-  });
-})

pkgs/beads/default.nix

@@ -0,0 +1,64 @@
+{
+  lib,
+  stdenv,
+  buildGoModule,
+  fetchFromGitHub,
+  gitMinimal,
+  installShellFiles,
+  nix-update-script,
+  versionCheckHook,
+  writableTmpDirAsHomeHook,
+}:
+buildGoModule (finalAttrs: {
+  pname = "beads";
+  version = "0.49.0";
+
+  src = fetchFromGitHub {
+    owner = "steveyegge";
+    repo = "beads";
+    tag = "v${finalAttrs.version}";
+    hash = "sha256-m0gVLeWfFeaWZpARuXgP00npmZcO7XCm7mXWA52bqTc=";
+  };
+
+  vendorHash = "sha256-YU+bRLVlWtHzJ1QPzcKJ70f+ynp8lMoIeFlm+29BNPE=";
+
+  subPackages = ["cmd/bd"];
+
+  ldflags = ["-s" "-w"];
+
+  nativeBuildInputs = [installShellFiles];
+
+  nativeCheckInputs = [gitMinimal writableTmpDirAsHomeHook];
+
+  # Skip security tests on Darwin - they check for /etc/passwd which isn't available in sandbox
+  checkFlags =
+    lib.optionals stdenv.hostPlatform.isDarwin
+    ["-skip=TestCleanupMergeArtifacts_CommandInjectionPrevention"];
+
+  preCheck = ''
+    export PATH="$out/bin:$PATH"
+  '';
+
+  postInstall = lib.optionalString (stdenv.buildPlatform.canExecute stdenv.hostPlatform) ''
+    installShellCompletion --cmd bd \
+      --bash <($out/bin/bd completion bash) \
+      --fish <($out/bin/bd completion fish) \
+      --zsh <($out/bin/bd completion zsh)
+  '';
+
+  nativeInstallCheckInputs = [versionCheckHook writableTmpDirAsHomeHook];
+  versionCheckProgramArg = "version";
+  doInstallCheck = true;
+
+  doCheck = false;
+
+  passthru.updateScript = nix-update-script {};
+
+  meta = {
+    description = "Lightweight memory system for AI coding agents with graph-based issue tracking";
+    homepage = "https://github.com/steveyegge/beads";
+    license = lib.licenses.mit;
+    maintainers = with lib.maintainers; [kedry];
+    mainProgram = "bd";
+  };
+})

pkgs/code2prompt/default.nix

@@ -1,6 +1,7 @@
 {
   lib,
   fetchFromGitHub,
+  nix-update-script,
   rustPlatform,
   pkg-config,
   perl,
@@ -8,13 +9,13 @@
 }:
 rustPlatform.buildRustPackage rec {
   pname = "code2prompt";
-  version = "4.0.2";
+  version = "4.2.0";
 
   src = fetchFromGitHub {
     owner = "mufeedvh";
     repo = "code2prompt";
     rev = "v${version}";
-    hash = "sha256-2ac/ZobL+4cQz94JjtS+JC7qsPE5lktznlhMAgSJa8g=";
+    hash = "sha256-Gh8SsSTZW7QlyyC3SWJ5pOK2x85/GT7+LPJn2Jeczpc=";
   };
 
   cargoLock = {
@@ -27,6 +28,8 @@ rustPlatform.buildRustPackage rec {
 
   buildInputs = [openssl];
 
+  passthru.updateScript = nix-update-script {};
+
   meta = with lib; {
     description = "A CLI tool that converts your codebase into a single LLM prompt with a source tree, prompt templating, and token counting";
     homepage = "https://github.com/mufeedvh/code2prompt";

pkgs/default.nix

@@ -1,14 +1,20 @@
-{pkgs, ...}: {
+{ pkgs, inputs ? null, ... }: {
   # Custom packages registry
   # Each package is defined in its own directory under pkgs/
+  beads = pkgs.callPackage ./beads { };
   code2prompt = pkgs.callPackage ./code2prompt { };
   hyprpaper-random = pkgs.callPackage ./hyprpaper-random { };
   launch-webapp = pkgs.callPackage ./launch-webapp { };
   mem0 = pkgs.callPackage ./mem0 { };
   msty-studio = pkgs.callPackage ./msty-studio { };
+  n8n = pkgs.callPackage ./n8n { };
   pomodoro-timer = pkgs.callPackage ./pomodoro-timer { };
   rofi-project-opener = pkgs.callPackage ./rofi-project-opener { };
   stt-ptt = pkgs.callPackage ./stt-ptt { };
   tuxedo-backlight = pkgs.callPackage ./tuxedo-backlight { };
   zellij-ps = pkgs.callPackage ./zellij-ps { };
+
+  # Imported from flake inputs
+  opencode = inputs.opencode.packages.${pkgs.system}.opencode;
+  opencode-desktop = pkgs.callPackage ./opencode-desktop { inherit inputs; };
 }

pkgs/mem0/default.nix

@@ -1,18 +1,19 @@
 {
   lib,
+  nix-update-script,
   python3,
   fetchFromGitHub,
 }:
 python3.pkgs.buildPythonPackage rec {
   pname = "mem0ai";
-  version = "1.0.0";
+  version = "1.0.2";
   pyproject = true;
 
   src = fetchFromGitHub {
     owner = "mem0ai";
     repo = "mem0";
     rev = "v${version}";
-    hash = "sha256-DluzIhwL/GanqtRSMW7ax+OVc2kZjbwQ0lpPCQFnD58=";
+    hash = "sha256-wvIPmqYlpto+ggifdSOjveEmSneKeZcoltItusYSu4Q=";
   };
 
   # Relax Python dependency version constraints
@@ -80,6 +81,8 @@ python3.pkgs.buildPythonPackage rec {
     install -Dm755 ${./server.py} $out/bin/mem0-server
   '';
 
+  passthru.updateScript = nix-update-script {};
+
   meta = with lib; {
     description = "Long-term memory layer for AI agents with REST API support";
     longDescription = ''

pkgs/n8n/default.nix

@@ -0,0 +1,114 @@
+{
+  stdenv,
+  lib,
+  nixosTests,
+  fetchFromGitHub,
+  nodejs,
+  pnpm_10,
+  fetchPnpmDeps,
+  pnpmConfigHook,
+  python3,
+  node-gyp,
+  cctools,
+  xcbuild,
+  libkrb5,
+  libmongocrypt,
+  libpq,
+  makeWrapper,
+}:
+stdenv.mkDerivation (finalAttrs: {
+  pname = "n8n";
+  version = "n8n@2.4.6";
+
+  src = fetchFromGitHub {
+    owner = "n8n-io";
+    repo = "n8n";
+    tag = finalAttrs.version;
+    hash = "sha256-9oJvi/Q2VwG2sVuWQXCBrAPVV03d89//78bOFN0IwLU=";
+  };
+
+  pnpmDeps = fetchPnpmDeps {
+    inherit (finalAttrs) pname version src;
+    pnpm = pnpm_10;
+    fetcherVersion = 3;
+    hash = "sha256-QtusZm9WaLMjfopsX4t2WiiU++j3V/PQHbelKubhMII=";
+  };
+
+  nativeBuildInputs =
+    [
+      pnpmConfigHook
+      pnpm_10
+      python3 # required to build sqlite3 bindings
+      node-gyp # required to build sqlite3 bindings
+      makeWrapper
+    ]
+    ++ lib.optional stdenv.hostPlatform.isDarwin [cctools xcbuild];
+
+  buildInputs = [nodejs libkrb5 libmongocrypt libpq];
+
+  buildPhase = ''
+    runHook preBuild
+
+    pushd node_modules/sqlite3
+    node-gyp rebuild
+    popd
+
+    # TODO: use deploy after resolved https://github.com/pnpm/pnpm/issues/5315
+    pnpm build --filter=n8n
+
+    runHook postBuild
+  '';
+
+  preInstall = ''
+    echo "Removing non-deterministic and unnecessary files"
+
+    find -type d -name .turbo -exec rm -rf {} +
+    rm node_modules/.modules.yaml
+    rm packages/nodes-base/dist/types/nodes.json
+
+    CI=true pnpm --ignore-scripts prune --prod
+    find -type f \( -name "*.ts" -o -name "*.map" \) -exec rm -rf {} +
+    rm -rf node_modules/.pnpm/{typescript*,prettier*}
+    shopt -s globstar
+    # https://github.com/pnpm/pnpm/issues/3645
+    find node_modules packages/**/node_modules -xtype l -delete
+
+    echo "Removed non-deterministic and unnecessary files"
+  '';
+
+  installPhase = ''
+    runHook preInstall
+
+    mkdir -p $out/{bin,lib/n8n}
+    mv {packages,node_modules} $out/lib/n8n
+
+    makeWrapper $out/lib/n8n/packages/cli/bin/n8n $out/bin/n8n \
+      --set N8N_RELEASE_TYPE "stable"
+
+    runHook postInstall
+  '';
+
+  passthru = {
+    tests = nixosTests.n8n;
+    updateScript = ./update.sh;
+  };
+
+  # this package has ~80000 files, these take too long and seem to be unnecessary
+  dontStrip = true;
+  dontPatchELF = true;
+  dontRewriteSymlinks = true;
+
+  meta = {
+    description = "Free and source-available fair-code licensed workflow automation tool";
+    longDescription = ''
+      Free and source-available fair-code licensed workflow automation tool.
+      Easily automate tasks across different services.
+    '';
+    homepage = "https://n8n.io";
+    changelog = "https://github.com/n8n-io/n8n/releases/tag/n8n@${finalAttrs.version}";
+    maintainers = with lib.maintainers; [gepbird AdrienLemaire sweenu];
+    license = lib.licenses.sustainableUse;
+    mainProgram = "n8n";
+    platforms = lib.platforms.unix;
+  };
+})

pkgs/n8n/update.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env nix-shell
+#!nix-shell --pure -i bash -p bash curl jq nix-update cacert git
+set -euo pipefail
+
+new_version="$(curl -s "https://api.github.com/repos/n8n-io/n8n/releases/latest" | jq --raw-output '.tag_name | ltrimstr("n8n@")')"
+nix-update n8n --version "$new_version"

pkgs/opencode-desktop/default.nix

@@ -0,0 +1,23 @@
+{ lib, stdenv, symlinkJoin, makeWrapper, inputs ? null, }:
+let
+  opencode-desktop =
+    inputs.opencode.packages.${stdenv.hostPlatform.system}.desktop;
+in symlinkJoin {
+  name = "opencode-desktop";
+  paths = [ opencode-desktop ];
+
+  nativeBuildInputs = [ makeWrapper ];
+
+  postBuild = ''
+    wrapProgram $out/bin/opencode-desktop \
+      --run 'if [[ "$NIXOS_OZONE_WL" == "1" ]]; then export OC_ALLOW_WAYLAND=1; fi'
+  '';
+
+  meta = {
+    description = "OpenCode Desktop App with Wayland support";
+    homepage = "https://opencode.ai";
+    license = lib.licenses.mit;
+    platforms = lib.platforms.linux;
+    mainProgram = "opencode-desktop";
+  };
+}

pkgs/stt-ptt/default.nix

@@ -19,6 +19,7 @@
 
     # Configurable via environment
     STT_MODEL="''${STT_MODEL:-$MODEL_DIR/ggml-large-v3-turbo.bin}"
+    STT_LANGUAGE="''${STT_LANGUAGE:-auto}"
     STT_NOTIFY_TIMEOUT="''${STT_NOTIFY_TIMEOUT:-3000}"
 
     NOTIFY="${libnotify}/bin/notify-send"
@@ -52,7 +53,7 @@
                     "$RM" -f "$AUDIO"
                     exit 1
                 fi
-                text=$("$WHISPER" -m "$STT_MODEL" -f "$AUDIO" -np -nt 2>/dev/null | "$TR" -d '\n' | "$SED" 's/^[[:space:]]*//;s/[[:space:]]*$//')
+                text=$("$WHISPER" -m "$STT_MODEL" -f "$AUDIO" -l "$STT_LANGUAGE" -np -nt 2>/dev/null | "$TR" -d '\n' | "$SED" 's/^[[:space:]]*//;s/[[:space:]]*$//')
                 "$RM" -f "$AUDIO"
                 [[ -n "$text" ]] && "$WTYPE" -- "$text"
             fi
@@ -62,6 +63,7 @@
             echo ""
             echo "Environment variables:"
             echo "  STT_MODEL          - Path to whisper model (default: \$XDG_DATA_HOME/stt-ptt/models/ggml-large-v3-turbo.bin)"
+            echo "  STT_LANGUAGE       - Language code or 'auto' for auto-detection (default: auto)"
             echo "  STT_NOTIFY_TIMEOUT - Notification timeout in ms (default: 3000)"
             exit 1
             ;;