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

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

## role
Implements persistent WebSocket terminal sessions that survive disconnections and reconnect to existing docker exec processes rather than spawning new ones.
## 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
Event-driven architecture with WebSocket connection management, process state persistence, session lifecycle handling (reconnection/reset/idle timeout), and cross-layer backend-frontend coordination.
## tags
websocket, terminal, design, persistent, sessions, terminalmanager, docker exec, .openspec
## symbols
-
## workflows
-
## dirty
-
