# openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux

index: openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.index.md

## role
Archive of completed specification documents for a multi-session terminal UX feature that enables up to 5 concurrent terminal sessions per tool instance with tabbed UI, WebSocket routing, and hybrid storage.
## files
- .openspec.yaml | Defines metadata for a completed project specification named "multi-session-terminal-ux"
- apply-pr1.md | Documents the implementation of database schema, Alembic migration, and multi-session terminal management core for a multi-session terminal UX feature in a backend API. | dep: Alembic, SQLAlchemy, aiosqlite, asyncio, pytest, WebSocket, TerminalSessionModel, UUIDPrimaryKeyMixin, TimestampMixin, SessionLocal
- apply-pr2.md | Documents the implementation of multi-session terminal WebSocket and REST API backend with frontend client/hook, including test results and deviations from original design. | dep: WebSocket, REST API, Python pytest, React/TypeScript (frontend hooks), Docker (implied for full integration), terminal PTY manager
- apply-pr3.md | Documents a frontend pull request implementing multi-session terminal UI with tabbed management, fullscreen mode, keyboard shortcuts, and mobile integration. | dep: React, TypeScript, WebSocket, CSS, Python (backend service)
- design.md | Software design document specifying a multi-session terminal UX architecture with up to 5 concurrent sessions per tool instance, using hybrid in-memory/DB storage and WebSocket-per-session routing. | dep: React, FastAPI, WebSocket, xterm.js, SQLAlchemy, Alembic, Docker PTY, Python asyncio
- explore.md | A software design document exploring the architecture, options, and feasibility for adding multi-session terminal support to an existing persistent terminal system. | dep: TerminalManager, TerminalSession, TerminalComponent, TerminalPage, MobileTerminalWrapper, xterm.js, FastAPI, WebSocket, docker exec, SQLAlchemy, alembic
- proposal.md | Proposes architectural changes to support multiple concurrent terminal sessions per tool instance with improved UI/UX features | dep: TerminalSession, TerminalManager, TerminalComponent, terminal.tsx, WebSocket, database
- tasks.md | Defines a detailed software development plan for implementing multi-session terminal UX across backend and frontend, broken into 12 tasks across 3 stacked PRs with TDD acceptance criteria. | dep: Alembic, SQLAlchemy, FastAPI, WebSocket, React, xterm.js, PTY, UUID, pytest, React Testing Library
## arch
Specification-driven development using stacked PR planning (3 PRs: backend schema/API, WebSocket/REST integration, frontend UI), hybrid in-memory/database session storage, WebSocket-per-session routing, and TDD acceptance criteria with documented design deviations.
## tags
terminal, session, websocket, multi, apply, alembic, design, sqlalchemy
## symbols
-
## workflows
-
## dirty
-
