provide-terminal
2026-03-29
uterm inspect, uterm watch TUI, ANSI render module, uv workspace, tunnel CF parity
79 files · 10,889+ · 121-
uterm inspect: HTTP reverse proxy with traffic inspection CLI and UI
6 files changed
inspect.pyuterm inspect CLI — HTTP reverse proxy with live request/response inspection in a browser UIinspect.pyHTTP message types, CHANNEL_HTTP constant, proxy helpersinspect.tsCF relay for HTTP inspection bridgeInspectView.tsxBrowser inspect view UI with live WebSocket, request detail panelhttp-tunnel-inspection-design.mdHTTP tunnel inspection design spechttp-inspection-implementation.mdHTTP inspection implementation plan
- uterm inspect runs a local HTTP reverse proxy that captures all request/response traffic and streams it to a browser inspection page via WebSocket. CF relays the inspection bridge. /app/inspect/{id} page route added on both FastAPI and CF. Hypothesis fuzzing and 100% coverage added to inspection code.
instantiate
behavioral
2 files
inspect.pyinspect.py
uterm watch: Textual TUI for HTTP traffic viewing
3 files changed
watch.pyuterm watch — Textual TUI showing live HTTP traffic from inspecttui-watch-design.mdTUI watch design spectui-watch-implementation.mdTUI watch implementation plan
- uterm watch opens a Textual TUI that displays live HTTP traffic captured by uterm inspect. Replaces aiohttp with httpx+uvicorn for the inspect server transport. Textual TUI tests added (11 tests); RowKey comparison bug fixed.
instantiate
behavioral
1 file
watch.py
ANSI render module: AnsiBuffer, 256-color and truecolor
1 file changed
ansi_render.pyAnsiBuffer and SGR rendering utilities; 256-color and truecolor support
- ansi_render module adds AnsiBuffer for rendering ANSI escape sequences with 256-color and truecolor (24-bit) SGR support. Resize arg order corrected. E2E Playwright tests verify color rendering for 256-color, truecolor, 16-color palette, and foreground text paths.
instantiate
behavioral
1 file
ansi_render.py
Shell render command: ANSI image display with GIF animation
2 files changed
_render.pyANSI image-to-frames converter with GIF palette quantizationshell.pyAnimatedResult handled in CLI loop and UshellConnector
- Shell render command converts URL/file images to ANSI art for terminal display. GIF support added with palette quantization. AnimatedResult type handled in both the CLI loop and UshellConnector. Pillow added as optional [images] extra. 100% branch+line coverage added.
instantiate
behavioral
1 file
_render.py
uv workspace configuration for monorepo
1 file changed
pyproject.tomluv workspace configured with all packages/ entries
CF tunnel parity: cookie auth, /s/ share URLs, token revocation
3 files changed
tunnel.tsCF: tunnel token revocation and rotation routes addedshare.tsCF: /s/{id} short share URL redirectshare.pyFastAPI: /s/{id} short share URL (parity with CF)
- CF tunnel achieves full parity with FastAPI: CF Access cookie auth, /s/{id} short share URL redirect, and token revocation/rotation routes all added to CF Worker. pywrangler E2E tests verify tunnel system end-to-end (9 tests). CF share route test fixed for 302 redirect.
instantiate
behavioral
1 file
tunnel.ts