PSForge is a desktop PowerShell editor built with Tauri, React, and Monaco Editor. It is tuned for a fast loop: paste script from an AI or the web → clean → format → F5 → read output → paste results back for debugging.
The default layout keeps the integrated terminal large (~72% of the vertical space) so run output is easy to read without resizing panes.
Pre-built installers are published on GitHub Releases. The in-app updater checks the same feed on startup (Settings → can disable).
| Platform | Artifacts |
|---|---|
| Windows | .msi, setup .exe |
| macOS | Universal .dmg |
| Linux | .deb, .rpm, AppImage |
Current version:1.4.21
Typical use with an assistant writing PowerShell for you:
- Get script — Copy a fenced
powershellblock (or plain script) from chat, docs, or Teams. - Paste into PSForge — Use one of:
- Welcome → Paste from clipboard — New untitled tab, clean, format, optional run.
Ctrl+Shift+Alt+V— Paste Clean + Format on the active tab (best default for AI output).Ctrl+V— Normal paste with light cleanup when Clean Paste is enabled (Settings → Editor).
- Run —
F5(auto-save + scratch for untitled tabs when enabled). - Inspect — Terminal output below the editor; Reference → Problems for PSScriptAnalyzer errors.
- Share back — Copy Debug Bundle (markdown: output + exit code + PSSA + script), Copy Last Run, or full Copy Output; paste into the AI thread.
- Iterate — Edit, F5 again, or Re-run from Welcome Recent runs (restores working directory).
In Settings → Editor / Execution:
| Setting | Suggested | Why |
|---|---|---|
| Assistant mode (Settings → Execution) | On | Applies all rows below in one toggle |
Clean Paste (Ctrl+V) | On | Fixes smart quotes, markdown fences, PS> prompts from copied terminals |
| Run after Paste Clean + Format | On | One gesture after Ctrl+Shift+Alt+V |
| Run when Ctrl+V was cleaned | Off | Avoid accidental F5 on small edits |
| Save before F5 | On | Untitled scripts land in scratch before run |
| Auto-save untitled → scratch | On | Recovery if the app closes mid-session |
| Clear terminal before run | On | Last run output is unambiguous |
| PSSA run gate | Warn | Block bad runs only when you want strictness |
| Working directory | File or pinned preset | Module paths and .\ relatives behave predictably |
Optional repo file .psforge.json next to your scripts (walks up from opened file):
{
"workingDirMode": "custom",
"customWorkingDir": "C:\\Repo\\scripts",
"pssaRunGate": "warn"
}| Keys | Action |
|---|---|
Ctrl+Shift+Alt+V | Paste Clean + Format (then optional F5 if enabled) |
Ctrl+V | Paste with cleanup when Clean Paste is on |
F5 | Run script (or debug if breakpoints exist) |
F8 | Run selection or current line |
Shift+F5 | Stop |
Ctrl+Shift+P | Command palette (copy debug bundle, output, …) |
Ctrl+Shift+E | Explain selection with AI (popover; also in right-click menu) |
Ctrl+F1 | Full shortcut list |
After paste, a toast summarizes cleanup (fences removed, smart quotes fixed, etc.).
More shortcuts: Help → Keyboard Shortcuts (Ctrl+F1).
- Scratch auto-save — Untitled scripts under
%APPDATA%\PSForge\scratch\{tabId}.ps1(Windows); orphan files offered on startup. - Close untitled tabs — Save as, keep in scratch, or discard.
- PSSA run gate — In-app dialog on warn; block mode stops F5 until Problems are fixed.
- Run directory — Per-file folder, custom path, pinned folder, named presets in Settings.
- Recent runs — Welcome history: re-run, open run folder, clear, failed-run highlight.
- Assistant mode — One setting applies paste/run/scratch/PSSA defaults for AI workflows.
- Paste summary — Toast after cleanup (
Ctrl+Vor Paste Clean + Format). - Copy Debug Bundle — Markdown for AI chat (terminal output, exit code, analyzer errors, script).
- Terminal — Copy full scrollback or last F5 run only; restart session from toolbar.
- Fonts — Editor/terminal presets + status bar quick control.
- Classic File / Edit / View / Help menu bar — every action is discoverable with its shortcut listed
- In-app AI assistant (Ask / Write / Fix) using Anthropic API, Claude CLI, OpenRouter, or Kilo CLI — or turn it off entirely with one switch in Settings → AI ("Copy for AI" keeps working; it's clipboard-only, for external AI chats)
- Multi-tab editor with session restore
- PowerShell 5.1 / 7 detection and selection
- Mandatory
param()prompt before run - Integrated debugger (breakpoints, step, watch) — enable in Settings if needed
- Module browser, Show Command, context help (
F1) - Snippets (
Ctrl+J), command palette, file associations - Script signing, print, open
$PROFILE
- Frontend: React 19, TypeScript, Vite, Monaco, xterm.js, Tailwind 4
- Desktop: Tauri 2 (Rust), PowerShell host for run/debug/PSSA/IntelliSense
- Node.js 18+ (22 in CI)
- Rust stable (
src-tauri/rust-toolchain.toml) - PowerShell (Windows PowerShell and/or PowerShell 7)
- Linux builds: WebKit/GTK dev packages (see
.github/workflows/ci.yml)
npm ci
npm run tauri dev # dev app
npm test# Vitest (sanitize-paste, run-utils)
npm run build # frontend production build
npm run tauri build # desktop installers
./scripts/ci-local.sh # fmt, clippy, tests, build (matches CI)Machine-readable architecture notes for agents: AI_CONTEXT.md.
| Idea | Benefit |
|---|---|
| Problems → Copy all errors | One-click analyzer text for chat |
| Run markers in terminal | Visible --- Run --- / --- Exit N --- boundaries |
CLI launch — psforge script.ps1 | Open a run-ready window from tooling |
| Per-project scratch folders | Isolate untitled AI snippets by repo |