PowerShell
diff --git a/‎README.md‎
Lines changed: 10 additions & 11 deletions b/‎README.md‎
Lines changed: 10 additions & 11 deletions
diff --git a/‎docs/Microsoft.PowerShell.ConsoleGuiTools/Out-ConsoleGridView.md‎
Lines changed: 109 additions & 32 deletions b/‎docs/Microsoft.PowerShell.ConsoleGuiTools/Out-ConsoleGridView.md‎
Lines changed: 109 additions & 32 deletions
@@ -1,6 +1,6 @@
-# ConsoleGuiTools - `Out-ConsoleGridView`, `Out-ConsoleTableView`, and `Show-ObjectTree`
+# ConsoleGuiTools - `Out-ConsoleGridView` and `Show-ObjectTree`
 
-This repo contains the `Out-ConsoleGridView`, `Out-ConsoleTableView`, and `Show-ObjectTree`
+This repo contains the `Out-ConsoleGridView` and `Show-ObjectTree`
 PowerShell Cmdlets providing console-based GUI experiences based on
 [Terminal.Gui (gui.cs)](https://github.com/gui-cs/Terminal.Gui).
 
@@ -14,8 +14,7 @@ Install-Module Microsoft.PowerShell.ConsoleGuiTools
 
 ## Features
 
-* [`Out-ConsoleGridview`](docs/Microsoft.PowerShell.ConsoleGuiTools/Out-ConsoleGridView.md) - Send objects to a grid view window for interactive filtering and sorting.
-* [`Out-ConsoleTableView`](docs/Microsoft.PowerShell.ConsoleGuiTools/Out-ConsoleTableView.md) - Send objects to a table view with column headers, horizontal scrolling, streaming, and native multi-selection.
+* [`Out-ConsoleGridView`](docs/Microsoft.PowerShell.ConsoleGuiTools/Out-ConsoleGridView.md) - Send objects to an interactive table view with column headers, horizontal scrolling, streaming, sorting, and native multi-selection.
 * [`Show-ObjectTree`](docs/Microsoft.PowerShell.ConsoleGuiTools/Show-ObjectTree.md) - Send objects to a tree view window for interactive filtering and sorting.
 
 * Cross-platform - Works on any platform that supports PowerShell 7.2+.
@@ -130,21 +129,21 @@ This command gets the processes running on the local computer and sends them to
 
 Use right arrow when a row has a `+` symbol to expand the tree. Left arrow will collapse the tree.
 
-### Example 9: Output processes to a table view
+### Example 9: Output processes to a grid view with streaming
 
 ```PowerShell
-Get-Process | Out-ConsoleTableView
+Get-Process | Out-ConsoleGridView
 ```
 
-This command gets the processes running on the local computer and sends them to a table view with column headers. The table appears as soon as the first object arrives — rows stream in as the pipeline executes.
+This command gets the processes running on the local computer and sends them to an interactive table with column headers. The table appears as soon as the first object arrives — rows stream in as the pipeline executes.
 
-### Example 10: Search for a specific row in the table view
+### Example 10: Search for a specific row in the grid view
 
 ```PowerShell
-Get-Service | octv -Search "wuauserv" -Focus Filter
+Get-Service | ocgv -Search "wuauserv" -Focus Filter
 ```
 
-This command displays all services in a table view, positions the cursor on the first row matching "wuauserv", and starts with focus in the filter field.
+This command displays all services in a grid view, positions the cursor on the first row matching "wuauserv", and starts with focus in the filter field.
 
 ## Development
 
@@ -220,7 +219,7 @@ to learn more.
 
 `ConsoleGuiTools` consists of 2 .NET Projects:
 
-* ConsoleGuiTools - Cmdlet implementation for Out-ConsoleGridView, Out-ConsoleTableView, and Show-ObjectTree
+* ConsoleGuiTools - Cmdlet implementation for Out-ConsoleGridView and Show-ObjectTree
 * OutGridView.Models - Contains data contracts between the GUI & Cmdlet
 
 _Note:_ Previously, this repo included `Microsoft.PowerShell.GraphicalTools` which included the Avalonia-based `Out-GridView` (implemented in `.\Microsoft.PowerShell.GraphicalTools` and `.\OutGridView.Gui`). These components have been deprecated (see note above).
 
@@ -3,7 +3,7 @@ external help file: ConsoleGuiToolsModule.dll-Help.xml
 keywords: powershell,cmdlet
 locale: en-us
 Module Name: Microsoft.PowerShell.ConsoleGuiTools
-ms.date: 08/24/2022
+ms.date: 05/04/2026
 schema: 2.0.0
 title: Out-ConsoleGridView
 ---
@@ -12,24 +12,25 @@ title: Out-ConsoleGridView
 
 ## SYNOPSIS
 
-Sends output to an interactive table in the same console window.
+Sends output to an interactive table view with column headers, horizontal scrolling, sorting, and streaming support.
 
 ## SYNTAX
 
 ```PowerShell
  Out-ConsoleGridView [-InputObject <psobject>] [-Title <string>] [-OutputMode {None | Single |
-    Multiple}] [-Filter <string>] [-MinUi] [-Driver <string>] [-FullScreen] [<CommonParameters>]
+    Multiple}] [-Filter <string>] [-Search <string>] [-Focus {Table | Filter}] [-MinUI]
+    [-FullScreen] [-Driver <string>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
 
-The **Out-ConsoleGridView** cmdlet sends the output from a command to a grid view window where the output is displayed in an interactive table.
+The **Out-ConsoleGridView** cmdlet sends the output from a command to a grid view window where the output is displayed in an interactive table with column headers, column sizing, horizontal scrolling, and column sorting.
 
-Use the Filter box at the top of the window to search the text in the table. Search for text in a particular column, search for literals, and search for multiple words. Use the `-Filter` parameter to pre-populate the Filter box. The filter uses regular expressions.
+Use the Filter box at the top of the window to search the text in the table using regular expressions. Unlike the Filter, the `-Search` parameter positions the cursor on the first matching row without hiding non-matching rows.
 
-For instructions for using these features, type `Get-Help Out-ConsoleGridView -Full` and see How to Use the Grid View Window Features in the Notes section.
+Objects are streamed into the table as they arrive from the pipeline — the UI appears immediately and rows are added incrementally. A spinner in the status bar indicates loading is in progress.
 
-To send items from the interactive window down the pipeline, click to select the items (either the the mouse in terminals that support mouse or the `SPACE` key) and then press `ENTER`. `ESC` cancels.
+To send items from the interactive window down the pipeline, select rows (use arrow keys and `SPACE` or click with the mouse) and then press `ENTER`. Press `ESC` to cancel without output. Use `Ctrl+A` to select all rows, or `Ctrl+D` to deselect all. Click column headers to sort.
 
 ## EXAMPLES
 
@@ -39,7 +40,7 @@ To send items from the interactive window down the pipeline, click to select the
 Get-Process | Out-ConsoleGridView
 ```
 
-This command gets the processes running on the local computer and sends them to a grid view window.
+This command gets the processes running on the local computer and sends them to a grid view window with column headers for each property. The table appears as soon as the first object arrives — rows stream in as the pipeline executes.
 
 ### Example 2: Use a variable to output processes to a grid view
 
@@ -54,7 +55,7 @@ The first command uses the Get-Process cmdlet to get the processes on the comput
 
 The second command uses a pipeline operator to send the $P variable to **Out-ConsoleGridView**.
 
-By specifying `-OutputMode Single` the grid view window will be restricted to a single selection, ensuring now more than a single object is returned.
+By specifying `-OutputMode Single` the grid view window will be restricted to a single selection, ensuring no more than a single object is returned.
 
 ### Example 3: Display a formatted table in a grid view
 
@@ -109,7 +110,7 @@ killp note
 ```
 This example shows defining a function named `killp` that shows a grid view of all running processes and allows the user to select one to kill it.
 
-The example uses the `-Filter` parameter to filter for all proceses with a name that includes `note` (thus highlighting `Notepad` if it were running. Selecting an item in the grid view and pressing `ENTER` will kill that process. 
+The example uses the `-Filter` parameter to filter for all processes with a name that includes `note` (thus highlighting `Notepad` if it were running). Selecting an item in the grid view and pressing `ENTER` will kill that process.
 
 ### Example 7: Pass multiple items through Out-ConsoleGridView
 
@@ -130,14 +131,61 @@ Press `F7` to see the history for the current PowerShell instance
 
 Press `Shift-F7` to see the history for all PowerShell instances.
 
-Whatever you select within `Out-ConsoleGridView` will be inserted on your command line. 
+Whatever you select within `Out-ConsoleGridView` will be inserted on your command line.
 
 Whatever was typed on the command line prior to hitting `F7` or `Shift-F7` will be used as a filter.
 
+### Example 9: Search for a row without filtering
+
+```PowerShell
+Get-Service | ocgv -Search "wuauserv"
+```
+
+This command displays all services but positions the cursor on the first row matching "wuauserv". Unlike `-Filter`, all rows remain visible.
+
+### Example 10: Start with focus on the filter field
+
+```PowerShell
+Get-ChildItem | ocgv -Focus Filter
+```
+
+This command opens the grid view with the cursor in the filter text field, ready to type a filter immediately. Pressing `ENTER` while in the filter field accepts the currently selected item(s).
+
+### Example 11: Full screen mode with a custom title
+
+```PowerShell
+Get-Process | ocgv -FullScreen -Title "Process Monitor"
+```
+
+This command runs the grid view in full-screen mode using the alternate screen buffer, with a custom window title.
+
+### Example 12: Minimal UI for scripting
+
+```PowerShell
+Get-Process | ocgv -MinUI -OutputMode Single
+```
+
+This command shows the grid view with no window frame, filter box, or status bar — just the table. Useful for quick selection in scripts.
+
 ## PARAMETERS
 
 ### -Filter
-Pre-populates the Filter edit box, allowing filtering to be specified on the command line.
+Pre-populates the Filter edit box, hiding rows that do not match the regular expression pattern.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Search
+Positions the cursor on the first row matching this regular expression pattern. Unlike `-Filter`, non-matching rows remain visible.
 
 ```yaml
 Type: String
@@ -151,12 +199,31 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -Focus
+Specifies which UI element receives initial focus.
+
+- **Table** (default): The table view receives focus. Use arrow keys to navigate immediately.
+- **Filter**: The filter text field receives focus. Start typing to filter. Press `ENTER` to accept the selected item(s).
+
+```yaml
+Type: FocusTarget
+Parameter Sets: (All)
+Aliases:
+Accepted values: Table, Filter
+
+Required: False
+Position: Named
+Default value: Table
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -InputObject
 Specifies that the cmdlet accepts input for **Out-ConsoleGridView**.
 
 When you use the **InputObject** parameter to send a collection of objects to **Out-ConsoleGridView**, **Out-ConsoleGridView** treats the collection as one collection object, and it displays one row that represents the collection.
 
-To display the each object in the collection, use a pipeline operator (|) to send objects to **Out-ConsoleGridView**.
+To display each object in the collection, use a pipeline operator (|) to send objects to **Out-ConsoleGridView**.
 
 ```yaml
 Type: PSObject
@@ -174,13 +241,13 @@ Accept wildcard characters: False
 Specifies the items that the interactive window sends down the pipeline as input to other commands.
 By default, this cmdlet generates zero, one, or many items.
 
-To send items from the interactive window down the pipeline, click to select the items (either the the mouse in terminals that support mouse or the `SPACE` key) and then press `ENTER`. `ESC` cancels.
+To send items from the interactive window down the pipeline, select items and press `ENTER`. `ESC` cancels.
 
 The values of this parameter determine how many items you can send down the pipeline.
 
-- None. No items. 
-- Single.  Zero items or one item. Use this value when the next command can take only one input object.
-- Multiple.  Zero, one, or many items.  Use this value when the next command can take multiple input objects. This is the default value.
+- None. No items.
+- Single. Zero items or one item. Use this value when the next command can take only one input object.
+- Multiple. Zero, one, or many items. Use this value when the next command can take multiple input objects. This is the default value.
 
 ```yaml
 Type: OutputModeOption
@@ -212,8 +279,8 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-### -MinUi
-If specified no title or status bar will be displayed in the **Out-ConsoleGridView** window. The filter will only be displayed if `-Filter` is specified.
+### -MinUI
+If specified, no window frame, filter box, or status bar will be displayed. The table is shown without chrome.
 
 ```yaml
 Type: SwitchParameter
@@ -228,22 +295,22 @@ Accept wildcard characters: False
 ```
 
 ### -Driver
-Sets the Terminal.Gui driver to use. Valid values are `ansi`, `windows`, or `unix`. The default is `ansi`.
+Sets the Terminal.Gui driver to use. Valid values are `ansi`, `windows`, or `unix`.
 
 ```yaml
 Type: String
 Parameter Sets: (All)
-Aliases:
+Aliases: ForceDriver
 
 Required: False
 Position: Named
-Default value: ansi
+Default value: None
 Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
 ### -FullScreen
-If specified, the application runs in full-screen mode using the alternate screen buffer. By default, the application renders inline.
+If specified, the application runs in full-screen mode using the alternate screen buffer. By default, the application renders inline in the current terminal.
 
 ```yaml
 Type: SwitchParameter
@@ -258,30 +325,40 @@ Accept wildcard characters: False
 ```
 
 ### CommonParameters
-This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
 
 ## INPUTS
 
 ### System.Management.Automation.PSObject
 
-You can send any object to this cmdlet.
+You can send any object to this cmdlet. Objects are streamed — the UI appears as soon as the first object arrives.
 
 ## OUTPUTS
 
 ### System.Object
 
-By default `Out-ConsoleGridView` returns objects representing the selected rows to the pipeline. Use `-OutputMode` to change this behavior.
+By default **Out-ConsoleGridView** returns objects representing the selected rows to the pipeline. Use `-OutputMode` to change this behavior.
 
 ## NOTES
 
-* The command output that you send to **Out-ConsoleGridView** should not be formatted, such as by using the Format-Table or Format-Wide cmdlets. To select properties, use the Select-Object cmdlet.
+* **Out-ConsoleGridView** uses Terminal.Gui's `TableView` control which provides column headers, column sizing, horizontal scrolling, column sorting, and native multi-row selection.
 
-* Deserialized output from remote commands might not be formatted correctly in the grid view window.
+* The alias for **Out-ConsoleGridView** is `ocgv`.
 
-## RELATED LINKS
+* Objects are streamed into the table as they arrive from the pipeline. The UI appears immediately on the first object and rows are added incrementally. A spinner in the status bar indicates loading is in progress.
 
-[Out-File](Out-File.md)
+* The command output that you send to **Out-ConsoleGridView** should not be formatted, such as by using the Format-Table or Format-Wide cmdlets. To select properties, use the Select-Object cmdlet.
+
+* Keyboard shortcuts:
+  - `ENTER` — Accept selection and close
+  - `ESC` — Cancel and close
+  - `Ctrl+A` — Select all rows (when OutputMode is Multiple)
+  - `Ctrl+D` — Deselect all rows (when OutputMode is Multiple)
+  - `Home`/`End` — Jump to first/last row
+  - Arrow keys — Navigate rows and columns
+  - `Tab` — Move focus between filter and table
+  - Click column headers — Sort by that column
 
-[Out-Printer](Out-Printer.md)
+## RELATED LINKS
 
-[Out-String](Out-String.md)
+[Show-ObjectTree](Show-ObjectTree.md)