provision/hosts/bulwark/configuration.nix

@@ -63,9 +63,11 @@
     }];
   }];
 
+  # List packages installed in system profile.
   environment.systemPackages = with pkgs; [
-      discord # Voice, video, and text communication platform for communities and friends.
+      # One-off packages
-      gamemode # Optimizes Linux system performance for gaming by adjusting system settings.
+      discord
+      gamemode
   ];
 
   # Enable modules

provision/hosts/bulwark/steam-deck.nix

@@ -25,8 +25,8 @@
   hardware.pulseaudio.enable = lib.mkForce false;
 
   environment.systemPackages = with pkgs; [
-    jupiter-dock-updater-bin # Binary package for updating firmware on Jupiter Dock, a hardware accessory for certain laptops.
+    jupiter-dock-updater-bin
-    steamdeck-firmware # Firmware package for Valve's Steam Deck, a handheld gaming device.
+    steamdeck-firmware
   ];
 
   # GNOME settings through home

provision/hosts/bulwark/syncthing.nix

@@ -3,9 +3,7 @@
   networking.firewall.allowedTCPPorts = [ 8384 22000 ];
   networking.firewall.allowedUDPPorts = [ 22000 21027 ];
 
-  environment.systemPackages = with pkgs; [ 
+  environment.systemPackages = with pkgs; [ syncthing ];
-    syncthing # File sync program for multiple devices in real-time.
-  ];
 
   services.syncthing = {
     enable = true;

provision/hosts/kestrel/configuration.nix

@@ -69,8 +69,10 @@
     }];
   }];
   
+  # List packages installed in system profile.
   environment.systemPackages = with pkgs; [
-      distrobox # Platform for creating and managing Linux distribution images.
+      # One-off stable packages
+      distrobox
   ];
 
   # Enable modules

provision/hosts/kestrel/syncthing.nix

@@ -3,9 +3,7 @@
   networking.firewall.allowedTCPPorts = [ 8384 22000 ];
   networking.firewall.allowedUDPPorts = [ 22000 21027 ];
 
-  environment.systemPackages = with pkgs; [ 
+  environment.systemPackages = with pkgs; [ syncthing ];
-    syncthing # File sync program for multiple devices in real-time.
-  ];
 
   services.syncthing = {
     enable = true;

provision/hosts/manofwar/configuration.nix

@@ -56,8 +56,10 @@
     extraGroups = [ "dialout" "wheel" ]; # Enable ‘sudo’ for the user.
   };
   
+  # List packages installed in system profile.
   environment.systemPackages = with pkgs; [
-    libraspberrypi # Library providing access to Raspberry Pi hardware features and interfaces.
+      # One-off packages
+      libraspberrypi
   ];
 
   # Enable modules

provision/hosts/shivan/configuration.nix

@@ -69,8 +69,10 @@
     }];
   }];
   
+  # List packages installed in system profile.
   environment.systemPackages = with pkgs; [
-    distrobox # Platform for creating and managing Linux distribution images.
+      # One-off packages
+      distrobox
   ]; 
 
   # Enable modules

provision/hosts/shivan/syncthing.nix

@@ -3,9 +3,7 @@
   networking.firewall.allowedTCPPorts = [ 8384 22000 ];
   networking.firewall.allowedUDPPorts = [ 22000 21027 ];
 
-  environment.systemPackages = with pkgs; [ 
+  environment.systemPackages = with pkgs; [ syncthing ];
-    syncthing # File sync program for multiple devices in real-time.
-  ];
 
   services.syncthing = {
     enable = true;

provision/hosts/torus/configuration.nix

@@ -73,11 +73,13 @@
     shell = pkgs.bash;
   };
 
+  # List packages installed in system profile. To search, run:
+  # $ nix search wget
   environment.systemPackages = with pkgs; [
-    docker-compose # Tool for defining and running multi-container Docker applications.
+    docker-compose
-    python3 # Interpreted, high-level programming language known for its simplicity and versatility.
+    python3
-    zk # Command-line tool for interacting with Apache ZooKeeper, a centralized service for distributed systems.
+    zk
-    gollum # Wiki software that provides a simple, Git-based wiki engine.
+    gollum
   ];
 
   # Enable the OpenSSH daemon.

provision/hosts/torus/samba-server.nix

@@ -37,7 +37,5 @@
   networking.firewall.allowedUDPPorts = [ 137 138 ];
 
   # To make SMB mounting easier on the command line
-  environment.systemPackages = with pkgs; [ 
+  environment.systemPackages = with pkgs; [ cifs-utils ];
-    cifs-utils # Utilities for mounting and managing CIFS (Common Internet File System) shares.
-  ];
 }

