From 59b820146763424db380b4f5ed82ccaf0fae923b Mon Sep 17 00:00:00 2001
From: Arpit Chakladar <arpitchakladar+git@gmail.com>
Date: Fri, 17 Jul 2026 23:50:41 +0530
Subject: refactor: standardize file-level comments, drop unused pkgs, and
 theme lazygit with base16

- Move inline comments to top of file across all modules for consistent
style
- Add descriptive comments to files missing them (aggregators,
assertions, scripts, flake)
- Remove unused `pkgs` parameter from i3/keybindings.nix and
zathura/default.nix
- Drop explicit `package = pkgs.zathura` (home-manager provides the
default)
- Delete stale meli-sync.sh (migrated to neomutt)
- Remove extraneous blank lines for consistent formatting
- Theme lazygit with config.scheme base16 colors instead of hardcoded
names
---
 modules/scripts/aria2-run.sh          | 1 +
 modules/scripts/default.nix           | 1 +
 modules/scripts/file-preview-clean.sh | 1 +
 modules/scripts/fzf-launcher.sh       | 1 +
 modules/scripts/meli-sync.sh          | 5 -----
 modules/scripts/neomutt-sync.sh       | 1 +
 modules/scripts/vpn-connect.sh        | 1 +
 modules/scripts/vpn-disconnect.sh     | 1 +
 8 files changed, 7 insertions(+), 5 deletions(-)
 delete mode 100644 modules/scripts/meli-sync.sh

(limited to 'modules/scripts')

diff --git a/modules/scripts/aria2-run.sh b/modules/scripts/aria2-run.sh
index 167fc5d..e151b53 100644
--- a/modules/scripts/aria2-run.sh
+++ b/modules/scripts/aria2-run.sh
@@ -1 +1,2 @@
+# Start aria2 RPC daemon
 aria2c --enable-rpc --rpc-listen-all=false --rpc-listen-port=6800
diff --git a/modules/scripts/default.nix b/modules/scripts/default.nix
index 8ad27a3..ffde799 100644
--- a/modules/scripts/default.nix
+++ b/modules/scripts/default.nix
@@ -1,3 +1,4 @@
+# Scripts - Generates wrapped scripts with environment variables and dependencies
 {
   config,
   lib,
diff --git a/modules/scripts/file-preview-clean.sh b/modules/scripts/file-preview-clean.sh
index ee8ca73..006f63c 100644
--- a/modules/scripts/file-preview-clean.sh
+++ b/modules/scripts/file-preview-clean.sh
@@ -1 +1,2 @@
+# Clear kitty icat preview after lf exits
 exec kitten icat --clear --stdin no --transfer-mode file </dev/null >/dev/tty
diff --git a/modules/scripts/fzf-launcher.sh b/modules/scripts/fzf-launcher.sh
index edc39ab..1d7f968 100644
--- a/modules/scripts/fzf-launcher.sh
+++ b/modules/scripts/fzf-launcher.sh
@@ -1,3 +1,4 @@
+# Fzf-launcher - FZF-based application launcher (scans .desktop files)
 DIRS=(
   /run/current-system/sw/share/applications
   "$HOME/.nix-profile/share/applications"
diff --git a/modules/scripts/meli-sync.sh b/modules/scripts/meli-sync.sh
deleted file mode 100644
index 2024562..0000000
--- a/modules/scripts/meli-sync.sh
+++ /dev/null
@@ -1,5 +0,0 @@
-#!/usr/bin/env sh
-
-# Sync all accounts and immediately tag with notmuch
-mbsync -a
-notmuch new 2>/dev/null
\ No newline at end of file
diff --git a/modules/scripts/neomutt-sync.sh b/modules/scripts/neomutt-sync.sh
index a28152c..1adbc7f 100644
--- a/modules/scripts/neomutt-sync.sh
+++ b/modules/scripts/neomutt-sync.sh
@@ -1,3 +1,4 @@
+# Neomutt-sync - Interactive mail sync with dialog progress bar
 # 1. Create temporary files for the dark theme and notmuch logs
 export DIALOGRC=$(mktemp)
 NOTMUCH_LOG=$(mktemp)
diff --git a/modules/scripts/vpn-connect.sh b/modules/scripts/vpn-connect.sh
index 4ba8f3d..337fa2e 100644
--- a/modules/scripts/vpn-connect.sh
+++ b/modules/scripts/vpn-connect.sh
@@ -1,3 +1,4 @@
+# VPN-connect - OpenVPN connection script with credential caching and monitoring
 CONF_DIR="$HOME/.config/openvpn"
 CREDS_DIR="$CONF_DIR/credentials"
 SERVERS_DIR="$CONF_DIR/servers"
diff --git a/modules/scripts/vpn-disconnect.sh b/modules/scripts/vpn-disconnect.sh
index ead912c..9a70231 100644
--- a/modules/scripts/vpn-disconnect.sh
+++ b/modules/scripts/vpn-disconnect.sh
@@ -1,3 +1,4 @@
+# VPN-disconnect - Kill VPN process and clean up
 PID_FILE="$HOME/.cache/openvpn/vpn.pid"
 
 if [[ ! -f "$PID_FILE" ]]; then
-- 
cgit v1.2.3