@fredlackey/devutils 0.0.1

package/src/scripts/get-course.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Download a Pluralsight course.
+ * @module scripts/get-course
+ */
+
+/**
+ * Downloads a course from Pluralsight using yt-dlp with
+ * rate limiting and sleep intervals to avoid detection.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Course name from URL
+ * @param {string} args.1 - Pluralsight username
+ * @param {string} args.2 - Pluralsight password
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement Pluralsight course download
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/get-dependencies.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Extract dependency names from package.json.
+ * @module scripts/get-dependencies
+ */
+
+/**
+ * Extracts and lists dependency names from a package.json file.
+ * Can filter by dependency type (dependencies, devDependencies, etc.).
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Path to package.json
+ * @param {string} [args.1] - Dependency type: "dev", "peer", "opt", or "dependencies"
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement dependency extraction
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/get-folder.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Copy files with size comparison using rsync/robocopy.
+ * @module scripts/get-folder
+ */
+
+/**
+ * Copies files from source to target directory, skipping files that
+ * already exist in the target with the same size. Uses rsync on
+ * Unix systems and robocopy on Windows.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Source folder path
+ * @param {string} args.1 - Target folder path
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement smart folder copy
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/get-tunes.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Download audio/video from URL using yt-dlp.
+ * @module scripts/get-tunes
+ */
+
+/**
+ * Downloads audio and/or video from a URL using yt-dlp.
+ * Supports audio-only and video-only modes.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - URL to download from
+ * @param {string} [args.1] - Mode: "audio-only" or "video-only" (default: both)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement yt-dlp download
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/get-video.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Download video only from URL using yt-dlp.
+ * @module scripts/get-video
+ */
+
+/**
+ * Downloads video (without audio) from a URL using yt-dlp.
+ * Outputs in MP4 format.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - URL to download from
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement video-only download
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/git-backup.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Create timestamped zip backup of a git repository.
+ * @module scripts/git-backup
+ */
+
+/**
+ * Creates a mirror clone of the repository and packages it into a
+ * timestamped zip file. Skips backup if no changes since last backup.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Target folder for the backup
+ * @param {string} [args.1] - Optional SSH repo URL (defaults to current repo)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement git backup
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/git-clone.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Copy repository structure without .git folder.
+ * @module scripts/git-clone
+ */
+
+/**
+ * Copies a repository's file structure to the current directory
+ * excluding the .git folder, README, LICENSE, and dependency folders.
+ * Useful for using a repo as a template.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Source repository path
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement structure-only clone
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/git-pup.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Pull and update git submodules.
+ * @module scripts/git-pup
+ */
+
+/**
+ * Performs a git pull and updates all submodules.
+ * Equivalent to: git pull && git submodule init && git submodule update
+ *
+ * @param {string[]} args - Command line arguments (unused)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement pull with submodule update
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/git-push.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Add, commit, and push in one command.
+ * @module scripts/git-push
+ */
+
+/**
+ * Stages all changes, commits with the provided message, and pushes
+ * to the current branch's remote.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Commit message
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement add/commit/push workflow
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/h.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Search command history.
+ * @module scripts/h
+ */
+
+/**
+ * Searches the shell command history for entries matching
+ * the specified pattern and displays results with highlighting.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Search pattern
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement history search
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/hide-desktop-icons.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Hide desktop icons in Finder.
+ * @module scripts/hide-desktop-icons
+ */
+
+/**
+ * Hides all icons on the macOS desktop by modifying Finder preferences
+ * and restarting Finder.
+ *
+ * @param {string[]} args - Command line arguments (unused)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement desktop icon hiding
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/hide-hidden-files.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Hide dotfiles in Finder.
+ * @module scripts/hide-hidden-files
+ */
+
+/**
+ * Configures Finder to hide hidden files (dotfiles) and restarts Finder
+ * to apply the change.
+ *
+ * @param {string[]} args - Command line arguments (unused)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement hidden file hiding
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/install-dependencies-from.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Install dependencies from another package.json.
+ * @module scripts/install-dependencies-from
+ */
+
+/**
+ * Reads dependencies from a specified package.json and installs them
+ * into the current project at their latest versions.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Path to source package.json
+ * @param {string} [args.1] - Dependency type: "dev", "peer", "opt", or "dependencies"
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement dependency installation from external package.json
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/ips.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Scan local network for active IPs using nmap.
+ * @module scripts/ips
+ */
+
+/**
+ * Scans the local network for active IP addresses using nmap.
+ * Defaults to scanning 192.168.1.0/24.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} [args.0] - Network base IP (default: "192.168.1.0")
+ * @param {string} [args.1] - Subnet mask bits (default: "24")
+ * @param {string} [args.2] - Options: "ip-only" or "no-sudo"
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement network scanning
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/iso.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Print ISO 8601 timestamp.
+ * @module scripts/iso
+ */
+
+/**
+ * Outputs the current date and time in ISO 8601 format.
+ * Optionally uses a specific timezone.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} [args.0] - Optional timezone (e.g., "America/Los_Angeles")
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement ISO timestamp output
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/killni.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Kill Node Inspector processes.
+ * @module scripts/killni
+ */
+
+/**
+ * Finds and kills all Node.js processes running with the
+ * --debug-brk flag (Node Inspector).
+ *
+ * @param {string[]} args - Command line arguments (unused)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement Node Inspector process killer
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/ll.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Long listing of directory contents.
+ * @module scripts/ll
+ */
+
+/**
+ * Displays a detailed listing of files and directories in the current
+ * or specified directory, similar to `ls -l`.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} [args.0] - Optional path to list (defaults to current directory)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement long listing
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/local-ip.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Get local network IP address.
+ * @module scripts/local-ip
+ */
+
+/**
+ * Displays the local network IP address of the machine.
+ * Uses platform-specific commands to retrieve the IP.
+ *
+ * @param {string[]} args - Command line arguments (unused)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement local IP display
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/m.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Open man pages for a command.
+ * @module scripts/m
+ */
+
+/**
+ * Displays the manual page for the specified command.
+ * Wrapper around the system `man` command.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Command name to look up in man pages
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement man page viewer
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/map.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Execute a command for each line of input.
+ * @module scripts/map
+ */
+
+/**
+ * Reads lines from stdin and executes the specified command
+ * for each line, similar to `xargs -n1`.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Command to execute for each input line
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement xargs-like mapping
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/mkd.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Create directory and navigate into it.
+ * @module scripts/mkd
+ */
+
+/**
+ * Creates a new directory (including parent directories) and
+ * outputs the path for shell navigation (e.g., cd $(mkd mydir)).
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Directory path to create
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement mkdir with cd
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/ncu-update-all.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Update all package.json dependencies using ncu.
+ * @module scripts/ncu-update-all
+ */
+
+/**
+ * Finds all package.json files recursively and runs npm-check-updates
+ * to update all dependencies to their latest versions.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} [args.0] - Optional path to search (defaults to current directory)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement recursive ncu update
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/nginx-init.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Create nginx configuration from template.
+ * @module scripts/nginx-init
+ */
+
+/**
+ * Creates an nginx site configuration file from a template,
+ * replacing domain and host URL placeholders.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - -d/--domain: Domain name(s)
+ * @param {string} args.1 - -h/--host: Upstream host URL
+ * @param {string} args.2 - -f/--file: Output filename
+ * @param {string} [args.3] - -l/--link: Create symlink to sites-enabled
+ * @param {string} [args.4] - -a/--api: Use API template variant
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement nginx config generation
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/npmi.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Remove node_modules and reinstall dependencies.
+ * @module scripts/npmi
+ */
+
+/**
+ * Removes the node_modules folder and reinstalls all dependencies
+ * using the detected package manager (npm, yarn, or pnpm).
+ *
+ * @param {string[]} args - Command line arguments (unused)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement clean reinstall
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/o.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Open file or folder in system file manager.
+ * @module scripts/o
+ */
+
+/**
+ * Opens the specified file or folder in the system's default file manager.
+ * Uses platform-specific commands (macOS: open, Linux: xdg-open, Windows: explorer).
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} [args.0] - Path to open (defaults to current directory)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement file manager open
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/org-by-date.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Organize files into date-based folder structure.
+ * @module scripts/org-by-date
+ */
+
+/**
+ * Organizes files in the current directory into subdirectories
+ * based on dates found in their filenames (YYYY/MM/DD structure).
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} [args.0] - Optional path to organize (defaults to current directory)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement date-based file organization
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}