TODO

High priority

Handle client network failures in cli/src/whisper_remote_cli/main.py. Right now connection errors and timeouts from httpx will dump a Python traceback instead of a clean CLI error.
Add a backend subprocess timeout in backend/src/whisper_remote_backend/server.py. A stuck whisper process can hold the request open forever and tie up the API worker.
Add an end-to-end smoke test path against a real whisper binary. Current tests only mock subprocess behavior, so we still have not verified the actual CLI wrapper contract on a live backend.

Return structured JSON errors from the backend and make the CLI surface them nicely. Right now the CLI just prints the raw response body, which will be awkward for FastAPI's default JSON error payloads.
Add test coverage for cleanup and artifact-writing behavior. Missing cases include ensuring temp files are removed on failure and verifying --to-file writes the expected local artifact content.
Document Windows-first setup in the root README. The examples currently use export, but this repo is being built on Windows and should show PowerShell equivalents for WHISPER_REMOTE.

Support configurable host and port for whisper-remote-server. The backend entrypoint currently hardcodes 0.0.0.0:8000.
Add optional request authentication. v1 intentionally has no auth, but even a shared bearer token mode would make remote exposure less risky.