@fredlackey/devutils 0.0.1

package/src/scripts/brewi.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Install packages via Homebrew.
+ * @module scripts/brewi
+ */
+
+/**
+ * Installs the specified package(s) using Homebrew.
+ * Shorthand for `brew install`.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Package name to install
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement brew install
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/brewr.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Uninstall packages via Homebrew.
+ * @module scripts/brewr
+ */
+
+/**
+ * Uninstalls the specified package(s) using Homebrew.
+ * Shorthand for `brew uninstall`.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Package name to uninstall
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement brew uninstall
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/brews.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Search for packages via Homebrew.
+ * @module scripts/brews
+ */
+
+/**
+ * Searches for packages matching the specified term using Homebrew.
+ * Shorthand for `brew search`.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Search term
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement brew search
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/brewu.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Update, upgrade, and cleanup Homebrew.
+ * @module scripts/brewu
+ */
+
+/**
+ * Performs a full Homebrew maintenance cycle:
+ * update (fetch latest formulae), upgrade (update packages), and cleanup.
+ *
+ * @param {string[]} args - Command line arguments (unused)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement brew update/upgrade/cleanup
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/c.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Clear the terminal screen.
+ * @module scripts/c
+ */
+
+/**
+ * Clears the terminal screen by outputting the appropriate
+ * escape sequences for the current platform.
+ *
+ * @param {string[]} args - Command line arguments (unused)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement terminal clear
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/ccurl.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Curl JSON endpoint with pretty output.
+ * @module scripts/ccurl
+ */
+
+/**
+ * Fetches a URL expecting JSON response and pretty-prints
+ * the output using jq-style formatting.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - URL to fetch
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement JSON curl with pretty print
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/certbot-crontab-init.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Add certbot renewal cron job.
+ * @module scripts/certbot-crontab-init
+ */
+
+/**
+ * Adds a cron job to automatically renew SSL certificates
+ * using certbot. Checks if cron service is running and starts
+ * it if necessary.
+ *
+ * @param {string[]} args - Command line arguments (unused)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement certbot cron setup
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/certbot-init.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Install SSL certificates via certbot.
+ * @module scripts/certbot-init
+ */
+
+/**
+ * Installs SSL certificates for the specified domains using
+ * certbot with nginx integration. Installs certbot if not present.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - -d/--domain: Domain name(s) for certificate
+ * @param {string} args.1 - -e/--email: Email for Let's Encrypt registration
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement certbot SSL setup
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/ch.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Clear bash command history.
+ * @module scripts/ch
+ */
+
+/**
+ * Clears the bash command history by truncating the history file
+ * and clearing the in-memory history.
+ *
+ * @param {string[]} args - Command line arguments (unused)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement history clear
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/claude-danger.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Launch Claude CLI skipping permission checks.
+ * @module scripts/claude-danger
+ */
+
+/**
+ * Launches the Claude CLI with the --dangerously-skip-permissions
+ * flag, bypassing permission prompts. Use with caution.
+ *
+ * @param {string[]} args - Command line arguments to pass to Claude
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement Claude CLI launcher
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/clean-dev.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Remove node_modules and bower_components recursively.
+ * @module scripts/clean-dev
+ */
+
+/**
+ * Recursively finds and removes all node_modules and bower_components
+ * directories to free up disk space.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} [args.0] - Optional path to clean (defaults to current directory)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement recursive dev folder cleanup
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/clear-dns-cache.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Flush the DNS cache.
+ * @module scripts/clear-dns-cache
+ */
+
+/**
+ * Clears the system's DNS cache to force fresh DNS lookups.
+ * Uses platform-specific commands for each operating system.
+ *
+ * @param {string[]} args - Command line arguments (unused)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement DNS cache flush
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/clone.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Clone a repository and install dependencies.
+ * @module scripts/clone
+ */
+
+/**
+ * Clones a git repository and automatically installs dependencies
+ * if a package.json is found (using npm, yarn, or pnpm).
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Repository URL to clone
+ * @param {string} [args.1] - Optional target directory name
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement clone with dependency install
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/code-all.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Open all subdirectories in VS Code.
+ * @module scripts/code-all
+ */
+
+/**
+ * Opens each immediate subdirectory of the current directory
+ * as a separate VS Code window.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} [args.0] - Optional path (defaults to current directory)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement VS Code multi-open
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/count-files.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Count only files in current directory.
+ * @module scripts/count-files
+ */
+
+/**
+ * Counts and displays the number of files (not directories) in the
+ * current or specified directory.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} [args.0] - Optional path to count (defaults to current directory)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement file counting
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/count-folders.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Count only folders in current directory.
+ * @module scripts/count-folders
+ */
+
+/**
+ * Counts and displays the number of directories (not files) in the
+ * current or specified directory.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} [args.0] - Optional path to count (defaults to current directory)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement folder counting
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/count.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Count files and folders in current directory.
+ * @module scripts/count
+ */
+
+/**
+ * Counts and displays the number of files and folders in the
+ * current or specified directory.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} [args.0] - Optional path to count (defaults to current directory)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement file/folder counting
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/d.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Navigate to the Desktop directory.
+ * @module scripts/d
+ */
+
+/**
+ * Changes the current working directory to the user's Desktop folder.
+ * Outputs the path for use with shell integration (e.g., cd $(d)).
+ *
+ * @param {string[]} args - Command line arguments (unused)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement Desktop navigation
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/datauri.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Convert file to base64 data URI.
+ * @module scripts/datauri
+ */
+
+/**
+ * Converts a file to a base64-encoded data URI string.
+ * Automatically detects the MIME type from the file.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - Path to the file to convert
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement data URI conversion
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/delete-files.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Delete files matching a pattern.
+ * @module scripts/delete-files
+ */
+
+/**
+ * Finds and deletes files matching the specified pattern.
+ * Defaults to removing .DS_Store files if no pattern is provided.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} [args.0] - Glob pattern to match (defaults to "*.DS_Store")
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement pattern-based file deletion
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/docker-clean.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Remove all Docker containers, images, and volumes.
+ * @module scripts/docker-clean
+ */
+
+/**
+ * Removes ALL Docker containers, images, and volumes after
+ * prompting for confirmation. This action cannot be undone.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} [args.0] - Pass "--force" to skip confirmation
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement Docker cleanup
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/dp.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Display running Docker containers in formatted table.
+ * @module scripts/dp
+ */
+
+/**
+ * Displays a formatted table of running Docker containers
+ * showing ID, name, and port mappings.
+ *
+ * @param {string[]} args - Command line arguments (unused)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement Docker container listing
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/e.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Open a file in vim editor.
+ * @module scripts/e
+ */
+
+/**
+ * Opens the specified file(s) in the vim editor.
+ * Passes all arguments directly to vim.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - File path to open in vim
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement vim launcher
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/empty-trash.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Empty all trash and system logs.
+ * @module scripts/empty-trash
+ */
+
+/**
+ * Empties the system trash, mounted volume trash, and clears
+ * system logs to free up disk space.
+ *
+ * @param {string[]} args - Command line arguments (unused)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement trash emptying
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/evm.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Execute vim macro on multiple files.
+ * @module scripts/evm
+ */
+
+/**
+ * Executes a vim macro (stored in register 'q') on one or more files.
+ * Optionally repeats the macro multiple times per file.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - File path(s) to process
+ * @param {string} [args.last] - Number of times to run macro (default: 1)
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement vim macro execution
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/fetch-github-repos.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Clone all repositories from a GitHub organization.
+ * @module scripts/fetch-github-repos
+ */
+
+/**
+ * Fetches the list of repositories from a GitHub organization
+ * and clones each one into the specified destination folder.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - GitHub organization name
+ * @param {string} args.1 - Destination folder path
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement GitHub org repo fetcher
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}

package/src/scripts/get-channel.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @fileoverview Download all videos from a YouTube channel.
+ * @module scripts/get-channel
+ */
+
+/**
+ * Downloads all videos from a YouTube channel using yt-dlp.
+ * Names files with upload date prefix for organization.
+ *
+ * @param {string[]} args - Command line arguments
+ * @param {string} args.0 - YouTube channel name or URL
+ * @returns {Promise<void>}
+ */
+async function main(args) {
+  // TODO: Implement channel download
+}
+
+module.exports = { main };
+
+if (require.main === module) {
+  main(process.argv.slice(2));
+}