tr200 2.0.0 → 2.0.2

package/README.md

@@ -80,45 +80,55 @@ If your system is different, things might break. Look up the offending line and
 npm install -g tr200
 ```
 
-**That's it!** Now you can run:
-
+**Run on-demand:**
 ```bash
 tr200
 # or
 report
 ```
 
-**Requirements:**
-- Node.js 14.0.0 or later
-- bash (Linux/macOS) or PowerShell (Windows)
+**Set up auto-run on terminal startup:**
+```bash
+tr200 --install
+```
+
+**Remove auto-run:**
+```bash
+tr200 --uninstall
+```
+
+**Completely uninstall:**
+```bash
+tr200 --uninstall
+npm uninstall -g tr200
+```
 
-**What this does:**
-- Downloads the TR-200 package from npm
-- Creates global `tr200` and `report` commands
-- Automatically detects your OS and runs the appropriate script
+**Requirements:** Node.js 14.0.0 or later
+
+---
 
-**Note:** The npm version is for on-demand use. If you want TR-200 to auto-run on terminal startup, use one of the install scripts below instead.
+## Quick Reference
+
+| Command | Description |
+|---------|-------------|
+| `tr200` | Run the machine report |
+| `tr200 --help` | Show help |
+| `tr200 --version` | Show version |
+| `tr200 --install` | Set up auto-run on terminal startup |
+| `tr200 --uninstall` | Remove auto-run configuration |
 
 ---
 
-## ⚡ Super Quick Install (install.sh)
+## ⚡ Alternative: install.sh (No Node.js Required)
 
-**Simplest method - fully automated!**
+**For users without Node.js:**
 
 ```bash
 cd ~/git-projects && gh repo clone RealEmmettS/usgc-machine-report && \
 cd RealEmmettS-usgc-machine-report && ./install.sh
 ```
 
-The `install.sh` script handles everything:
-- Detects your OS and architecture
-- Installs dependencies (lastlog2)
-- Backs up existing installations
-- Copies and configures the script
-- Tests everything works
-- Sets up the `report` alias
-
-**That's it! Type `report` or open a new terminal to see it in action.**
+The `install.sh` script handles everything: OS detection, dependency installation, backup, configuration, and auto-run setup.
 
 ---
 
@@ -146,194 +156,16 @@ The script creates `dist/tr-200-machine-report.zip` containing the launchers, `m
 
 ---
 
