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:

``bash

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

$3

- 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
`powershell

Preview which files would be moved

npx scriptarium powershell MoveResumes -- -DryRun

Execute the move

npx scriptarium powershell MoveResumes --
`

---

$3

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

Examples
`powershell

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

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:
`powershell
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.