# openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions

index: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md

## role
Design specification package for persistent WebSocket terminal sessions that survive reconnections by reattaching to existing docker exec processes rather than spawning new ones.
## files
- .openspec.yaml | Defines an OpenSpec schema configuration file with metadata
- design.md | Design document for implementing persistent terminal sessions that survive WebSocket disconnections while maintaining shell state and allowing reconnection to the same docker exec process. | dep: WebSocket, docker exec, TerminalManager, TerminalSession, PTY, background task scheduler
- proposal.md | Design proposal for implementing persistent WebSocket terminal sessions that survive reconnections by reattaching to existing docker exec processes instead of spawning new ones. | dep: docker exec, WebSocket, TerminalManager, terminal_session.py, terminal.py, terminal.tsx, use-terminal.ts
- tasks.md | A task tracking document outlining the refactoring of a terminal session system to support persistent, reconnectable WebSocket connections with circular output buffers, idle timeouts, and reset functionality across backend and frontend components. | dep: WebSocket, Docker, API backend, React/frontend terminal component
## arch
Specification-driven design using OpenSpec schema configuration with layered documentation (proposal → design → tasks) following a structured change-archive pattern for tracking system evolution across backend (Go circular buffers, idle timeouts, process reattachment) and frontend (WebSocket reconnection, reset functionality) components.
## tags
terminal, websocket, design, persistent, docker, proposal, .openspec, document
## symbols
-
## workflows
-
## dirty
-