Scriptarium

Scriptarium is a polyglot collection of reusable scripts and automation recipes. Designed for practical utilities across PowerShell, TypeScript, Python, YAML, and more.

📦 Run via npx

Once published to npm, you can run packaged PowerShell scripts directly:

# List available PowerShell scripts in the package
npx scriptarium list powershell

# Run a specific script (pass PowerShell args after `--`)
npx scriptarium powershell MoveBySearch -- -Search resume -Destination "S:\OneDrive\resume" -DryRun

On Windows, the CLI will prefer PowerShell 7 (pwsh) and fall back to Windows PowerShell (powershell) if needed. On macOS/Linux, ensure pwsh is installed and available on PATH.

📂 Structure

scripts/
  powershell/
    MoveResumes.ps1
    MoveBySearch.ps1
README.md

• scripts/powershell/MoveResumes.ps1 — consolidate resume-like documents into a central folder.
• scripts/powershell/MoveBySearch.ps1 — flexible search-and-move with dry run, caching, and regex.

🚀 Script Summaries

MoveResumes.ps1

• Scans OneDrive (or any root) for resume-like files (resume, résumé, cv, curriculum vitae).
• Supports doc-style extensions (doc, docx, pdf, rtf, odt, txt).
• Excludes folders like @Backup, @Music, and any Pictures directory.
• Duplicate-safe with _001, _002 suffixes.
• -DryRun to preview before executing.

Examples

# Preview which files would be moved
npx scriptarium powershell MoveResumes -- -DryRun

# Execute the move
npx scriptarium powershell MoveResumes --

MoveBySearch.ps1

• Requires -Search and -Destination.
• Optional: -UseRegex, -AllowedExt, -DryRun (caches planned moves), -FromCache.
• Supports _001, _002 duplicate-safe suffixing.

Examples

# Dry run a search for "resume" and cache results
npx scriptarium powershell MoveBySearch -- -Search resume -Destination "S:\OneDrive\resume" -DryRun

# Move exactly those cached files (no new scan)
npx scriptarium powershell MoveBySearch -- -FromCache

# Move cached files to a new destination
npx scriptarium powershell MoveBySearch -- -FromCache -Destination "S:\OneDrive\ResumesArchive"

# Regex search
npx scriptarium powershell MoveBySearch -- -Search "(resume|résumé|cv)" -UseRegex -Destination "S:\OneDrive\resume" -DryRun

🏃 Run Locally Without Installing

If you keep this repo at B:\Dev\scriptarium\ you can run the scripts directly:

# PowerShell 7 (recommended)
pwsh -NoProfile -ExecutionPolicy Bypass -File "B:\Dev\scriptarium\scripts\powershell\MoveBySearch.ps1" -Search resume -Destination "S:\OneDrive\resume" -DryRun

# Windows PowerShell (fallback)
powershell -NoProfile -ExecutionPolicy Bypass -File "B:\Dev\scriptarium\scripts\powershell\MoveBySearch.ps1" -Search resume -Destination "S:\OneDrive\resume" -DryRun

To list available scripts locally:

Get-ChildItem "B:\Dev\scriptarium\scripts\powershell" -Filter *.ps1 | Select-Object -ExpandProperty BaseName

🔧 Requirements

• Node.js 18+ (for the npx scriptarium CLI)
• PowerShell 7 (pwsh) or Windows PowerShell 5.1 (powershell)

📜 License

MIT License – free to use, modify, and distribute.