# openspec/changes/archive/2026-05-22-instance-proxy
dir: openspec/changes/archive/2026-05-22-instance-proxy

index: openspec/changes/archive/2026-05-22-instance-proxy/.pi-map.index.md

## role
Defines an OpenSpec change proposal for implementing an authenticated HTTP/WebSocket proxy to expose internal Docker tool instances through a unified API endpoint.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | Design document for implementing an HTTP/WebSocket proxy in FastAPI to allow users to access internal Docker tool instances through a single authenticated API endpoint. | dep: FastAPI, httpx, starlette.websockets, Docker, Docker network, ToolInstance model
- proposal.md | Proposes adding an HTTP/WebSocket proxy endpoint to expose Docker-hosted tool instances to users over HTTPS instead of broken localhost links | dep: Docker, backend API, frontend, WebSocket, HTTPS
- tasks.md | A completed task list tracking the implementation of a proxy endpoint system for tool instances, including backend proxy functionality, frontend URL updates, and testing/quality verification.
## arch
Documentation-driven specification pattern using OpenSpec change tracking with phased task breakdown (backend proxy → frontend integration → testing) for FastAPI-based WebSocket/HTTP proxy architecture.
## tags
proxy, docker, design, websocket, tool, instances, endpoint, .openspec
## symbols
-
## workflows
-
## dirty
-
