diff --git a/packages/blackbox/README.md b/packages/blackbox/README.md
index 47bec9f..54b4959 100644
--- a/packages/blackbox/README.md
+++ b/packages/blackbox/README.md
@@ -53,9 +53,19 @@ src/blackbox/
 
 ## Development
 
+From the repo root:
+
 ```bash
 uv sync
-uv run fastapi dev src/blackbox/dashboard/app.py  # hot reload on :8000
+uv run --package blackbox uvicorn blackbox.dashboard.app:app --reload  # hot reload on :8000
+uv run pytest packages/blackbox/tests/ -v
+uv run ruff check packages/blackbox/
+```
+
+From `packages/blackbox/`:
+
+```bash
+uv run --package blackbox fastapi dev src/blackbox/dashboard/app.py  # hot reload on :8000
 uv run pytest tests/ -v
 uv run ruff check src/ tests/
 ```