-## 🤖 Claude Code Automated Installation
-
-**Best for:** Using with [Claude Code](https://claude.ai/code) AI assistant
+## 🤖 Claude Code Installation
 
 Ask Claude Code:
 
 ```
-Install usgc-machine-report from RealEmmettS/usgc-machine-report using install.sh
-```
-
-Or provide these specific instructions:
-
-```bash
-cd ~/git-projects && \
-gh repo clone RealEmmettS/usgc-machine-report && \
-cd RealEmmettS-usgc-machine-report && \
-./install.sh
-```
-
-Claude Code will automatically:
-1. Clone this repository
-2. Install `lastlog2` if on Debian/Raspberry Pi OS
-3. Copy script to `~/.machine_report.sh`
-4. Add to `.bashrc` with automatic run on login
-5. Create convenient `report` alias
-
-**Or provide these specific instructions to Claude Code:**
-
-```bash
-# 1. Clone the repository
-cd ~/git-projects
-gh repo clone RealEmmettS/usgc-machine-report
-
-# 2. Install dependencies (Debian/Ubuntu/Raspberry Pi OS)
-sudo apt install -y lastlog2
-
-# 3. Install the script
-cp ~/git-projects/RealEmmettS-usgc-machine-report/machine_report.sh ~/.machine_report.sh
-chmod +x ~/.machine_report.sh
-
-# 4. Add to .bashrc
-cat >> ~/.bashrc << 'EOF'
-
-# Machine Report alias - run anytime with 'report' command
-alias report='~/.machine_report.sh'
-
-# Run Machine Report only when in interactive mode
-if [[ $- == *i* ]]; then
-    ~/.machine_report.sh
-fi
-EOF
-
-# 5. Test installation
-~/.machine_report.sh
+npm install -g tr200 && tr200 --install
 ```
 
 ---
 
-## 🍎 macOS Installation
-
-**Requirements:**
-- macOS 10.13 (High Sierra) or later
-- Bash 4.0+ recommended (install via `brew install bash`)
-
-**Quick Install:**
-
-```bash
-cd ~/git-projects && gh repo clone RealEmmettS/usgc-machine-report && \
-cd RealEmmettS-usgc-machine-report && ./install.sh
-```
-
-**What works on macOS:**
-- ✅ OS version detection (via `sw_vers`)
-- ✅ CPU info (via `sysctl`)
-- ✅ Memory usage (via `vm_stat`)
-- ✅ Disk usage (via `df`)
-- ✅ Network info (via `scutil`)
-- ✅ System uptime (calculated from boot time)
-- ⚠️ Last login may show "unavailable" (macOS limitation)
-
-**macOS-Specific Notes:**
-- No package installation needed - uses built-in commands
-- Default Bash 3.2 works but Bash 4+ recommended
-- To install newer Bash: `brew install bash`
-- Script automatically detects macOS and uses appropriate commands
-
-### 🐚 zsh Installation (macOS Default Shell)
-
-**Modern macOS (Catalina 10.15+) uses zsh by default**, not bash. If you're using zsh, follow these instructions:
-
-**Quick Install for zsh:**
-
-```bash
-# Clone and install the script
-cd ~/Downloads && git clone https://github.com/RealEmmettS/usgc-machine-report.git && \
-cp ~/Downloads/usgc-machine-report/machine_report.sh ~/.machine_report.sh && \
-chmod +x ~/.machine_report.sh
-
-# Add to .zshrc (not .bashrc!)
-cat >> ~/.zshrc << 'EOF'
-
-# Machine Report alias - run anytime with 'report' command
-alias report='~/.machine_report.sh'
-
-# Run Machine Report only when in interactive mode
-if [[ $- == *i* ]]; then
-    ~/.machine_report.sh
-fi
-EOF
-
-# Clean up cloned repo (optional)
-rm -rf ~/Downloads/usgc-machine-report
-
-echo "✅ Installation complete! Open a new terminal or type: source ~/.zshrc"
-```
-
-**Important zsh Notes:**
-- ✅ Use `~/.zshrc` instead of `~/.bashrc`
-- ✅ The script works identically in zsh - no code changes needed
-- ✅ Test with: `zsh -c "source ~/.zshrc && report"`
-- ℹ️ To check your shell: `echo $SHELL` (should show `/bin/zsh`)
-
----
-
-## 📦 Quick Install (Manual - Raspberry Pi OS / Debian)
-
-**One-liner installation:**
-
-```bash
-cd ~/git-projects && gh repo clone RealEmmettS/usgc-machine-report && \
-sudo apt install -y lastlog2 && \
-cp ~/git-projects/RealEmmettS-usgc-machine-report/machine_report.sh ~/.machine_report.sh && \
-chmod +x ~/.machine_report.sh && \
-cat >> ~/.bashrc << 'EOF'
-
-# Machine Report alias - run anytime with 'report' command
-alias report='~/.machine_report.sh'
-
-# Run Machine Report only when in interactive mode
-if [[ $- == *i* ]]; then
-    ~/.machine_report.sh
-fi
-EOF
-echo "✅ Installation complete! Type 'report' or open a new terminal."
-```
-
-**Step-by-step installation:**
-
-1. **Clone the repository**:
-   ```bash
-   cd ~/git-projects
-   gh repo clone RealEmmettS/usgc-machine-report
-   ```
-
-2. **Install dependencies** (for modern Debian/Raspberry Pi OS):
-   ```bash
-   sudo apt install -y lastlog2
-   ```
-
-   *Note: On systems with the legacy `lastlog` command, this step is optional. The script automatically detects and uses whichever is available.*
-
-3. **Copy the script to your home directory**:
-   ```bash
-   cp ~/git-projects/RealEmmettS-usgc-machine-report/machine_report.sh ~/.machine_report.sh
-   chmod +x ~/.machine_report.sh
-   ```
-
-4. **Add to `.bashrc` for automatic display on login**:
-   ```bash
-   cat >> ~/.bashrc << 'EOF'
-
-# Machine Report alias - run anytime with 'report' command
-alias report='~/.machine_report.sh'
-
-# Run Machine Report only when in interactive mode
-if [[ $- == *i* ]]; then
-    ~/.machine_report.sh
-fi
-EOF
-   ```
-
-5. **Test the installation**:
-   ```bash
-   ~/.machine_report.sh
-   ```
-
----
-
 ## 🛠️ Manual Installation (Advanced)
 
 For login sessions over ssh, reference the script `~/.machine_report.sh` in your `.bashrc` file. Make sure the script is executable by running `chmod +x ~/.machine_report.sh`.
@@ -432,6 +264,24 @@ For ZFS systems, edit:
 
 ## 📝 Changelog (Fork-specific)
 
+### v2.0.1 (2026-01-30) - **INSTALL FLAGS + PS 5.1 FIXES**
+**New CLI Flags + PowerShell Compatibility**
+
+- ✨ **`--install` flag**: Set up auto-run on terminal startup via npm
+- ✨ **`--uninstall` flag**: Remove auto-run configuration cleanly
+- ✨ **`--help` flag**: Show usage information (all scripts)
+- ✨ **`--version` flag**: Show version information (all scripts)
+- 🔧 **PowerShell 5.1 compatibility**: Fixed `[System.Net.Dns]::GetHostName()` and null-conditional operators
+- 📚 **Simplified README**: npm + `--install` promoted as primary installation method
+
+**Upgrade path:**
+```bash
+npm update -g tr200
+tr200 --install  # Re-run to update shell config if needed
+```
+
+---
+
 ### v2.0.0 (2026-01-30) - **SHAUGHV REBRAND + NPM RELEASE**
 **Complete Rebrand + Auto-Run Enhancements + npm Publishing**
 

package/WINDOWS/TR-200-MachineReport.ps1

@@ -20,6 +20,58 @@
     Tested  : Windows PowerShell 5.1 and PowerShell 7+
 #>
 
+[CmdletBinding()]
+param(
+    [Alias('h', '?')]
+    [switch]$Help,
+
+    [Alias('v')]
+    [switch]$Version,
+
+    [Parameter(ValueFromRemainingArguments = $true)]
+    [string[]]$RemainingArgs
+)
+
+$script:TR200Version = '2.0.1'
+
+# Handle Unix-style --flags (PowerShell doesn't natively support double-dash)
+if ($RemainingArgs) {
+    foreach ($arg in $RemainingArgs) {
+        if ($arg -eq '--help' -or $arg -eq '-help') { $Help = $true }
+        if ($arg -eq '--version' -or $arg -eq '-version') { $Version = $true }
+    }
+}
+
+function Show-TR200Help {
+    $helpText = @"
+
+TR-200 Machine Report v$script:TR200Version
+
+Usage: TR-200-MachineReport.ps1 [options]
+       report [options]
+
+Displays system information in a formatted table with Unicode box-drawing.
+
+Options:
+  --help, -h        Show this help message
+  --version, -v     Show version number
+
+When installed via npm (tr200):
+  tr200             Run the machine report
+  tr200 --help      Show help (includes install/uninstall options)
+  tr200 --install   Set up auto-run on terminal startup
+  tr200 --uninstall Remove auto-run from shell startup
+
+When installed via install_windows.ps1:
+  report            Run the machine report (works in CMD and PowerShell)
+  uninstall         Remove TR-200 Machine Report
+
+More info: https://github.com/RealEmmettS/usgc-machine-report
+
+"@
+    Write-Host $helpText
+}
+
 #region Encoding and box-drawing configuration
 
 # Ensure UTF-8 output for proper box-drawing characters on Windows PowerShell 5.1
@@ -60,16 +112,20 @@ function New-TR200BarGraph {
         [int]   $Width
     )
 
+    # Convert chars to strings for multiplication (PS 5.1 compatibility)
+    $barFilled = [string]$TR200Chars.BarFilled
+    $barEmpty  = [string]$TR200Chars.BarEmpty
+
     if ($Total -le 0) {
-        return ($TR200Chars.BarEmpty * [math]::Max($Width, 1))
+        return ($barEmpty * [math]::Max($Width, 1))
     }
 
     $percent    = [math]::Max([math]::Min(($Used / $Total) * 100.0, 100.0), 0.0)
     $filledBars = [int]([math]::Round(($percent / 100.0) * $Width))
     if ($filledBars -gt $Width) { $filledBars = $Width }
 
-    $filled = $TR200Chars.BarFilled * $filledBars
-    $empty  = $TR200Chars.BarEmpty * ([math]::Max($Width,0) - $filledBars)
+    $filled = $barFilled * $filledBars
+    $empty  = $barEmpty * ([math]::Max($Width,0) - $filledBars)
     return "$filled$empty"
 }
 
