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.py uterm inspect CLI — HTTP reverse proxy with live request/response inspection in a browser UI
  • inspect.py HTTP message types, CHANNEL_HTTP constant, proxy helpers
  • inspect.ts CF relay for HTTP inspection bridge
  • InspectView.tsx Browser inspect view UI with live WebSocket, request detail panel
  • http-tunnel-inspection-design.md HTTP tunnel inspection design spec
  • http-inspection-implementation.md HTTP 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.py
    • inspect.py

uterm watch: Textual TUI for HTTP traffic viewing

3 files changed
  • watch.py uterm watch — Textual TUI showing live HTTP traffic from inspect
  • tui-watch-design.md TUI watch design spec
  • tui-watch-implementation.md TUI 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.py AnsiBuffer 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.py ANSI image-to-frames converter with GIF palette quantization
  • shell.py AnimatedResult 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.toml uv workspace configured with all packages/ entries
  • uv workspace configured at the repo root to manage all packages/ subdirectories as a single monorepo workspace. Enables unified uv sync and consistent lockfile across packages. baseline internal
    1 file
    • pyproject.toml

CF tunnel parity: cookie auth, /s/ share URLs, token revocation

3 files changed
  • tunnel.ts CF: tunnel token revocation and rotation routes added
  • share.ts CF: /s/{id} short share URL redirect
  • share.py FastAPI: /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