https://github.com/ironmansoftware/restore

Ctrl+Shift+T for PowerShell Terminals
https://github.com/ironmansoftware/restore

powershell

Last synced: about 1 month ago
JSON representation

Ctrl+Shift+T for PowerShell Terminals

• Host: GitHub
• URL: https://github.com/ironmansoftware/restore
• Owner: ironmansoftware
• License: mit
• Created: 2020-09-28T01:59:47.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2020-09-28T02:12:41.000Z (over 4 years ago)
• Last Synced: 2024-08-13T07:05:06.563Z (5 months ago)
• Topics: powershell
• Language: PowerShell
• Homepage:
• Size: 343 KB
• Stars: 12
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• jimsghstars - ironmansoftware/restore - Ctrl+Shift+T for PowerShell Terminals (PowerShell)

README

        
# Restore

Restore saves the state of your terminal so you can restore it the next time you open one. 

![](./example.gif)

## Disclaimer

This is probably not a great idea. Every time you execute a command, this module serializes your location, variables and loaded modules to a CLIXML file. 

## How to use

Install the module. 

```

Install-Module Restore

```

Add it to your profile.

```

Import-Module Restore

```

Restore terminals that you closed previously.

```

Restore-Terminal

```

After restoring a terminal, the following will be restored.

- Location

- Variables

- Modules

## How it works

If you want to use this module, load it into your PowerShell profile. 

```

Import-Module Restore

```

When you import the module, it assigns an event handler to the `AvailabilityChanged` event of the main runspace. 

```

$Host.Runspace.add_AvailabilityChanged({Checkpoint-Terminal})

```

Every time the runspace changes state (like when it completes running a command), it will call `Checkpoint-Terminal`. This will create a hashtable with your session state, serialize it to CLIXML and save it to disk. 

```

$state = @{

    Location = (Get-Location).ToString()

    Variables = Get-Variable -Scope "Global" | ForEach-Object { [PSCustomObject]@{ Name = $_.Name; Value = $_.Value } }

    Modules = Get-Module | ForEach-Object { [PSCustomObject]@{ Name = $_.Name; Path = $_.Path } }

}

Start-Job -ScriptBlock {

    $args[0]  | Export-Clixml -Path "$Env:AppData\restore.$pid.clixml"

} -ArgumentList $state

```

If you close a terminal that you didn't mean to close, you can call `Restore-Terminal` in a new PowerShell window to load up the terminal state. Kinda like `Ctrl+Shift+T` in a browser.