@@ -404,14 +460,21 @@ function Show-TR200Report {
     }
 
     # Total inner width of table (excluding outer borders)
-    $innerWidth = 2 + $labelWidth + 3 + $dataWidth + 2  # "│ <label> │ <value> │"
+    # Row format: "│ <label> │ <value> │" = 1+1+label+1+1+1+data+1+1 = label+data+7
+    # Inner width is between outer │ chars: " <label> │ <value> " = label+data+5
+    $innerWidth = $labelWidth + $dataWidth + 5
+
+    # Convert chars to strings for multiplication (PS 5.1 compatibility)
+    $hzLine = [string]$TR200Chars.Horizontal
+    $vtLine = [string]$TR200Chars.Vertical
+    $tDown  = [string]$TR200Chars.TDown
 
     # Helper to write the top header and borders
     function Write-TR200TopHeader {
         param()
-        $top = $TR200Chars.TopLeft + ($TR200Chars.Horizontal * ($innerWidth)) + $TR200Chars.TopRight
+        $top = $TR200Chars.TopLeft + ($hzLine * ($innerWidth)) + $TR200Chars.TopRight
         Write-Host $top
-        $mid = $TR200Chars.TRight + ($TR200Chars.TDown * ($innerWidth)) + $TR200Chars.TLeft
+        $mid = $TR200Chars.TRight + ($tDown * ($innerWidth)) + $TR200Chars.TLeft
         Write-Host $mid
     }
 
