@@ -16,9 +16,9 @@ uv run pytest -m "not benchmark"           # what CI runs by default
 uv run pytest -m integration               # integration tests only
 uv run pytest -m "integration and benchmark"
 uv run pytest --benchmark-compare          # compare vs main baseline (run main first)
-uv run ruff check --fix                    # lint (auto-fix)
-uv run ruff format                          # format
-uv run manage.py threadmill                # run the worker pool (the app's CLI)
+uvx prek run --all-files
+uv run manage.py threadmill worker         # run the worker pool
+uv run manage.py threadmill inspector    # launch the textual TUI inspector
 ```
 
 CI additionally pins Django per matrix step: `uv run --with django~=6.1a1 pytest -m "not benchmark"`.
@@ -37,11 +37,7 @@ Run a single test by node ID, e.g. `uv run pytest tests/test_command.py::TestCom
   ```bash
   curl -sSL https://raw.githubusercontent.com/codingjoe/naming-things/refs/heads/main/README.md
   ```
-- Ruff config: `select` includes E,W,F,I,S,D,UP,B,C; `ignore` includes `B904`, `D1`, `E501`, `S101` (so `assert` in tests is fine, and missing docstrings on private members are allowed).
-- Docstrings use `pep257` convention: present-tense imperative, start with capital, end with period, describe external behavior only. Class docstrings must not repeat the class name or start with a verb.
-- Prefer generators over building lists/arrays, `match`/`switch` over `if` chains, EAFP over LBYL, dataclasses for plain data, context managers for resources, walrus `:=` when it aids readability.
-- Avoid code comments except for third-party behavior or complex algorithms. Avoid nested functions and loops-in-loops where a generator/recursion works.
-- Do not add dependencies unless widely adopted and well-maintained; prefer BSD/MIT-style permissive licenses.
+- NEVER format code, tests, or docs manually. MUST USE `prek run --all-files`.
 
 ## Coverage
 
@@ -54,7 +50,7 @@ Codecov requires 100% patch coverage on PRs (`pyproject.toml`, `.codecov.yml`).
 
 ## Architecture notes
 
-- Entry point for end users: `threadmill/management/commands/threadmill.py` (Django management command, Gunicorn-style CLI).
+- Entry point for end users: `threadmill/management/commands/threadmill.py` (Django management command with `worker` and `inspector` subcommands).
 - Core runtime: `threadmill/executor.py` (`TaskExecutor`) — process/thread pool, graceful shutdown, worker recycling, task timeout/backlog.
 - Integration point for queue authors: `threadmill/backends.py` (`AcknowledgeableTaskBackend`) — subclasses implement `acquire` (lock-without-remove) and `acknowledge` (remove + publish). Requires late-ack support from the underlying queue.
 - Test app backend `tests/testapp/backends.py` (`GeneratingTaskBackend`) generates tasks in-process for benchmarks; reset between runs via `default_task_backend.reset()`.
 
@@ -2,9 +2,9 @@
 
 <p align="center">
   <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="https://github.com/codingjoe/threadmill/raw/main/images/logo-dark.svg">
-    <source media="(prefers-color-scheme: light)" srcset="https://github.com/codingjoe/threadmill/raw/main/images/logo-light.svg">
-    <img alt="Threadmill: A queue agnostic worker for Django's task framework." src="https://github.com/codingjoe/threadmill/raw/main/images/logo-light.svg">
+    <source media="(prefers-color-scheme: dark)" srcset="https://github.com/codingjoe/threadmill/raw/main/docs/images/logo-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="https://github.com/codingjoe/threadmill/raw/main/docs/images/logo-light.svg">
+    <img alt="Threadmill: A queue agnostic worker for Django's task framework." src="https://github.com/codingjoe/threadmill/raw/main/docs/images/logo-light.svg">
   </picture>
 <br>
   <a href="https://github.com/codingjoe/threadmill/">Documentation</a> |
@@ -61,10 +61,16 @@ TASKS = {
 }
 ```
 
-Finally, you launch the worker pool:
+Optionally, install the inspector dependency if you want the TUI:
 
 ```console
-uv run manage.py threadmill
+uv add threadmill[inspector]
+```
+
+Then launch the worker pool:
+
+```console
+uv run manage.py threadmill worker
 ```
 
 ## Usage
@@ -79,15 +85,15 @@ Depending on your workload, you can tweak the number of processes and threads.
 Processes allow for parallel compute (no GIL) while threads are great for low-memory concurrent IO.
 
 ```console
-uv run manage.py threadmill --processes 4 --threads 2
+uv run manage.py threadmill worker --processes 4 --threads 2
 ```
 
 #### Health
 
 If your tasks leak memory, you can recycle (restart) the workers after a certain number of tasks have been processed:
 
 ```console
-uv run manage.py threadmill --max-tasks 1000 --max-tasks-jitter 100
+uv run manage.py threadmill worker --max-tasks 1000 --max-tasks-jitter 100
 ```
 
 This will restart the workers after 1000 tasks have been processed, with a random jitter of up to 100 tasks to avoid all workers restarting at the same time.
@@ -102,6 +108,18 @@ All workers will finish the tasks they acquired and acknowledge them.
 You can use `--exit-empty` to exit immediately after all tasks have been processed,
 which might be useful for draining a one-off queue.
 
+### Inspector
+
+![Inspector TUI screenshot](https://github.com/codingjoe/threadmill/raw/main/docs/images/TUI-screenshot.svg)
+
+The optional TUI inspector lets you watch queues, tasks, and task details in real-time.
+Install it with the `inspector` extra and launch it from a separate terminal:
+
+```console
+uv add threadmill[inspector]
+uv run manage.py threadmill inspector
+```
+
 ### Redis Backend Options
 
 The `RedisTaskBackend` accepts the following options under `OPTIONS` in your
 
@@ -37,6 +37,9 @@ dependencies = ["django>=6.1a1"]
 
 [project.optional-dependencies]
 redis = ["redis>=5.0"]
+inspector = [
+    "textual>=8.2.7",
+]
 
 [project.urls]
 # https://packaging.python.org/en/latest/specifications/well-known-project-urls/#well-known-labels
 
@@ -49,6 +49,11 @@ def test_peek__raise_not_implemented_error(self) -> None:
         with pytest.raises(NotImplementedError):
             list(BackendDouble(alias="default", params={}).peek("default"))
 
+    def test_queue_telemetry__raise_not_implemented_error(self) -> None:
+        """Raise NotImplementedError for backend telemetry API."""
+        with pytest.raises(NotImplementedError):
+            BackendDouble(alias="default", params={}).queue_telemetry()
+
 
 class TestAcknowledgementTimeout:
     """Tests for the AcknowledgementTimeout exception."""