provision/hosts/torus/share.nix

@@ -3,9 +3,7 @@
   networking.firewall.allowedTCPPorts = [ 5001 ];
   networking.firewall.allowedUDPPorts = [ 5001 ];
 
-  environment.systemPackages = with pkgs; [ 
+  environment.systemPackages = with pkgs; [ dufs ];
-    dufs # Distinctive utility file server
-  ];
 
   systemd.services.share = {
     description = "Start dufs for quick sharing of files";

provision/hosts/torus/syncthing.nix

@@ -3,9 +3,7 @@
   networking.firewall.allowedTCPPorts = [ 8384 22000 ];
   networking.firewall.allowedUDPPorts = [ 22000 21027 ];
 
-  environment.systemPackages = with pkgs; [ 
+  environment.systemPackages = with pkgs; [ syncthing ];
-    syncthing # File sync program for multiple devices in real-time.
-  ];
 
   services.syncthing = {
     enable = true;

provision/modules/desktop/browser.nix

@@ -6,8 +6,8 @@ in {
   options.modules.desktop.browser.enable = lib.mkEnableOption "browser";
   config = lib.mkIf cfg.enable {
     environment.systemPackages = with pkgs; [
-      google-chrome # Web browser developed by Google.
+      google-chrome
-      play-with-mpv # Script for playing media files with MPV media player in a simple and efficient manner.
+      play-with-mpv
     ];
     programs.chromium = {
       enable = true;

provision/modules/desktop/default.nix

@@ -3,18 +3,17 @@
   imports = [ ./keyd.nix ./browser.nix ./gnome.nix ./sway.nix ];
 
   environment.systemPackages = with pkgs; [
-    bc # Arbitrary-precision arithmetic language.
+    bc
-    fzf # Command-line fuzzy finder for Unix-like operating systems.
+    fzf
-    gamemode # Optimizes system performance for gaming by adjusting system settings.
+    gamemode
-    discord # Voice, video, and text communication platform for communities and friends.
+    discord
-    inkscape # Vector graphics editor for creating illustrations, icons, logos, diagrams, and more.
+    inkscape
-    libreoffice-fresh # Office suite compatible with Microsoft Office.
+    libreoffice-fresh
-    xournal # Note-taking and sketching application.
+    xournal
-    mpv # Media player for playing audio and video files.
+    mpv
-    p7zip # Command-line file archiver with high compression ratio.
+    p7zip
-    borgbackup # Deduplicating backup program with optional compression and authenticated encryption.
+    borgbackup
-    gimp # GNU Image Manipulation Program for editing and composing raster images.
+    gimp
-    wl-clipboard # Command-line utility to access and manipulate clipboard content in a Wayland session.
   ];
 
   # xdg-desktop-portal settings

provision/modules/desktop/gnome.nix

@@ -27,31 +27,34 @@ in {
 
   config = lib.mkIf cfg.enable {
     environment.systemPackages = with pkgs; [
-      gnome.dconf-editor # Graphical tool for editing settings stored in the dconf database of GNOME.
+      gnome.dconf-editor
-      gnome.gnome-tweaks # Utility for customizing various aspects of the GNOME desktop environment.
+      gnome.gnome-tweaks
-      gnomeExtensions.focus-changer # GNOME Shell extension for changing window focus behavior.
+      gnomeExtensions.focus-changer
-      evolution # Personal information management application that provides email, calendar, and contact management features.
+      evolution
-      #gnomeExtensions.fullscreen-avoider # TODO: Add back when fixed upstream
+      # TODO: Add back when fixed upstream
+      #gnomeExtensions.fullscreen-avoider
     ];
 
     environment.gnome.excludePackages = with pkgs.gnome; [
-      baobab # Disk usage analyzer for the GNOME desktop environment.
+      baobab          # disk usage analyzer
-      cheese # Webcam application for taking photos and videos.
+      cheese          # photo booth
-      epiphany # Web browser for the GNOME desktop environment.
+      epiphany        # web browser
-      pkgs.gedit # Text editor for the GNOME desktop environment.
+      pkgs.gedit      # text editor
-      simple-scan # Simple scanning utility for scanning documents and images.
+      simple-scan     # document scanner
-      totem # Movie player for the GNOME desktop environment.
+      totem           # video player
-      yelp # Help viewer application for the GNOME desktop environment.
+      yelp            # help viewer
-      evince # Document viewer for the GNOME desktop environment.
+      evince          # document viewer
-      geary # Email client for the GNOME desktop environment.
+      geary           # email client
-      seahorse # GNOME application for managing encryption keys and passwords.
+      seahorse        # password manager
-      pkgs.gnome-tour # Guided tour application for introducing users to GNOME desktop environment features.
+      pkgs.gnome-tour # tour app
-      pkgs.snapshot # Utility for taking and managing system snapshots in the GNOME desktop environment.
+      pkgs.snapshot   # camera application
-      pkgs.gnome-connections # GNOME application for accessing remote machines and services.
+
-      gnome-font-viewer # Utility for previewing and managing fonts in the GNOME desktop environment.
+      # these should be self explanatory
-      gnome-logs # Log viewer application for GNOME.
+      pkgs.gnome-connections
-      gnome-maps # Map application for the GNOME desktop environment.
+      gnome-font-viewer 
-      gnome-music # Music player and management application for GNOME.
+      gnome-logs 
+      gnome-maps 
+      gnome-music 
     ];
 
     # Enable wayland gnome

provision/modules/desktop/sway.nix

@@ -28,33 +28,34 @@ in {
   config = lib.mkIf cfg.enable {
 
     environment.systemPackages = with pkgs; [
-      sway # Tiling Wayland compositor and a drop-in replacement for the i3 window manager for X11.
+      sway
-      swayidle # Idle manager for Wayland, executing actions when the system is idle.
+      swayidle
-      swaybg # Wallpaper utility for Wayland, setting the background image.
+      swaybg
-      sway-scratchpad # Helper tool for managing scratchpad windows in the Sway window manager.
+      sway-scratchpad
-      grim # Screenshot utility for Wayland.
+      grim # screenshot functionality
-      mako # Lightweight notification daemon for Wayland.
+      wl-clipboard # wl-copy and wl-paste for copy/paste from stdin / stdout
-      libnotify # Library for sending desktop notifications.
+      mako # notification system developed by swaywm maintainer
-      wdisplays # Utility for managing displays in a Wayland session.
+      libnotify
-      playerctl # Command-line utility for controlling media players.
+      wdisplays # tool to configure displays
-      wayland # Protocol for a compositor to talk to its clients as well as a C library implementation of that protocol.
+      playerctl
-      xwayland # X server running as a Wayland client.
+      wayland
-      configure-gtk # GTK-based utility for configuring various aspects of the desktop environment.
+      xwayland
-      xdg-utils # Collection of tools for managing desktop environments based on the XDG specifications.
+      configure-gtk
-      glib # Library providing various core functions for the GNOME project.
+      xdg-utils # for opening default programs when clicking links
-      dracula-theme # Dark theme for various applications and environments.
+      glib # gsettings
-      gnome3.adwaita-icon-theme # Default icon theme for GNOME.
+      dracula-theme # gtk theme
-      networkmanagerapplet # GNOME applet for NetworkManager.
+      gnome3.adwaita-icon-theme  # default gnome cursors
-      pcmanfm # Lightweight file manager for X11.
+      networkmanagerapplet
-      udiskie # Removable disk automounter for udisks.
+      pcmanfm
-      pavucontrol # GTK-based volume control utility for PulseAudio.
+      udiskie
-      waybar # Highly customizable Wayland bar for Sway and Wlroots-based compositors.
+      pavucontrol
+      waybar
       (pkgs.waybar.overrideAttrs (oldAttrs: {
          mesonFlags = oldAttrs.mesonFlags ++ [ "-Dexperimental=true" ];
          })
       )
     ] ++ [
-      inputs.hyprland-contrib.packages.${pkgs.system}.grimblast # Hyprland version of Grimshot
+      inputs.hyprland-contrib.packages.${pkgs.system}.grimblast
     ];
 
     xdg = {

provision/modules/devel/engineering.nix

@@ -9,10 +9,10 @@ in {
   config = lib.mkIf cfg.enable {
 
     environment.systemPackages = with pkgs; [ 
-      super-slicer # 3D printing slicing software with advanced features and customization options.
+      super-slicer 
-      prusa-slicer # Slicing software optimized for Prusa 3D printers, offering user-friendly interface and settings.
+      prusa-slicer
-      freecad # Open-source parametric 3D CAD modeler.
+      freecad
-      blender # Open-source 3D creation suite for modeling, animation, rendering, and more.
+      blender 
     ];
   };
 }

provision/modules/devel/notes.nix

@@ -6,12 +6,13 @@ in {
   options.modules.devel.notes.enable = lib.mkEnableOption "notes";
   config = lib.mkIf cfg.enable {
     environment.systemPackages = with pkgs; [
-      pandoc # Universal document converter.
+      pandoc
-      gollum # Wiki software that provides a simple, Git-based wiki engine.
+      gollum
-      obsidian # Note-taking and knowledge management application.
+      obsidian
-      zk # Command-line tool for interacting with Apache ZooKeeper, a centralized service for distributed systems.
+      zk
-      bat # Cat clone with syntax highlighting and Git integration.
+      # for zk
-      fzf # Command-line fuzzy finder for Unix-like operating systems.
+        bat
+        fzf
     ];
   };
 }

provision/modules/devel/python.nix

@@ -5,10 +5,10 @@
 let
   cfg = config.modules.devel.python;
   my-python-packages = ps: with ps; [
-    virtualenv # Tool for creating isolated Python environments.
+    virtualenv
-    i3ipc # Python library for controlling i3 window manager via its IPC interface.
+    i3ipc
-    ipython # Interactive computing environment for Python.
+    ipython
-    pip # Package installer for Python.
+    pip
   ];
   
 in {
@@ -17,9 +17,9 @@ in {
 
     environment.systemPackages = with pkgs; [ 
       (python3.withPackages my-python-packages)
-      fava # Web interface for the double-entry bookkeeping software Beancount.
+      fava 
-      beancount # Double-entry bookkeeping software for tracking financial transactions.
+      beancount
-      nodePackages_latest.pyright # Latest version of the Pyright package, a static type checker for Python.
+      nodePackages_latest.pyright
     ];
   };
 }

provision/modules/devel/tooling.nix

@@ -9,11 +9,11 @@ in {
   config = lib.mkIf cfg.enable {
 
     environment.systemPackages = with pkgs; [
-      cmake # Cross-platform build system generator.
+      cmake
-      gcc # GNU Compiler Collection, a compiler system for programming languages.
+      gcc
-      coreutils # Collection of basic file, shell, and text manipulation utilities.
+      coreutils
-      gnumake # GNU Make, a build automation tool.
+      gnumake
-      go # Programming language developed by Google, known for its simplicity and efficiency.
+      go
     ];
   };
 }

provision/modules/gaming/emulation.nix

@@ -6,17 +6,17 @@ in {
   config = lib.mkIf cfg.enable {
 
     environment.systemPackages = with pkgs; [ 
-      yuzu-archive # Nintendo Switch emulator.
+      yuzu-archive
-      citra-archive # Nintendo 3DS emulator.
+      citra-archive
-      dolphin-emu # GameCube and Wii emulator.
+      dolphin-emu
-      ppsspp # PSP emulator.
+      ppsspp
-      mgba # Game Boy Advance emulator.
+      mgba
       (retroarch.override {
         cores = with libretro; [
-          nestopia # Nintendo Entertainment System (NES) emulator.
+          nestopia
-          snes9x # Super Nintendo Entertainment System (SNES) emulator.
+          snes9x
-          mgba # Game Boy Advance emulator.
+          mgba
-          melonds # Nintendo DS emulator.
+          melonds
         ];
       })
     ];

provision/modules/gaming/misc.nix

@@ -6,10 +6,10 @@ in {
   config = lib.mkIf cfg.enable {
 
     environment.systemPackages = with pkgs; [ 
-      sunshine # Utility for streaming Android device display to a computer.
+      sunshine
-      moonlight-qt # Qt-based client for NVIDIA GameStream, allowing streaming of PC games to other devices.
+      moonlight-qt
-      prismlauncher # Launcher for Prism, a web application framework.
+      prismlauncher
-      jdk17 # Java Development Kit (JDK) version 17.
+      jdk17
     ];
   };
 }

provision/modules/gaming/steam.nix

@@ -15,9 +15,9 @@ in {
     hardware.steam-hardware.enable = true;
 
     environment.systemPackages = with pkgs; [ 
-      steam # Digital distribution platform for purchasing and playing video games.
+      steam
-      steamtinkerlaunch # Launcher and optimization tool for Steam games.
+      steamtinkerlaunch
-      gamescope # Utility for running games using Valve's Steam Play compatibility layer with improved performance and compatibility.
+      gamescope
     ];
   };
 }

provision/modules/services/peripherals.nix

@@ -9,8 +9,8 @@ in {
     hardware.openrazer.users = ["tstarr"];
 
     environment.systemPackages = with pkgs; [
-      polychromatic # Graphical utility for configuring RGB lighting effects on Razer peripherals.
+        polychromatic
-      pulseaudio # Sound server for Linux and other Unix-like operating systems.
+        pulseaudio
     ];
 
     # rtkit is optional but recommended

provision/modules/services/samba-client.nix

@@ -10,8 +10,6 @@ in {
     networking.firewall.allowedUDPPorts = [ 137 138 ];
 
     # To make SMB mounting easier on the command line
-    environment.systemPackages = with pkgs; [ 
+    environment.systemPackages = with pkgs; [ cifs-utils ];
-      cifs-utils # Utilities for mounting and managing CIFS (Common Internet File System) shares.
-    ];
   };
 }

provision/modules/services/virt-manager.nix

@@ -6,8 +6,6 @@ in {
   config = lib.mkIf cfg.enable {
     virtualisation.libvirtd.enable = true;
     programs.dconf.enable = true;
-    environment.systemPackages = with pkgs; [ 
+    environment.systemPackages = with pkgs; [ virt-manager ];
-      virt-manager # Desktop application for managing virtual machines through libvirt.
-    ];
   };
 }

provision/modules/system/terminal.nix

@@ -6,38 +6,48 @@ in {
   config = lib.mkIf cfg.enable {
 
     environment.systemPackages = with pkgs; [
-      git # Version control system for tracking changes in source code during software development.
+      git
-      git-annex # Manages files with git, without checking the file contents into git.
+      git-annex
-      lazygit # Terminal-based GUI for git, making it easier to use and visualize git repositories.
+      lazygit
-      killall # Command-line utility to terminate processes by name.
+      killall
-      pciutils # Utilities for inspecting and manipulating devices connected to the PCI bus.
+      pciutils
-      chezmoi # Manages your dotfiles across multiple machines, ensuring consistency and version control.
+      chezmoi
-      nix-init # Command-line utility for initializing and managing NixOS system configurations.
+      nix-init
-      btop # Terminal-based resource monitor, providing an interactive view of system resources.
+      btop
-      cookcli # Command-line tool for managing Cook, a job scheduling system.
+      cookcli
-      nix-search-cli # Command-line utility for searching the Nix package repository.
+
-      rbw # Command-line interface to the Bitwarden password manager.
+      rbw 
-      pinentry-curses # Simple curses-based passphrase entry dialog for GnuPG.
+      # for rbw
-      bash # GNU Bourne-Again SHell, a command language interpreter for Unix-like operating systems.
+        pinentry-curses 
-      bash-completion # Provides programmable completion for the bash shell.
+
-      tmux # Terminal multiplexer, allowing multiple terminal sessions within a single window.
+      bash
-      tmuxp # Manages tmux sessions through simple, declarative configuration files.
+      # for bash
-      thefuck # Corrects errors in previous console commands.
+        bash-completion
-      nnn # Terminal file manager with a focus on performance and ease of use.
+        tmux
-      advcpmv # Advanced version of the Unix utilities cp and mv.
+        tmuxp
-      unzip # Command-line utility for extracting files from ZIP archives.
+        thefuck
-      trash-cli # Command-line interface to the freedesktop.org Trash.
+
-      catimg # Display images in the terminal using ASCII characters.
+      nnn
-      vim # Text editor that is highly configurable and widely used, especially in the Unix environment.
+      # for nnn
-      neovim # Fork of Vim aiming to improve extensibility and usability.
+        advcpmv
-      nodejs # JavaScript runtime built on Chrome's V8 JavaScript engine.
+        unzip
-      ripgrep # Line-oriented search tool that recursively searches directories for a regex pattern.
+        trash-cli
-      cargo # Package manager and build system for Rust.
+        catimg
-      taskwarrior # Command-line task management tool.
+
-      taskopen # Open Taskwarrior tasks in a text editor.
+      vim
-      taskwarrior-tui # Interactive terminal user interface for Taskwarrior.
+      neovim
-      timewarrior # Command-line time tracking utility.
+      # for neovim
-      ollama # Command-line tool for viewing and managing Open Location Codes.
+        nodejs 
+        ripgrep
+        cargo
+
+      taskwarrior
+      # for taskwarrior
+        taskopen
+        taskwarrior-tui
+        timewarrior
+      ollama
     ];
+
   };
 }

provision/modules/system/wireguard-client.nix

@@ -18,9 +18,7 @@ in {
   config = lib.mkIf cfg.enable {
     # Create qr code for phones with:
     # qrencode -t ansiutf8 < myfile_here
-    environment.systemPackages = with pkgs; [ 
+    environment.systemPackages = with pkgs; [ qrencode ];
-      qrencode # Command-line utility for generating QR codes from text or data.
-    ];
     networking.firewall = {
       allowedUDPPorts = [ 51820 ];
     };