PSSnips — Terminal-First PowerShell Snippet Manager

A fast, keyboard-driven snippet manager for PowerShell 7.0+ on Windows.

Requirements

PowerShell 7.0+ (pwsh.exe — PowerShell Core)
Windows (uses Windows clipboard APIs, ~\.pssnips\ data path, and Windows Task Scheduler for scheduling features)

Quick Start

Install-Module PSSnips -Scope CurrentUser
Install-PSSnips           # adds Import-Module PSSnips to $PROFILE

snip                      # launch the interactive TUI
snip new deploy           # create your first snippet
snip help                 # show all commands

Note

What's New in v2.0

Breaking change: Get-Snip now returns PSSnips.SnippetInfo typed objects instead of raw PSCustomObject. Scripts that assume untyped hashtable output must be updated.

New in v2.0:

Typed output — Get-Snip returns PSSnips.SnippetInfo objects with TagList [string[]], ModifiedDate [datetime], Language, Description, ContentHash, and GistUrl properties. Enables pipeline-native filtering and sorting.
Layered config (#26) — 4-layer resolution: env vars → workspace config → user config → module defaults. Workspace config (.pssnips/config.json) can be committed to source control.
Event hooks (#27) — Register scriptblock handlers for SnipCreated, SnipEdited, SnipDeleted, SnipExecuted, and SnipPublished events.

Installation

PowerShell Gallery (recommended)

Install-Module PSSnips -Scope CurrentUser

Manual

Import-Module "C:\path\to\PSSnips\PSSnips.psd1"

Tip: Run Install-PSSnips after importing to add the module to your $PROFILE permanently. Run Uninstall-PSSnips to remove it.

Commands Reference

Interactive TUI

snip          # or: snip ui

Key	Action
`↑` `↓`	Navigate list
`Enter` / `→`	Open detail view
`Esc` / `←` / `Backspace`	Go back
`/`	Incremental search / filter
`q`	Quit

Pinned snippets (★) sort to the top. Languages are color-coded in the list view.

Core Snippet Commands

# Create (opens in editor)
New-Snip deploy
New-Snip deploy -Language ps1 -Description 'Azure deploy script' -Tags 'azure','devops'
Add-Snip loader -Path .\loader.py
Add-Snip my-note -Clip -Language md           # from clipboard
Get-Content .\script.ps1 | Add-Snip my-script # from pipeline

# Read
Show-Snip deploy                              # formatted display
Get-Snip                                      # returns PSSnips.SnippetInfo[]
Get-Snip deploy                               # single snippet object
Get-Snip | Where-Object { $_.TagList -contains 'azure' }
Get-Snip | Sort-Object ModifiedDate -Descending
Get-Snip -Shared                              # list from shared store

# Update
Edit-Snip deploy                              # opens in editor
Edit-Snip deploy -Editor nvim

# Delete
Remove-Snip deploy
Remove-Snip deploy -Force                     # skip confirmation

# Clipboard
Copy-Snip deploy

Tag Management

Set-SnipTag deploy -Tags 'azure','devops'     # replace all tags
Set-SnipTag deploy -Add 'prod'                # append tag
Set-SnipTag deploy -Remove 'devops'           # remove tag
Set-SnipTag deploy -Pin                       # pin (★ sorts first)
Set-SnipTag deploy -Unpin

Execution

Invoke-Snip deploy                            # run by file extension
Invoke-Snip deploy -- -Verbose                # pass arguments
Invoke-Snip template -Variables @{ ENV='prod'; REGION='eastus' }   # fill {{PLACEHOLDER}} vars
Invoke-Snip -Pipeline snippet1,snippet2       # chain execution

Supported Runners

Extension	Language	Runner
`.ps1`	PowerShell	Built-in (`pwsh`)
`.py`	Python	`python`
`.js`	JavaScript	`node`
`.bat` / `.cmd`	Batch	`cmd /c`
`.sh`	Bash / Shell	`bash` (WSL)
`.rb`	Ruby	`ruby`
`.go`	Go	`go run`

Templates

New-SnipFromTemplate -Template azure-function -Name my-func -Variables @{ FuncName='HttpTrigger' }
Get-SnipTemplate      # list available templates

New snippets created via New-Snip default to the CBH block template for .ps1/.psm1 files.

Versioning & History

Every Edit-Snip save creates a timestamped version automatically.

Get-SnipHistory deploy              # list all saved versions
Restore-Snip deploy -Version 3     # restore to version 3

Backup & Restore

Export-SnipCollection -Path .\backup.zip        # ZIP of all snippets + index
Import-SnipCollection -Path .\backup.zip        # full restore
Import-SnipCollection -Path .\backup.zip -Merge # merge; existing snippets are kept

Analytics & Maintenance

Get-SnipStats                        # run counts, top snippets, language breakdown
Get-StaleSnip -Days 90               # snippets unused for > 90 days
Get-SnipAuditLog                     # structured audit trail (create/edit/delete/execute)
Test-Snip deploy                     # run PSScriptAnalyzer on a .ps1 snippet inline
Export-VSCodeSnips                   # export all snippets as VS Code snippets.json

Ratings & Comments

Set-SnipRating deploy -Rating 5          # 1–5 stars stored in index
Add-SnipComment deploy -Comment 'Works great in prod'   # timestamped comment

Fuzzy Finder

Invoke-FuzzySnip azure    # fuzzy search name/tag/description; uses fzf if available, falls back to numbered menu

Scheduling

Uses Windows Task Scheduler.

New-SnipSchedule deploy -Trigger Daily -At '08:00'
Get-SnipSchedule
Remove-SnipSchedule deploy

Profile & Terminal Integration

Install-PSSnips                    # adds Import-Module PSSnips to $PROFILE
Uninstall-PSSnips                  # removes the import line
Add-SnipTerminalProfile            # adds a Windows Terminal profile that launches snip
Initialize-SnipPreCommitHook       # installs a Git pre-commit hook: runs Test-Snip on staged .ps1 snippets

PowerShell CBH Metadata Integration

For .ps1 and .psm1 snippets, PSSnips auto-extracts:

.SYNOPSIS → Description
.NOTES Tags: → Tags

Sync-SnipMetadata              # bulk sync CBH → index for all ps1/psm1 snippets
Sync-SnipMetadata -Overwrite   # overwrite existing metadata

Duplicate Detection

SHA-256 ContentHash is stored in the index. New-Snip warns when content already exists.

New-Snip deploy-v2 -IgnoreDuplicate   # suppress duplicate warning

GitHub Gist Integration

Setup

Generate a Personal Access Token at https://github.com/settings/tokens with the gist scope, then:

Set-SnipConfig -GitHubToken ghp_yourTokenHere
Set-SnipConfig -GitHubUser your-github-username

Or via environment variable:

$env:PSSNIPS_GITHUB_TOKEN = 'ghp_yourTokenHere'
$env:PSSNIPS_GITHUB_USER  = 'your-github-username'

Commands

Get-GistList                                     # list your gists
Get-GistList deploy                              # filter by name
Get-Gist abc123def456                            # view a gist
Import-Gist abc123def456                         # import as local snippet
Import-Gist abc123def456 -Name my-local-name
Export-Gist deploy                               # push local snippet to Gist
Export-Gist deploy -Public                       # public gist
Invoke-Gist abc123def456                         # run a gist without importing
Sync-Gist deploy                                 # pull latest from GitHub
Sync-Gist deploy -Push                           # push local → GitHub

GitLab Snippet Integration

Setup

Generate a GitLab Personal Access Token with api scope, then:

Set-SnipConfig -GitLabToken glpat_yourTokenHere
Set-SnipConfig -GitLabUrl 'https://gitlab.example.com'   # for self-hosted instances

Or via environment variables:

$env:PSSNIPS_GITLAB_TOKEN = 'glpat_yourTokenHere'
$env:PSSNIPS_GITLAB_URL   = 'https://gitlab.example.com'

Commands

Get-GitLabSnipList
Get-GitLabSnip <id>
Import-GitLabSnip <id>
Export-GitLabSnip deploy

Bitbucket Snippet Integration

Get-BitbucketSnipList
Import-BitbucketSnip <id>
Export-BitbucketSnip deploy
Sync-BitbucketSnips

Team Shared Storage

Share snippets via a UNC path or any local/network directory.

Set-SnipConfig -SharedSnippetsDir '\\server\share\snippets'

Publish-Snip deploy               # copy to shared dir, updates shared-index.json
Sync-SharedSnips                  # pull from shared dir into local index
Get-Snip -Shared                  # list snippets from the shared store

Configuration

PSSnips resolves settings in this priority order (highest wins):

Layer	Source	Description
1	Environment variables	Per-session or CI/CD overrides
2	Workspace config	`.pssnips\config.json` in cwd; can be committed
3	User config	`~\.pssnips\config.json`; written by `Set-SnipConfig`
4	Module defaults	Built-in fallbacks

Environment Variables

Variable	Description
`PSSNIPS_DIR`	Override the snippets storage directory
`PSSNIPS_EDITOR`	Default editor (`edit`, `nvim`, `code`, `notepad`)
`PSSNIPS_DEFAULT_LANG`	Default language extension for new snippets
`PSSNIPS_GITHUB_TOKEN`	GitHub PAT for Gist integration
`PSSNIPS_GITHUB_USER`	GitHub username
`PSSNIPS_GITLAB_TOKEN`	GitLab PAT
`PSSNIPS_GITLAB_URL`	GitLab base URL (self-hosted)
`PSSNIPS_SHARED_DIR`	Shared snippets UNC/local path
`PSSNIPS_WORKSPACE`	Path to workspace root (overrides cwd detection)

Workspace Config

Place .pssnips\config.json in your project root. Commit it to source control to share settings with your team.

Set-SnipConfig -Scope Workspace -DefaultLang ps1 -Editor nvim

{
  "defaultLang": "ps1",
  "editor": "nvim"
}

User Config

Set-SnipConfig -Editor nvim
Set-SnipConfig -DefaultLang py
Set-SnipConfig -SnippetsDir 'D:\MySnippets'
Set-SnipConfig -ConfirmDelete $false

Get-SnipConfig               # show resolved config
Get-SnipConfig -ShowSources  # show which layer each value came from

Event Hooks

Register scriptblock handlers that fire on snippet lifecycle events.

Register-SnipEvent -Event <name> -Handler { param($e) ... }   # returns registration Id
Unregister-SnipEvent -Event <name> -Id <id>

Available Events

Event	Extra Keys in `$e`
`SnipCreated`	—
`SnipEdited`	—
`SnipDeleted`	—
`SnipExecuted`	`Duration`
`SnipPublished`	`Provider`, `Url`

Example: Audit Log in $PROFILE

# Log all executions to a file
Register-SnipEvent -Event SnipExecuted -Handler {
    param($e)
    "[$(Get-Date -f s)] Executed '$($e.Name)' in $($e.Duration.TotalSeconds)s" |
        Add-Content "$HOME\snip-audit.log"
}

Example: Slack Webhook Notification

# Post to Slack when a snippet is published
Register-SnipEvent -Event SnipPublished -Handler {
    param($e)
    $body = @{ text = "📦 Snippet *$($e.Name)* published to $($e.Provider): $($e.Url)" } | ConvertTo-Json
    Invoke-RestMethod -Uri $env:SLACK_WEBHOOK_URL -Method Post -Body $body -ContentType 'application/json'
}

Handlers added in $PROFILE persist across sessions. Use Unregister-SnipEvent to remove them.

Editor Priority

PSSnips selects the first available editor:

Priority	Editor	Command	Notes
1	Microsoft Edit	`edit.exe`	Built-in terminal editor (Windows 11 24H2+)
2	Neovim	`nvim`
3	VS Code	`code`
4	Notepad	`notepad`	Always available fallback

Override per-command: Edit-Snip deploy -Editor code
Override permanently: Set-SnipConfig -Editor nvim

Data Layout

~\.pssnips\
├── config.json          # user config
├── index.json           # snippet metadata + run history
├── audit.json           # audit log
├── snippets\            # snippet files (any extension)
│   ├── deploy.ps1
│   └── parse-csv.py
└── history\             # timestamped version backups per snippet
    └── deploy\
        └── 20260101120000.ps1

Workspace config (per-project, optional — safe to commit):

<project root>\
└── .pssnips\
    └── config.json      # workspace overrides

Contributing

Fork the repository and create a feature branch.
Follow the existing module structure (Public\, Private\, PSSnips.psd1).
Run Test-Snip and PSScriptAnalyzer before submitting a PR.
Open a pull request against main — please reference any related issue.

Name		Name	Last commit message	Last commit date
Latest commit History 31 Commits
.github		.github
Private		Private
Public		Public
docs		docs
en-US		en-US
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
PSScriptAnalyzerSettings.psd1		PSScriptAnalyzerSettings.psd1
PSSnips.Format.ps1xml		PSSnips.Format.ps1xml
PSSnips.Tests.ps1		PSSnips.Tests.ps1
PSSnips.psd1		PSSnips.psd1
PSSnips.psm1		PSSnips.psm1
README.md		README.md
ROADMAP.md		ROADMAP.md
SECURITY.md		SECURITY.md
Split-Module.ps1		Split-Module.ps1
image.png		image.png

Folders and files

Latest commit

History

Repository files navigation

PSSnips — Terminal-First PowerShell Snippet Manager

Requirements

Quick Start

What's New in v2.0

Installation

PowerShell Gallery (recommended)

Manual

Commands Reference

Interactive TUI

Core Snippet Commands

Tag Management

Execution

Supported Runners

Templates

Versioning & History

Backup & Restore

Analytics & Maintenance

Ratings & Comments

Fuzzy Finder

Scheduling

Profile & Terminal Integration

PowerShell CBH Metadata Integration

Duplicate Detection

GitHub Gist Integration

Setup

Commands

GitLab Snippet Integration

Setup

Commands

Bitbucket Snippet Integration

Team Shared Storage

Configuration

Environment Variables

Workspace Config

User Config

Event Hooks

Available Events

Example: Audit Log in $PROFILE

Example: Slack Webhook Notification

Editor Priority

Data Layout

Contributing

License

About

Resources

License

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages