PsBash

Author(s)

• Andy Brummer

Tags

bash linux cross-platform cli grep awk sed jq pipeline typed-objects powershell-module devops unix shell commands windows macos

Functions

Compare-Version Complete-BashBgJob ConvertFrom-AwkProgram ConvertFrom-BashArgs ConvertFrom-HumanNumeric ConvertFrom-MonthName ConvertFrom-SimpleYaml ConvertFrom-YamlValue ConvertTo-BrowseRow ConvertTo-JqJson ConvertTo-PermissionString ConvertTo-SimpleYaml Disable-BashHookPrompt Emit-BashLine Enable-BashHookPrompt Expand-AwkString Expand-EscapeSequences Find-JqBranchKeyword Find-JqKeyword Find-JqTopLevelChar Find-JqTopLevelStr Format-AwkPrintf Format-BashDate Format-BashSize Format-LsGrid Format-LsLine Format-PsAuxLine Format-PsCustomLine Get-BashBgRunspacePool Get-BashFileInfo Get-BashItem Get-BashLsProviderEntries Get-BashPlatform Get-BashText Get-BrowseDisplayProperties Get-BrowseTargetText Get-DotNetProcEntry Get-JqMatchingBracket Get-LinuxProcEntry Get-LsDisplayName Get-LsEntryFromFsi Get-LsEntryFromPsItem Initialize-BrowseAdapters Invoke-AwkAction Invoke-BashAwk Invoke-BashBackground Invoke-BashBg Invoke-BashEcho Invoke-BashFg Invoke-BashJobs Invoke-BashKill Invoke-BashRedirect Invoke-BashSed Invoke-BashWait Invoke-BrowseAction Invoke-BrowseCommand Invoke-BrowseInteractive Invoke-JqFilter Invoke-JqIf Invoke-JqRecurse Invoke-JqSelect Invoke-ProcessSub Invoke-ProcessSubPipeline Invoke-ProcessSubString New-BashObject New-BrowseAction New-BrowseAdapter New-BrowseBinding New-BrowseSafetyPreview New-FlagDefs Open-BashFileReader Read-AwkBlock Read-BashFileBytes Read-BashFileLines Read-BashFileRaw Read-BashFileStreaming Register-BashCompletions Register-BashLsProvider Resolve-AwkExpression Resolve-AwkStringFunc Resolve-BashGlob Resolve-BrowseAdapter Resolve-JqDotPath Resolve-JqStringInterpolation Set-BashDisplayProperty Set-BashErrorMode Show-BashHelp Split-AwkFields Split-AwkFuncArgs Split-AwkStatements Split-JqComma Split-JqPipe Test-AwkPattern Test-BashCondition Test-BashHelpFlag Test-BrowseCommandRequiresConfirmation Write-BashError Write-BashFileRaw Write-BashFileText Write-BashHostStderr

PSEditions

Core

Dependencies

This module has no dependencies.

Release Notes

v0.10.4: Fix two bash-tokenization gaps. (1) A # in the middle of a word was wrongly treated as a comment, so abc#def and URLs like http://x/p#section lost everything from the #. (2) Bracket/quote scanning was not quote-aware, so a ) inside a string closed a $(...) early and a $(...) inside double quotes terminated at the wrong quote — e.g. echo $(grep ")" f) and echo "$(echo "hi")" mangled. The lexer now uses one set of mutually-recursive, quote-aware region scanners, and the parser reuses them instead of its own duplicate copies. v0.10.3: Fix heredoc body corruption. A here-document body was rebuilt by space-joining lexer tokens, so punctuation was mangled (best-ranked (score-desc, newest-first) became best-ranked ( score-desc, newest-first )), runs of whitespace collapsed, and lines beginning with # were dropped as comments. This broke piping multi-line text (e.g. git commit messages) through ps-bash. Heredoc bodies are now sliced verbatim from the original source. v0.10.2: Interactive Ctrl-R history search now collapses duplicate command strings. History stores one row per invocation, so re-running the same command filled the reverse-i-search list with repeats; the search now shows one row per unique command, keeping the best-ranked (most recent / CWD-matching) occurrence. v0.10.1: Fix Claude Code Bash-tool integration. A multi-variable bare assignment in a && / || chain (e.g. the TEMP/TMP env-setup Claude Code prepends to every command) emitted [void]($env:A = ..; $env:B = ..), which PowerShell rejects ("Missing closing )") — so every Bash-tool command failed with "ps-bash: parse error". The emitter now uses [void]$(...) for multi-statement assignments. Regression coverage: BashTranspilerTests, ShellArgsTests, an end-to-end launcher test, and a PowerShell parse-oracle over the wrapper shapes. v0.10.0: Interactive shell features. AI command assist (Ctrl-^) turns a natural-language prompt into a reviewed shell command via an external AI CLI, with a dangerous-command safety classifier (now also flags Invoke-Expression / iex). New opt-in compact-output mode (--compact-output / PSBASH_COMPACT_OUTPUT) replaces raw output with a bounded digest for agent contexts. Completion parameter-value rows now split on the ASCII unit separator so ValidateSet values containing a pipe are no longer truncated. v0.9.13: Fix broken module install. Install-Module PsBash now bundles PsBash.Cmdlets.dll (and its PsBash.Transpiler.dll / Parlot.dll deps) so a plain Install-Module PsBash is self-contained. Previously the registered aliases (ls, cat, grep, ...) resolved to binary cmdlets that were never loaded ("Invoke-BashLs is not recognized"); the module now warns instead of failing silently if the binary companion is absent. v0.9.12: Interactive shell fixes. Auto-loadable PowerShell aliases (tnc, gip) now resolve in the host runspace, and the interactive line editor no longer redraws erratically after launching a node-based GUI CLI such as code. Full version history: https://github.com/standardbeagle/ps-bash/releases