# openspec/changes/persistent-terminal-sessions
dir: openspec/changes/persistent-terminal-sessions

index: openspec/changes/persistent-terminal-sessions/.pi-map.index.md

## role
Defines requirements and architecture for persistent WebSocket terminal sessions that maintain shell state across reconnections without spawning new docker exec processes.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema version and creation date 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: TerminalManager, TerminalSession, WebSocket, docker exec, PTY
- proposal.md | Proposes architectural changes to make WebSocket terminal sessions persistent across reconnections instead of spawning new docker exec processes each time | dep: docker exec, WebSocket, TerminalManager, terminal_session.py, terminal.tsx, use-terminal.ts
- tasks.md | This file is a project task list tracking the implementation of persistent terminal sessions with WebSocket reconnection, reset functionality, and idle timeout management across backend and frontend components. | dep: TerminalSession, TerminalManager, WebSocket, docker exec, API endpoints, frontend terminal component, terminal hook
## arch
Specification-driven design using OpenSpec schema with phased implementation (backend session state management, frontend reconnection logic, idle timeout handling) documented across design/proposal/task files.
## tags
websocket, terminal, design, persistent, sessions, terminalmanager, docker exec, .openspec
## symbols
-
## workflows
-
## dirty
-