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

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

## role
Implements persistent terminal sessions that survive WebSocket 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 layer, session lifecycle tracking (idle timeouts, explicit resets), and bidirectional frontend-backend coordination for seamless terminal reconnection.
## tags
websocket, terminal, design, persistent, sessions, terminalmanager, docker exec, .openspec
## symbols
-
## workflows
-
## dirty
-