Tools / PSForge

Utility

PSForge

Name: PSForge
Author: Swatto

Small, sharp, no nonsense.

A Tauri desktop PowerShell editor built for the paste-run-debug loop: clean AI- or web-copied scripts, run with F5 against PowerShell 5.1 or 7, and copy a Markdown debug bundle of output, exit code, and PSScriptAnalyzer findings straight back into the chat.

↓ Download ★ Source on GitHub

TypeScriptRustTauri WindowsmacOSLinux portable exe

Deploy.ps1Invoke-Remote.ps1README.md

1param($ComputerName)

3$s = New-PSSession -ComputerName $ComputerName

4Invoke-Command -Session $s {

5 Get-Service -Name 'WinRM'

6}

7Copy-PSForgeDebugBundle -Session $s

PS> F5 · PSScriptAnalyzer: 0 errors, 1 warning · Exit code: 0 · output copied to debug bundle

01 How it works

Under the hood

Cleans pasted AI/web scripts

Paste Clean + Format (Ctrl+Shift+Alt+V) strips markdown fences, PS> prompts, and smart quotes from copied text so the script runs without hand-editing.

Runs against PS 5.1 or 7 with a PSSA gate

Detects installed Windows PowerShell 5.1 and PowerShell 7 hosts and gates F5 on PSScriptAnalyzer findings via a configurable warn/block run gate.

Emits a one-click debug bundle

Copy Debug Bundle produces a single Markdown block with script text, terminal output, exit code, and analyzer problems for pasting into a ticket or AI thread.

02 Requirements / install

Operating system

WindowsmacOSLinux

Distribution Single portable .exe — no installer, no admin rights required.

Dependencies None. Runs offline, zero telemetry.

Licence MIT · free forever

The real PowerShell workflow, most of the time, is: paste a script someone handed you, run it, read the error, fix one line, run it again. PSForge is built around that loop — a Monaco editor, an integrated terminal, F5 to run, PSScriptAnalyzer telling you what’s wrong before you run it, and one-click debug bundles for the chat or ticket where the script came from. No VS Code, no profile gymnastics, just the loop.

What it is for

PSForge is tuned for this workflow:

Paste a PowerShell script from chat, docs, Teams, or a web page.
Clean and format the pasted text.
Run with F5.
Read terminal output and analyzer problems.
Copy a debug bundle, last run, or full output back into a ticket or assistant conversation.
Iterate.

The default layout gives the terminal a large part of the window so run output is easy to read.

What it does

Multi-tab PowerShell editor with Monaco.
Integrated PowerShell terminal.
PowerShell 5.1 and PowerShell 7 detection/selection.
F5 run, F8 run selection/current line, Shift+F5 stop.
Paste Clean + Format.
Cleanup summaries after paste.
PSScriptAnalyzer problem view and run gate.
Scratch auto-save for untitled scripts.
Recent runs with working directory restore.
Copy Debug Bundle, Copy Last Run, and Copy Output.
In-app AI assistant for Ask, Write, and Fix using Anthropic API, Claude CLI, OpenRouter, or Kilo CLI; it can also be disabled completely.
Module browser, Show Command, context help, snippets, command palette, and Explain Selection.
Optional debugger with breakpoints, step, and watch.
Script signing, print, file associations, and profile access.

Install

Download the latest installer from:

https://github.com/Swatto86/psforge/releases

Current published release: v1.4.20.

Platform	Artifacts
Windows	portable `.exe`, `.msi`, setup `.exe`
macOS	Universal `.dmg`
Linux	`.deb`, `.rpm`, AppImage

The in-app updater checks GitHub Releases on startup unless disabled in Settings.

Recommended first-use settings

Open Settings and enable Assistant mode if you want paste-run-debug defaults in one toggle. It configures the editor for cleaned paste, scratch save, clear terminal before run, and analyzer-aware execution.

Useful settings:

Setting	Suggested value
Clean Paste	On
Run after Paste Clean + Format	On if you want one-gesture execution
Run when Ctrl+V was cleaned	Off to avoid accidental execution on small edits
Save before F5	On
Auto-save untitled to scratch	On
Clear terminal before run	On
PSSA run gate	Warn
Working directory	File folder or pinned preset

Project-level .psforge.json can define working directory and analyzer behavior next to scripts.

Keyboard shortcuts

Keys	Action
`Ctrl+Shift+Alt+V`	Paste Clean + Format
`Ctrl+V`	Normal paste with cleanup when enabled
`F5`	Run script, or debug when breakpoints exist
`F8`	Run selection or current line
`Shift+F5`	Stop
`Ctrl+Shift+P`	Command palette
`Ctrl+Shift+E`	Explain selection with AI
`Ctrl+F1`	Shortcut list
`Ctrl+J`	Snippets

Debug bundle workflow

Use Copy Debug Bundle when asking for help. It copies a Markdown bundle containing script text, terminal output, exit code, and PSScriptAnalyzer problems. You can also copy the last F5 run or the full terminal output. This is faster and less error-prone than copying each pane separately.

Tech stack

Frontend: React 19, TypeScript, Vite, Monaco, xterm.js, Tailwind 4.
Desktop: Tauri 2 and Rust.
PowerShell host: script run, debug, PSScriptAnalyzer, and IntelliSense workflows.

Build from source

git clone https://github.com/Swatto86/psforge.git
cd psforge
npm ci
npm run tauri dev

Quality/build commands:

npm test
npm run build
npm run tauri build

Troubleshooting

F5 runs from the wrong directory

Set the working directory mode in Settings or add a .psforge.json file beside the script.

PSScriptAnalyzer blocks or warns

Open the Problems panel. Fix the reported issues, or change the PSSA run gate when you intentionally want warning-only behavior.

Pasted script contains prompts or markdown fences

Use Ctrl+Shift+Alt+V to clean and format pasted content.