windows-shell

name	windows-shell
description	Manage long-running background jobs and interactive workflows on Windows using PowerShell Jobs (Start-Job, Receive-Job) — the Windows equivalent of tmux sessions.
metadata	{"shibaclaw":{"emoji":"🪟","os":["windows"]}}

Windows Shell Skill

Use PowerShell Jobs when you need to run tasks in the background, keep processes alive across multiple steps, or run several commands in parallel on Windows.
This skill is the Windows counterpart of the tmux skill (available on Linux/macOS).

---

Quick-start: start a background job

# Start a background job and keep a reference
$job = Start-Job -Name "myTask" -ScriptBlock {
    # Replace with the real command
    python -u my_script.py
}
Write-Host "Job started: $($job.Id) ($($job.Name))"

---

Check job status

# List all jobs
Get-Job

# Check a specific job
Get-Job -Name "myTask" | Select-Object Id, Name, State, HasMoreData

States: Running, Completed, Failed, Stopped.

---

Read output (non-destructive peek)

# Read output without consuming it (Keep = $true)
Receive-Job -Name "myTask" -Keep

Remove -Keep only when you want to consume and discard the buffered output.

---

Wait for completion

# Block until the job finishes (with timeout)
$job = Get-Job -Name "myTask"
$job | Wait-Job -Timeout 120   # seconds

if ($job.State -eq "Completed") {
    Receive-Job $job
} else {
    Write-Warning "Job did not finish in time. State: $($job.State)"
}