Feature Request: Add terminal session recording to Start-Transcript (capture TUI applications, export to video)
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 22/100
Línea de trabajo
Read the submitted RFC, PowerShell-RFC#421, and discussion #28296 to understand the proposed host-level capture approach and WG-Interactive review request. The issue describes ConPTY/PTY capture, asciicast v3 output, and optional video export, but gives no implementation files or tests to start from. Done would require an RFC decision and a scoped experimental implementation.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Summary
Start-Transcript should gain the ability to record the terminal session itself — including full-screen interactive TUI applications — and save it in a replayable, time-stamped format (asciicast v3) optionally rendered as a video file (GIF/WebM/MP4). This is the PowerShell-level equivalent of RHEL's system-wide session recording via tlog/SSSD/PAM, or of asciinema/script(1) — notably, the asciinema CLI itself does not support Windows.
Background
Start-Transcript is documented to capture "all command that the user types and all output that appears on the console", but in practice it only captures what flows through the PowerShell host. TUI applications bypass the pipeline entirely:
- On Windows,
sconfig(Windows Server) opens the console directly (CONIN$/CONOUT$), switches to raw mode, and paints the screen with VT sequences - On Linux,
nmtui(RHEL),vim,htop, etc. open/dev/ttyand use the alternate screen buffer
So a transcript of a session that uses a TUI application is effectively blank for the duration of that application. This was discussed in detail in discussion #28296, where @rhubarb-geek-nz confirmed the current behavior is best-effort and noted his console-logger tool proves the technical approach on Windows: a pseudo-console (ConPTY) wrapper can both display and capture interactive programs.
Proposed behavior
Start-Transcript -Path .\audit\session01 -RecordTerminal -RecordingFormat WebM
sconfig # full-screen TUI — fully recorded
# ... interact ...
Stop-Transcript
Produces:
session01.txt— the existing text transcript (unchanged)session01.cast— time-stamped terminal stream (asciicast v3); always written as source of truth; plays withasciinema playsession01.webm— rendered video (GIF built-in; WebM/MP4 viaffmpegwhen available)
New parameters (strictly additive, existing behavior untouched): -RecordTerminal, -RecordingFormat (Asciicast|Gif|WebM|Mp4), -RecordInput (keystroke capture, off by default due to secret-capture risk), -RecordIdleTimeLimit.
Technical approach: host-level capture — the console host attaches native child processes to a ConPTY (Windows) / PTY (Unix) pair, proxies the VT stream to the real terminal, and tees it with timestamps into the recorder. Only the host can do this transparently; a PSGallery module cannot intercept CONIN$/CONOUT$//dev/tty traffic of arbitrary children.
Scenarios
- Audit/compliance: defensible records of privileged interactive administration (sconfig, nmtui, vendor consoles), aligned with the tlog/SSSD precedent and extendable via Group Policy per RFC0041
- Support/incident response: reproduce exactly what was on screen when a failure occurred inside a TUI app
- Training/docs/bug reports: shareable GIF/WebM of a full session including TUI interactions
Status
- An RFC draft has been submitted per the PowerShell RFC process: PowerShell/PowerShell-RFC#421
- Discussion: #28296
Per the RFC process, this issue requests the appropriate Working Group (WG-Interactive) to review whether the RFC can proceed toward an experimental implementation.
/cc @rhubarb-geek-nz
- Lenguaje dominante
- C#
- Estrellas
- 56.1k
- Forks
- 8.5k
- Merge medio
- 12 h 33 min
- PR fusionados (30 d)
- 73
Preparar el entorno
Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.
- Sin Dockerfile ni archivo de Docker Compose
- Tiene una plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de PowerShell/PowerShell
-
Needs-Triage
Dificultad 2/5 1-3 horas Aptitud para principiantes 84/100
PowerShell/PowerShell#28432 · 1 comentario · 1 reacción ·
Los mantenedores suelen responder en 1 día
-
Needs-Investigation WG-Engine WG-NeedsReview
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
PowerShell/PowerShell#28283 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
Contributing tab on rendered Readme.md has broken links to two images, under .github/Images, but previews ok in .github/Contributing.mdPosiblemente ocupada @Soumilgit la tomó hace 22 días. AbiertoIssue-Enhancement Needs-Triage
Dificultad 1/5 1-3 horas Aptitud para principiantes 68/100
PowerShell/PowerShell#28256 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
Issue-Enhancement Needs-Triage
Dificultad 2/5 1-3 horas Aptitud para principiantes 74/100
PowerShell/PowerShell#28138 · 1 reacción ·
Los mantenedores suelen responder en 1 día
-
Add support for WebRequestMethod QUERYPosiblemente ocupada @soroshsabz la tomó hace 52 días. AbiertoIssue-Enhancement Up-for-Grabs WG-Cmdlets WG-Reviewed
Dificultad 1/5 Menos de una hora Aptitud para principiantes 86/100
PowerShell/PowerShell#28061 · 4 comentarios · 3 reacciones ·
Los mantenedores suelen responder en 1 día
Todos los issues de PowerShell/PowerShell
Issues similares
-
area-templates triage:bot-seen triage:needs-human
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
microsoft/aspire#22356 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
documentation
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
microsoft/aspire.dev#2184 ·
Los mantenedores suelen responder en 2 días
-
area-controls-refreshview platform/ios s/triaged
Dificultad 2/5 1-3 horas Aptitud para principiantes 74/100
dotnet/maui#40314 · 1 reacción ·
Los mantenedores suelen responder en 1 día
-
Needs: Triage (Functions) v5 v5-preview5
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100
Azure/azure-functions-core-tools#5918 ·
Los mantenedores suelen responder en 1 día
-
kind:ux needs-triage
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
elsa-workflows/elsa-foundation#4712 · 1 comentario ·
Los mantenedores suelen responder en 1 día