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

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