parvej-ahmed-sound CLI

Global tool that adds playful sounds to your PowerShell session by hooking into the user profile. Designed for developers who want a little audio every time they run a command.

Installation

npm install -g parvej-ahmed-sound

Once installed, you can run the command namespace parvej-sound:

parvej-sound help

Commands

• enable — modify profile, backup, and start playing sounds
• disable — remove injected hook (quiet mode)
• uninstall — restore original profile, delete config, and remove hooks
• status — show current state (enabled/disabled, volume, sound name)
• volume <0-100> — set playback volume percentage
• set <name> — choose built-in sound (matrix, click, etc.) or set custom <url> for an MP3 link
• reset — revert configuration to defaults
• about — developer contact info
• help — display this usage message

There is also a hidden internal command _play that the PowerShell hook invokes; you do not call this directly.

Development & Testing

git clone <repo>
cd parvej-ahmed-sound
npm install
npm link       # symlink globally for testing
parvej-sound enable

Safety and Profile Modification

• The CLI will prompt for confirmation before modifying your PowerShell profile.
• A backup file named Microsoft.PowerShell_profile_backup_YYYY-MM-DD.ps1 is created automatically.
• Injected code lives between markers: # === PARVEJ SOUND START === and # === PARVEJ SOUND END ===. Only that block is removed when disabling or uninstalling.

Publishing

Package is already configured with a bin entry and preferGlobal. Follow the same steps as with the earlier parvej-ahmed project:

1. npm login
2. bump version in package.json
3. npm publish --access public

Users may then install via npx parvej-sound or globally.

Feel free to expand sounds, add tests, or port the profile logic to other shells (bash, zsh) in the future.