@@ -427,7 +490,7 @@ function Show-TR200Report {
             if ($i -eq ($labelWidth + 2)) {
                 $line += $mid
             } else {
-                $line += $TR200Chars.Horizontal
+                $line += $hzLine
             }
         }
         $line += $right
@@ -436,7 +499,7 @@ function Show-TR200Report {
 
     function Write-TR200Footer {
         param()
-        $bottom = $TR200Chars.BottomLeft + ($TR200Chars.Horizontal * ($innerWidth)) + $TR200Chars.BottomRight
+        $bottom = $TR200Chars.BottomLeft + ($hzLine * ($innerWidth)) + $TR200Chars.BottomRight
         Write-Host $bottom
     }
 
@@ -450,7 +513,9 @@ function Show-TR200Report {
         $padding = $totalWidth - $text.Length
         $leftPad  = [int]([math]::Floor($padding / 2.0))
         $rightPad = $padding - $leftPad
-        Write-Host ("{0}{1}{2}{3}{4}" -f $TR200Chars.Vertical, ' ' * $leftPad, $text, ' ' * $rightPad, $TR200Chars.Vertical)
+        $leftSpace  = ' ' * $leftPad
+        $rightSpace = ' ' * $rightPad
+        Write-Host ($vtLine + $leftSpace + $text + $rightSpace + $vtLine)
     }
 
     function Write-TR200Row {
@@ -476,7 +541,7 @@ function Show-TR200Report {
             $val = $val.PadRight($dataWidth)
         }
 
-        Write-Host ("{0} {1} {2} {3} {4}" -f $TR200Chars.Vertical, $lbl, $TR200Chars.Vertical, $val, $TR200Chars.Vertical)
+        Write-Host ($vtLine + ' ' + $lbl + ' ' + $vtLine + ' ' + $val + ' ' + $vtLine)
     }
 
     # Render table
@@ -501,11 +566,17 @@ function Show-TR200Report {
 
 #endregion Rendering
 
-# If the script is executed directly (not dot-sourced), show the report immediately
+# If the script is executed directly (not dot-sourced), handle args or show the report
 try {
     if ($MyInvocation.InvocationName -ne '.') {
         # Only auto-run when invoked as a script, not when dot-sourced from a profile
-        Show-TR200Report
+        if ($Help) {
+            Show-TR200Help
+        } elseif ($Version) {
+            Write-Host $script:TR200Version
+        } else {
+            Show-TR200Report
+        }
     }
 } catch {
     Write-Error $_

package/bin/tr200.js

@@ -13,8 +13,180 @@
 const { spawn } = require('child_process');
 const path = require('path');
 const fs = require('fs');
+const os = require('os');
+const readline = require('readline');
 
 const isWindows = process.platform === 'win32';
+const isMac = process.platform === 'darwin';
+const homeDir = os.homedir();
+
+// Config block markers for shell profiles
+const CONFIG_MARKER = 'TR-200 Machine Report (npm)';
+const UNIX_CONFIG = `
+# ${CONFIG_MARKER} - auto-run
+if command -v tr200 &> /dev/null; then
+    tr200
+fi
+`;
+const PS_CONFIG = `
+# ${CONFIG_MARKER} - auto-run
+if (Get-Command tr200 -ErrorAction SilentlyContinue) {
+    tr200
+}
+`;
+
+// Shell profile paths
+function getProfilePaths() {
+    if (isWindows) {
+        return [
+            path.join(homeDir, 'Documents', 'PowerShell', 'Microsoft.PowerShell_profile.ps1'),
+            path.join(homeDir, 'Documents', 'WindowsPowerShell', 'Microsoft.PowerShell_profile.ps1')
+        ];
+    } else if (isMac) {
+        return [
+            path.join(homeDir, '.zshrc'),
+            path.join(homeDir, '.bash_profile')
+        ];
+    } else {
+        // Linux/BSD
+        return [
+            path.join(homeDir, '.bashrc'),
+            path.join(homeDir, '.profile')
+        ];
+    }
+}
+
+// Prompt user for confirmation
+function askConfirmation(question) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout
+        });
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase().startsWith('y'));
+        });
+    });
+}
+
+// Check if config already exists in file
+function hasConfig(filePath) {
+    if (!fs.existsSync(filePath)) return false;
+    const content = fs.readFileSync(filePath, 'utf8');
+    return content.includes(CONFIG_MARKER);
+}
+
+// Install auto-run to shell profiles
+async function installAutoRun() {
+    const profiles = getProfilePaths();
+    const configBlock = isWindows ? PS_CONFIG : UNIX_CONFIG;
+
+    console.log('\nTR-200 Machine Report - Install Auto-Run\n');
+    console.log('This will configure tr200 to run automatically when you open a terminal.');
+    console.log('Profile(s) to modify:');
+    profiles.forEach(p => console.log(`  - ${p}`));
+    console.log('');
+
+    const confirmed = await askConfirmation('Proceed with installation? (y/N): ');
+    if (!confirmed) {
+        console.log('Installation cancelled.');
+        process.exit(0);
+    }
+
+    let installed = 0;
+    let skipped = 0;
+
+    for (const profilePath of profiles) {
+        // Check if already configured
+        if (hasConfig(profilePath)) {
+            console.log(`  [skip] ${profilePath} - already configured`);
+            skipped++;
+            continue;
+        }
+
+        // Ensure directory exists
+        const dir = path.dirname(profilePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+
+        // Append config block
+        try {
+            fs.appendFileSync(profilePath, configBlock, 'utf8');
+            console.log(`  [done] ${profilePath}`);
+            installed++;
+        } catch (err) {
+            console.error(`  [error] ${profilePath}: ${err.message}`);
+        }
+    }
+
+    console.log('');
+    if (installed > 0) {
+        console.log(`Success! Auto-run configured in ${installed} profile(s).`);
+        console.log('Open a new terminal window to see the report on startup.');
+    } else if (skipped === profiles.length) {
+        console.log('Auto-run was already configured in all profiles.');
+    }
+    process.exit(0);
+}
+
+// Uninstall auto-run from shell profiles
+async function uninstallAutoRun() {
+    const profiles = getProfilePaths();
+
+    console.log('\nTR-200 Machine Report - Remove Auto-Run\n');
+    console.log('This will remove the auto-run configuration from your shell profile(s).');
+    console.log('Profile(s) to check:');
+    profiles.forEach(p => console.log(`  - ${p}`));
+    console.log('');
+
+    const confirmed = await askConfirmation('Proceed with removal? (y/N): ');
+    if (!confirmed) {
+        console.log('Removal cancelled.');
+        process.exit(0);
+    }
+
+    let removed = 0;
+
+    for (const profilePath of profiles) {
+        if (!fs.existsSync(profilePath)) {
+            continue;
+        }
+
+        const content = fs.readFileSync(profilePath, 'utf8');
+        if (!content.includes(CONFIG_MARKER)) {
+            continue;
+        }
+
+        // Remove the config block (handles both Unix and PowerShell formats)
+        // Match from the comment line through the closing fi/}
+        const unixPattern = /\n?# TR-200 Machine Report \(npm\) - auto-run\nif command -v tr200 &> \/dev\/null; then\n    tr200\nfi\n?/g;
+        const psPattern = /\n?# TR-200 Machine Report \(npm\) - auto-run\nif \(Get-Command tr200 -ErrorAction SilentlyContinue\) \{\n    tr200\n\}\n?/g;
+
+        let newContent = content.replace(unixPattern, '');
+        newContent = newContent.replace(psPattern, '');
+
+        if (newContent !== content) {
+            try {
+                fs.writeFileSync(profilePath, newContent, 'utf8');
+                console.log(`  [done] ${profilePath}`);
+                removed++;
+            } catch (err) {
+                console.error(`  [error] ${profilePath}: ${err.message}`);
+            }
+        }
+    }
+
+    console.log('');
+    if (removed > 0) {
+        console.log(`Success! Auto-run removed from ${removed} profile(s).`);
+    } else {
+        console.log('No auto-run configuration found in any profile.');
+    }
+    console.log('\nNote: To completely remove tr200, run: npm uninstall -g tr200');
+    process.exit(0);
+}
 
 // Locate the script files relative to this wrapper
 const packageRoot = path.resolve(__dirname, '..');
@@ -36,6 +208,8 @@ function runReport() {
         command = 'pwsh';
         args = ['-ExecutionPolicy', 'Bypass', '-NoProfile', '-File', scriptPath];
 
+        let pwshFailed = false;
+
         const child = spawn(command, args, {
             stdio: 'inherit',
             shell: false
@@ -44,6 +218,7 @@ function runReport() {
         child.on('error', (err) => {
             // If pwsh not found, try Windows PowerShell
             if (err.code === 'ENOENT') {
+                pwshFailed = true;
                 const fallback = spawn('powershell', args, {
                     stdio: 'inherit',
                     shell: false
@@ -64,7 +239,10 @@ function runReport() {
         });
 
         child.on('close', (code) => {
-            process.exit(code || 0);
+            // Only handle close if pwsh didn't fail (otherwise fallback handles it)
+            if (!pwshFailed) {
+                process.exit(code || 0);
+            }
         });
 
     } else {
@@ -102,7 +280,7 @@ function runReport() {
 // Handle help flag
 if (process.argv.includes('--help') || process.argv.includes('-h')) {
     console.log(`
-TR-200 Machine Report v2.0.0
+TR-200 Machine Report v2.0.1
 
 Usage: tr200 [options]
        report [options]
@@ -112,6 +290,8 @@ Displays system information in a formatted table with Unicode box-drawing.
 Options:
   -h, --help      Show this help message
   -v, --version   Show version number
+  --install       Set up auto-run on terminal/shell startup
+  --uninstall     Remove auto-run from shell startup
 
 More info: https://github.com/RealEmmettS/usgc-machine-report
 `);
@@ -120,9 +300,17 @@ More info: https://github.com/RealEmmettS/usgc-machine-report
 
 // Handle version flag
 if (process.argv.includes('--version') || process.argv.includes('-v')) {
-    console.log('2.0.0');
+    console.log('2.0.2');
     process.exit(0);
 }
 
-// Run the report
-runReport();
+// Handle install flag
+if (process.argv.includes('--install')) {
+    installAutoRun();
+} else if (process.argv.includes('--uninstall')) {
+    // Handle uninstall flag
+    uninstallAutoRun();
+} else {
+    // Run the report
+    runReport();
+}

package/machine_report.sh

@@ -7,6 +7,49 @@
 # Supports: Linux (all major distros), macOS 10.13+, partial BSD support
 # Requires: Bash 4.0+ (macOS users: brew install bash)
 
+TR200_VERSION="2.0.1"
+
+# Handle command-line arguments
+show_help() {
+    cat << 'EOF'
+
+TR-200 Machine Report v2.0.1
+
+Usage: machine_report.sh [options]
+       report [options]
+
+Displays system information in a formatted table with Unicode box-drawing.
+
+Options:
+  --help, -h        Show this help message
+  --version, -v     Show version number
+
+When installed via npm (tr200):
+  tr200             Run the machine report
+  tr200 --help      Show help (includes install/uninstall options)
+  tr200 --install   Set up auto-run on terminal startup
+  tr200 --uninstall Remove auto-run from shell startup
+
+When installed via install.sh:
+  report            Run the machine report
+  ~/.machine_report.sh  Run directly
+
+More info: https://github.com/RealEmmettS/usgc-machine-report
+
+EOF
+}
+
+case "${1:-}" in
+    --help|-h)
+        show_help
+        exit 0
+        ;;
+    --version|-v)
+        echo "$TR200_VERSION"
+        exit 0
+        ;;
+esac
+
 # Global variables
 MIN_NAME_LEN=5
 MAX_NAME_LEN=13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tr200",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Cross-platform system information report with Unicode box-drawing display",
   "author": "shaughv",
   "license": "BSD-3-Clause",