diff --git a/.gitignore b/.gitignore
index e458ed5..36e402c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,10 @@
 .worktrees/
+__pycache__/
+*.pyc
+*.pyo
+.venv/
+venv/
+*.egg-info/
+dist/
+.env
+data/
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..291bea9
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,21 @@
+# CLAUDE.md — tüit Transkriptor
+
+Desktop transcription tool. Python, no Docker.
+
+## Key Commands
+
+    # Install dependencies
+    pip install -r requirements.txt
+
+    # Run
+    python main.py
+
+    # Run tests
+    pytest -v
+
+    # Trigger recording toggle via signal
+    pkill -USR1 -f main.py
+
+## Architecture
+
+See docs/plans/2026-04-01-desktop-transcription-design.md
diff --git a/pytest.ini b/pytest.ini
new file mode 100644
index 0000000..2f4c80e
--- /dev/null
+++ b/pytest.ini
@@ -0,0 +1,2 @@
+[pytest]
+asyncio_mode = auto
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 0000000..6568721
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1,11 @@
+fastapi>=0.111
+uvicorn[standard]>=0.29
+pystray>=0.19
+Pillow>=10.0
+sounddevice>=0.4.6
+faster-whisper>=1.0.3
+httpx>=0.27
+numpy>=1.26
+tomli_w>=1.0
+pytest>=8.0
+pytest-asyncio>=0.23