https://github.com/obselate/poshblox
Visual powershell node graph scripting
https://github.com/obselate/poshblox
nodegraph powershell powershell-cmdlets powershell-script powershell-scripts pwsh visual
Last synced: 26 days ago
JSON representation
Visual powershell node graph scripting
- Host: GitHub
- URL: https://github.com/obselate/poshblox
- Owner: obselate
- License: agpl-3.0
- Created: 2026-02-13T07:24:08.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-15T13:20:43.000Z (28 days ago)
- Last Synced: 2026-04-15T13:36:57.292Z (28 days ago)
- Topics: nodegraph, powershell, powershell-cmdlets, powershell-script, powershell-scripts, pwsh, visual
- Language: C#
- Homepage:
- Size: 1.78 MB
- Stars: 53
- Watchers: 0
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
A visual node-graph editor for building PowerShell scripts. Drag, connect, run.
---
## What is PoSHBlox?
PoSHBlox lets you visually compose PowerShell scripts by wiring together
nodes on a canvas. Each node is a cmdlet, control-flow block, or custom
script fragment; connections define the pipeline. Preview the generated
script, run it, or export a clean `.ps1`.
### Features
- 85+ built-in cmdlet templates across 12 categories
- Control-flow containers: If/Else, ForEach, Try/Catch, While, Functions, Labels (nestable)
- Live script preview and one-click Run (prefers pwsh 7+, falls back to Windows PowerShell 5.1)
- Pipeline-aware codegen: chains pipes, assigns variables at branch points, detects cycles
- Import cmdlets from installed modules to extend the palette
- Keyboard shortcuts, dark theme, pan/zoom canvas with Bezier wires
## Get it
### Download a prebuilt release (recommended)
Grab the latest `.zip` from **[Releases](../../releases)**. No .NET install
required — the `.exe` is self-contained. Extract, run `PoSHBlox.exe`.
Every push to every branch also publishes a rolling pre-release
(`Branch build: `) and a 30-day artifact on the
[Actions](../../actions/workflows/build.yml) run page.
### Build from source
Requires the [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0).
```bash
git clone https://github.com/obselate/PoSHBlox.git
cd PoSHBlox
dotnet run
```
## How it works
1. **Add nodes** from the palette (press `P`)
2. **Connect** output ports to input ports by dragging wires
3. **Configure** parameters in the right-side properties panel
4. **Preview** (`Alt+S`), **Run** (`F5`), or **Export** (`Ctrl+E`) as `.ps1`
Press `?` any time for the full keyboard cheatsheet.
## Regenerating the built-in catalogs
The fastest way to add cmdlets is **+ Import** in the palette — pick an
installed module and PoSHBlox introspects it into a Custom template set.
The shipped `Templates/Builtin/*.json` can be rebuilt from
`scripts/builtin-catalog.json` (the reference manifest of modules and
cmdlets per category). Curated per-parameter defaults are preserved
across runs.
```powershell
# Pipe to Out-Host so the WinExe flushes output to the shell.
.\bin\Debug\net10.0\PoSHBlox.exe --regen-manifest scripts\builtin-catalog.json 2>&1 | Out-Host
# Dry-run to preview:
.\bin\Debug\net10.0\PoSHBlox.exe --regen-manifest scripts\builtin-catalog.json --dry-run 2>&1 | Out-Host
```
## License
GNU AGPL v3 — see [LICENSE](LICENSE)