TerminalStateGuard 1.2.1
dotnet tool install --global TerminalStateGuard --version 1.2.1
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
dotnet tool install --local TerminalStateGuard --version 1.2.1
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=TerminalStateGuard&version=1.2.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
nuke :add-package TerminalStateGuard --version 1.2.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
<div align="center">
⚡ TSG — Terminal State Guard
Cross-platform CLI for Copilot Performance Boosting, Safe Monitoring & Session Recovery
One command to install. Keyboard shortcuts ready. Zero config.
Installation · Commands · Monitor · Recovery · Doctor
</div>
🚀 Installation
dotnet tool install -g TerminalStateGuard
tsg install
Done. Reopen your terminal — shortcuts and integration are active.
What tsg install does:
| Platform | Action |
|---|---|
| Windows | Installs Windows Terminal Fragment for native shortcut integration |
| Windows | Configures PSReadLine keyboard shortcuts in PowerShell profile |
| Linux | Adds shell aliases and keybindings to .bashrc/.zshrc |
| Both | Deploys monitoring scripts to ~/.tsg/ |
⌨️ Commands
tsg install # Setup scripts, shortcuts & terminal integration
tsg boost # ⚡ Elevate Copilot process priority (Admin/sudo)
tsg monitor # 📊 Safe live monitor with diagnostics
tsg status # 📋 Quick health check
tsg recover # 🔄 Recover terminal tabs + Copilot sessions
tsg restore # 🔄 Revert all priority changes
tsg doctor # 🩺 Diagnose environment issues
tsg uninstall # 🗑️ Remove configuration
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
Ctrl+Alt+B |
Boost |
Ctrl+Alt+M |
Monitor |
Ctrl+Alt+S |
Status |
Ctrl+Alt+F |
Recover |
Ctrl+Alt+R |
Restore |
📊 Safe Monitor
100% read-only — never modifies Copilot's internal files.
⚡ TSG MONITOR 06:30:00 [🟢 BOOSTED] [4/4]
══════════════════════════════════════════════════════
PID 221120 | copilot | 180 MB | H: 234 | Δ 0.3s | 🟢 IDLE
📂 MyProject — Implement auth system
📄 Events: 2.1MB | Last: assistant.turn_end | ok
PID 52300 | copilot-ls | 16 MB | H: 120 | Δ 0.0s | 🟢 IDLE
🟣 Visual Studio
══════════════════════════════════════════════════════
TOTAL: 196 MB | CPU: 125.3s | Threads: 31
Diagnostic Indicators
| State | Meaning | Action |
|---|---|---|
| 🟢 IDLE | Healthy, idle | None |
| 🟡 ACTIVE | Processing | Wait |
| 🔴 HIGH CPU | Heavy computation | Wait or close → resume |
| 🔴 HANDLE LEAK | events.jsonl too large | Close tab → copilot --resume |
| ❄️ STUCK | Turn never completed | Close tab → resume (auto-recovers) |
🔄 Session Recovery
tsg recover
Scans Windows Terminal state + Copilot sessions and reopens tabs with copilot --resume:
🔄 Session Recovery
✅ 8 tabs (5 copilot)
[1] 🤖 MyProject (Win 1)
💬 Implement auth system
[2] 📂 Documents (Win 1)
[3] 🤖 WebApp (Win 2)
💬 Fix DllNotFoundException
🩺 Doctor
tsg doctor
Checks environment, finds stuck sessions, validates setup:
🩺 TSG Doctor — Environment Check
✅ .NET 10.0.0
✅ Shell: C:\Program Files\PowerShell\7\pwsh.exe
✅ TSG dir: C:\Users\you\.tsg
✅ Copilot sessions: 12
⚠️ 1 session(s) > 20MB — may cause slowness
✅ Windows Terminal Fragment installed
✅ Terminal state: 2 windows, 8 tabs
🎉 All checks passed!
🛡️ Safety
TSG never modifies Copilot's internal files.
- ✅ All monitoring is read-only — only reads metadata
- ✅ Never deletes, trims, or edits
events.jsonl - ✅ Session recovery uses native
copilot --resume - ✅ Diagnostics show root cause + safe manual recommendations
⚡ Architecture
tsg (dotnet tool)
├── Platform/
│ ├── IPlatformHost.cs — Cross-platform abstraction
│ ├── WindowsHost.cs — Windows Terminal Fragment + PSReadLine
│ └── LinuxHost.cs — bash/zsh aliases + keybindings
├── Scripts/
│ ├── windows/*.ps1 — PowerShell monitoring scripts
│ └── linux/*.sh — Bash monitoring scripts
├── CommandRegistry.cs — Lambda-based command routing
├── Installer.cs — Script deployment + profile config
├── ScriptRunner.cs — Cross-platform script execution
└── Diagnostics.cs — Environment health checks
Built with: .NET 10 · C# 14 · Windows Terminal Fragments API
📦 Requirements
| Platform | Requirements |
|---|---|
| Windows | Windows Terminal, PowerShell 7+, .NET 10 Runtime |
| Linux | bash/zsh, .NET 10 Runtime |
| Both | GitHub Copilot CLI (npm i -g @github/copilot) |
🗑️ Uninstall
tsg uninstall
dotnet tool uninstall -g TerminalStateGuard
📄 License
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
This package has no dependencies.